@viardex/viardex-libs 1.0.0

package/dist/common/utils/string.utils.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maskPhoneNumber = exports.formatPhoneNumber = void 0;
+/**
+ * Formats phone number for display
+ * 2348012345678 → +234 801 234 5678
+ */
+const formatPhoneNumber = (phone) => {
+    const cleaned = phone.replace(/[\s\-\(\)]/g, '');
+    // Ensure it starts with 234
+    let formatted = cleaned;
+    if (formatted.startsWith('0')) {
+        formatted = '234' + formatted.substring(1);
+    }
+    // Format as +234 801 234 5678
+    if (formatted.startsWith('234')) {
+        return `+234 ${formatted.substring(3, 6)} ${formatted.substring(6, 9)} ${formatted.substring(9)}`;
+    }
+    return phone;
+};
+exports.formatPhoneNumber = formatPhoneNumber;
+/**
+ * Masks phone number for security
+ * +2348012345678 → +234****5678
+ */
+const maskPhoneNumber = (phone) => {
+    const cleaned = phone.replace(/[\s\-\(\)]/g, '');
+    if (cleaned.length < 8)
+        return phone;
+    const prefix = cleaned.substring(0, 4);
+    const suffix = cleaned.slice(-4);
+    return `${prefix}****${suffix}`;
+};
+exports.maskPhoneNumber = maskPhoneNumber;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './nats';
+export * from './common';
+export * from './cache';
+export * from './rpc';
+export * from './notification';

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./nats"), exports);
+__exportStar(require("./common"), exports);
+__exportStar(require("./cache"), exports);
+__exportStar(require("./rpc"), exports);
+__exportStar(require("./notification"), exports);

package/dist/nats/constants/nats.constants.d.ts

@@ -0,0 +1,11 @@
+export declare const NATS_OPTIONS = "NATS_OPTIONS";
+export declare const NATS_CLIENT = "NATS_CLIENT";
+export declare const DEFAULT_NATS_CONFIG: {
+    url: string;
+    timeout: number;
+    reconnect: boolean;
+    reconnectTimeWait: number;
+    maxReconnectAttempts: number;
+};
+export declare enum NatsSubjects {
+}

package/dist/nats/constants/nats.constants.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsSubjects = exports.DEFAULT_NATS_CONFIG = exports.NATS_CLIENT = exports.NATS_OPTIONS = void 0;
+exports.NATS_OPTIONS = 'NATS_OPTIONS';
+exports.NATS_CLIENT = 'NATS_CLIENT';
+exports.DEFAULT_NATS_CONFIG = {
+    url: 'nats://localhost:4222',
+    timeout: 5000,
+    reconnect: true,
+    reconnectTimeWait: 2000,
+    maxReconnectAttempts: 10,
+};
+var NatsSubjects;
+(function (NatsSubjects) {
+})(NatsSubjects || (exports.NatsSubjects = NatsSubjects = {}));

package/dist/nats/decorators/nats-event-pattern.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const NATS_EVENT_METADATA = "nats_event_metadata";
+export declare function NatsEventPattern(pattern: string): <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/dist/nats/decorators/nats-event-pattern.decorator.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NATS_EVENT_METADATA = void 0;
+exports.NatsEventPattern = NatsEventPattern;
+const common_1 = require("@nestjs/common");
+const microservices_1 = require("@nestjs/microservices");
+const nats_logging_interceptor_1 = require("../interceptors/nats-logging.interceptor");
+exports.NATS_EVENT_METADATA = 'nats_event_metadata';
+function NatsEventPattern(pattern) {
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(exports.NATS_EVENT_METADATA, { pattern }), (0, microservices_1.EventPattern)(pattern), (0, common_1.UseInterceptors)(nats_logging_interceptor_1.NatsLoggingInterceptor));
+}

package/dist/nats/dto/nats-message.dto.d.ts

@@ -0,0 +1,5 @@
+export declare class NatsMessageDto {
+    pattern: string;
+    data: any;
+    replyTo?: string;
+}

package/dist/nats/dto/nats-message.dto.js

@@ -0,0 +1,27 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsMessageDto = void 0;
+const class_validator_1 = require("class-validator");
+class NatsMessageDto {
+    pattern;
+    data;
+    replyTo;
+}
+exports.NatsMessageDto = NatsMessageDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)()
+], NatsMessageDto.prototype, "pattern", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)()
+], NatsMessageDto.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)()
+], NatsMessageDto.prototype, "replyTo", void 0);

package/dist/nats/index.d.ts

@@ -0,0 +1,5 @@
+export * from './constants/nats.constants';
+export * from './interfaces/nats-options.interface';
+export * from './dto/nats-message.dto';
+export * from './decorators/nats-event-pattern.decorator';
+export * from './interceptors/nats-logging.interceptor';

package/dist/nats/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants/nats.constants"), exports);
+__exportStar(require("./interfaces/nats-options.interface"), exports);
+__exportStar(require("./dto/nats-message.dto"), exports);
+__exportStar(require("./decorators/nats-event-pattern.decorator"), exports);
+__exportStar(require("./interceptors/nats-logging.interceptor"), exports);

package/dist/nats/interceptors/nats-logging.interceptor.d.ts

@@ -0,0 +1,6 @@
+import { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
+import { Observable } from 'rxjs';
+export declare class NatsLoggingInterceptor implements NestInterceptor {
+    private readonly logger;
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}

package/dist/nats/interceptors/nats-logging.interceptor.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var NatsLoggingInterceptor_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsLoggingInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+let NatsLoggingInterceptor = NatsLoggingInterceptor_1 = class NatsLoggingInterceptor {
+    logger = new common_1.Logger(NatsLoggingInterceptor_1.name);
+    intercept(context, next) {
+        const now = Date.now();
+        const rpcContext = context.switchToRpc();
+        const natsContext = rpcContext.getContext();
+        const pattern = natsContext.getSubject();
+        return next.handle().pipe((0, rxjs_1.tap)({
+            next: (data) => {
+                this.logger.log(`Pattern: ${pattern} | Response time: ${Date.now() - now}ms | Response: ${JSON.stringify(data)}`);
+            },
+            error: (error) => {
+                this.logger.error(`Pattern: ${pattern} | Error: ${error.message}`, error.stack);
+            },
+        }));
+    }
+};
+exports.NatsLoggingInterceptor = NatsLoggingInterceptor;
+exports.NatsLoggingInterceptor = NatsLoggingInterceptor = NatsLoggingInterceptor_1 = __decorate([
+    (0, common_1.Injectable)()
+], NatsLoggingInterceptor);

package/dist/nats/interfaces/nats-options.interface.d.ts

@@ -0,0 +1,23 @@
+import { ModuleMetadata, Type } from '@nestjs/common';
+import { Transport } from '@nestjs/microservices';
+export interface NatsOptions {
+    transport: Transport.NATS;
+    options: {
+        servers: string[];
+        queue?: string;
+        name?: string;
+        timeout?: number;
+        reconnect?: boolean;
+        reconnectTimeWait?: number;
+        maxReconnectAttempts?: number;
+    };
+}
+export interface NatsOptionsFactory {
+    createNatsOptions(): Promise<NatsOptions> | NatsOptions;
+}
+export interface NatsAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useExisting?: Type<NatsOptionsFactory>;
+    useClass?: Type<NatsOptionsFactory>;
+    useFactory?: (...args: any[]) => Promise<NatsOptions> | NatsOptions;
+    inject?: any[];
+}

package/dist/nats/interfaces/nats-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/notification/index.d.ts

@@ -0,0 +1,4 @@
+export * from './notification.client';
+export * from './notification.interface';
+export * from './notification.enum';
+export * from './notification.module';

package/dist/notification/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./notification.client"), exports);
+__exportStar(require("./notification.interface"), exports);
+__exportStar(require("./notification.enum"), exports);
+__exportStar(require("./notification.module"), exports);

package/dist/notification/notification.client.d.ts

@@ -0,0 +1,31 @@
+import { ClientProxy } from '@nestjs/microservices';
+import { OTPMail, ResetTransactionPinEmail, PasswordResetMail, EmailVerificationMail, DeviceVerificationMail, BulkEmail, BaseEmail } from './notification.interface';
+export declare class Notification {
+    private readonly natsClient;
+    constructor(natsClient: ClientProxy);
+    private validatePhoneNumber;
+    private validateEmailAddress;
+    sendBulkEmail(data: BulkEmail): Promise<void>;
+    sendForgetPinOTPMail(to: string, data: ResetTransactionPinEmail): Promise<void>;
+    sendPasswordResetMail(to: string, data: PasswordResetMail): Promise<void>;
+    sendEmailVerificationMail(to: string, data: EmailVerificationMail): Promise<void>;
+    sendDeviceVerificationEmail(to: string, data: Omit<DeviceVerificationMail, keyof BaseEmail>): Promise<void>;
+    /**
+     * Sends generated OTP via email
+     * @param to - recipient email address
+     * @param data - OTP data
+     */
+    sendOTPByMail(to: string, data: OTPMail): Promise<void>;
+    /**
+     * Sends generated OTP via SMS
+     * @param to - recipient phone number
+     * @param data - OTP data
+     */
+    sendOTPBySms(to: string, data: OTPMail): Promise<void>;
+    /**
+     * Sends generated OTP via voice call
+     * @param to - recipient phone number
+     * @param data - OTP data
+     */
+    sendOTPByVoice(to: string, data: OTPMail): Promise<void>;
+}

package/dist/notification/notification.client.js

@@ -0,0 +1,104 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Notification = void 0;
+const common_1 = require("@nestjs/common");
+const notification_enum_1 = require("./notification.enum");
+const nats_1 = require("../nats");
+const class_validator_1 = require("class-validator");
+let Notification = class Notification {
+    natsClient;
+    constructor(natsClient) {
+        this.natsClient = natsClient;
+    }
+    validatePhoneNumber(phone) {
+        if (!(0, class_validator_1.isPhoneNumber)(phone)) {
+            throw new common_1.BadRequestException('Invalid phone number');
+        }
+    }
+    validateEmailAddress(email) {
+        if (!(0, class_validator_1.isEmail)(email)) {
+            throw new common_1.BadRequestException('Invalid email address');
+        }
+    }
+    async sendBulkEmail(data) {
+        this.natsClient.emit(notification_enum_1.NotificationSubject.NOTIFICATION_EMAIL_BULK, data);
+    }
+    async sendForgetPinOTPMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubject.FORGET_PIN_OTP_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendPasswordResetMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubject.PASSWORD_RESET_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendEmailVerificationMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubject.EMAIL_VERIFICATION_EMAIL, {
+            to,
+            data,
+        });
+    }
+    async sendDeviceVerificationEmail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubject.DEVICE_VERIFICATION_MAIL, {
+            to,
+            data,
+        });
+    }
+    /**
+     * Sends generated OTP via email
+     * @param to - recipient email address
+     * @param data - OTP data
+     */
+    async sendOTPByMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubject.OTP_MAIL, {
+            to,
+            ...data,
+        });
+    }
+    /**
+     * Sends generated OTP via SMS
+     * @param to - recipient phone number
+     * @param data - OTP data
+     */
+    async sendOTPBySms(to, data) {
+        this.validatePhoneNumber(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubject.NOTIFICATION_OTP_TEXT, {
+            to,
+            ...data,
+        });
+    }
+    /**
+     * Sends generated OTP via voice call
+     * @param to - recipient phone number
+     * @param data - OTP data
+     */
+    async sendOTPByVoice(to, data) {
+        this.validatePhoneNumber(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubject.NOTIFICATION_OTP_VOICE, {
+            to,
+            ...data,
+        });
+    }
+};
+exports.Notification = Notification;
+exports.Notification = Notification = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(nats_1.NATS_CLIENT))
+], Notification);

package/dist/notification/notification.enum.d.ts

@@ -0,0 +1,10 @@
+export declare enum NotificationSubject {
+    NOTIFICATION_EMAIL_BULK = "notification.email.bulk",
+    OTP_MAIL = "notification.mail.otp",
+    EMAIL_VERIFICATION_EMAIL = "notification.mail.email.verification",
+    PASSWORD_RESET_MAIL = "notification.mail.passwordreset",
+    FORGET_PIN_OTP_MAIL = "notification.mail.forgetpin.otp",
+    DEVICE_VERIFICATION_MAIL = "notification.mail.device.verification",
+    NOTIFICATION_OTP_TEXT = "notification.text.otp",
+    NOTIFICATION_OTP_VOICE = "notification.voice.otp"
+}

package/dist/notification/notification.enum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationSubject = void 0;
+var NotificationSubject;
+(function (NotificationSubject) {
+    NotificationSubject["NOTIFICATION_EMAIL_BULK"] = "notification.email.bulk";
+    NotificationSubject["OTP_MAIL"] = "notification.mail.otp";
+    NotificationSubject["EMAIL_VERIFICATION_EMAIL"] = "notification.mail.email.verification";
+    NotificationSubject["PASSWORD_RESET_MAIL"] = "notification.mail.passwordreset";
+    NotificationSubject["FORGET_PIN_OTP_MAIL"] = "notification.mail.forgetpin.otp";
+    NotificationSubject["DEVICE_VERIFICATION_MAIL"] = "notification.mail.device.verification";
+    NotificationSubject["NOTIFICATION_OTP_TEXT"] = "notification.text.otp";
+    NotificationSubject["NOTIFICATION_OTP_VOICE"] = "notification.voice.otp";
+})(NotificationSubject || (exports.NotificationSubject = NotificationSubject = {}));

package/dist/notification/notification.interface.d.ts

@@ -0,0 +1,31 @@
+export interface BulkEmail {
+    to: string[];
+    subject: string;
+    template: string;
+    user_id?: string;
+    bypassPreferenceCheck?: boolean;
+    context: Record<string, any>;
+}
+export interface BaseEmail {
+    firstName: string;
+    currentYear: number;
+}
+export interface OTPMail extends BaseEmail {
+    otp: number;
+    expiration: string;
+}
+export interface ResetTransactionPinEmail extends OTPMail {
+}
+export interface PasswordResetMail extends OTPMail {
+}
+export interface EmailVerificationMail extends OTPMail {
+}
+export interface DeviceVerificationMail extends BaseEmail {
+    to: string;
+    subject: string;
+    otp: string;
+    deviceId: string;
+    deviceName?: string;
+    time?: string;
+    expiration?: string;
+}

package/dist/notification/notification.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/notification/notification.module.d.ts

@@ -0,0 +1,2 @@
+export declare class NotificationModule {
+}

package/dist/notification/notification.module.js

@@ -0,0 +1,20 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationModule = void 0;
+const common_1 = require("@nestjs/common");
+const notification_client_1 = require("./notification.client");
+let NotificationModule = class NotificationModule {
+};
+exports.NotificationModule = NotificationModule;
+exports.NotificationModule = NotificationModule = __decorate([
+    (0, common_1.Module)({
+        providers: [notification_client_1.Notification],
+        exports: [notification_client_1.Notification],
+    })
+], NotificationModule);

package/dist/rpc/index.d.ts

@@ -0,0 +1,54 @@
+import { NatsContext, RpcException } from '@nestjs/microservices';
+import { Observable } from 'rxjs';
+export interface ViardexRPCError {
+    success: boolean;
+    subject: string | null;
+    message: string;
+    statusCode: number;
+    errors: string[];
+}
+export interface ViardexRPCSuccess<T> {
+    data?: T;
+}
+export declare class ViardexRpc {
+    /**
+     * Wraps a promise returned by an RPC request handler.
+     * @param promise - A Promise resolving to the response value.
+     * @param ctx - Optional NatsContext object.
+     * @param successMessage - Optional success message
+     */
+    static handleRequest<V>(promise: Promise<V>, ctx?: NatsContext): Promise<ViardexRPCSuccess<V> | RpcException>;
+    /**
+     * Handles errors from an RPC request handler and returns a ViardexRPCError wrapped in RpcException.
+     * @param err - Error to be handled.
+     * @param ctx - A NATS Context.
+     */
+    static handleRequestError(err: unknown, ctx: NatsContext): RpcException;
+    private static catch;
+    /**
+     * Handles NATS request response.
+     * @param obs - An instance of an Observable.
+     * @param successMessage - Optional success message
+     */
+    static withReply<V>(obs: Observable<V>, successMessage?: string): Promise<ViardexRPCSuccess<V>>;
+}
+export declare class ViardexRpcV2 {
+    /**
+     * Wraps a promise returned by an RPC request handler.
+     * @param promise - A Promise resolving to the response value.
+     * @param ctx - Optional NatsContext object.
+     */
+    static handleRequest<V>(promise: Promise<V>, ctx?: NatsContext): Promise<ViardexRPCSuccess<V> | ViardexRPCError>;
+    /**
+     * Handles errors from an RPC request handler and returns a ViardexRPCError.
+     * @param err - Error to be handled.
+     * @param ctx - A NATS Context.
+     */
+    static handleRequestError(err: unknown, ctx: NatsContext): ViardexRPCError;
+    private static catch;
+    /**
+     * Handles NATS request response.
+     * @param obs - An instance of an Observable.
+     */
+    static withReply<V>(obs: Observable<V>): Promise<ViardexRPCSuccess<V>>;
+}