@nirholas/bnbchain-mcp 1.0.0

package/build/vendors/payments/utils/validation.d.ts

@@ -0,0 +1,164 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import { z } from 'zod';
+import type { CreatePaymentOnchainInput, CreatePaymentRedirectInput, GetPaymentStatusInput, ListCurrenciesCatalogInput, PaymentStatusCode } from '../types/index.js';
+export declare const createPaymentOnchainSchema: z.ZodObject<{
+    amount_eur: z.ZodNumber;
+    input_currency: z.ZodString;
+    fiat: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    input_currency: string;
+    amount_eur: number;
+    notes?: string | undefined;
+    fiat?: string | undefined;
+}, {
+    input_currency: string;
+    amount_eur: number;
+    notes?: string | undefined;
+    fiat?: string | undefined;
+}>;
+export declare const createPaymentRedirectSchema: z.ZodObject<{
+    amount_eur: z.ZodNumber;
+    url_ok: z.ZodOptional<z.ZodString>;
+    url_ko: z.ZodOptional<z.ZodString>;
+    fiat: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount_eur: number;
+    notes?: string | undefined;
+    fiat?: string | undefined;
+    url_ok?: string | undefined;
+    url_ko?: string | undefined;
+}, {
+    amount_eur: number;
+    notes?: string | undefined;
+    fiat?: string | undefined;
+    url_ok?: string | undefined;
+    url_ko?: string | undefined;
+}>;
+export declare const getPaymentStatusSchema: z.ZodObject<{
+    identifier: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+}, {
+    identifier: string;
+}>;
+export declare const listCurrenciesCatalogSchema: z.ZodObject<{
+    filter_by_amount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filter_by_amount?: number | undefined;
+}, {
+    filter_by_amount?: number | undefined;
+}>;
+export interface ValidationSuccess<T> {
+    success: true;
+    data: T;
+}
+export interface ValidationError {
+    success: false;
+    error: {
+        message: string;
+        field?: string;
+        code: string;
+    };
+}
+export type ValidationResult<T> = ValidationSuccess<T> | ValidationError;
+export declare function validateInput<T>(schema: z.ZodSchema<T>, input: unknown): ValidationResult<T>;
+export declare function validateCreatePaymentOnchain(input: unknown): ValidationResult<CreatePaymentOnchainInput>;
+export declare function validateCreatePaymentRedirect(input: unknown): ValidationResult<CreatePaymentRedirectInput>;
+export declare function validateGetPaymentStatus(input: unknown): ValidationResult<GetPaymentStatusInput>;
+export declare function validateListCurrenciesCatalog(input: unknown): ValidationResult<ListCurrenciesCatalogInput>;
+export declare function validateAmountForCurrency(amount: number, currency: {
+    minAmount: number;
+    maxAmount: number | null;
+}): ValidationResult<number>;
+export declare function validatePaymentStatus(status: string): ValidationResult<PaymentStatusCode>;
+export declare const envConfigSchema: z.ZodObject<{
+    UNIVERSAL_CRYPTO_DEVICE_ID: z.ZodString;
+    UNIVERSAL_CRYPTO_BASE_URL: z.ZodString;
+    UNIVERSAL_CRYPTO_DEVICE_SECRET: z.ZodOptional<z.ZodString>;
+    LOG_LEVEL: z.ZodOptional<z.ZodDefault<z.ZodEnum<["error", "warn", "info", "debug"]>>>;
+    NODE_ENV: z.ZodOptional<z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>>;
+    API_TIMEOUT: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    MAX_RETRIES: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    RETRY_DELAY: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    WEBHOOK_ENABLED: z.ZodEffects<z.ZodDefault<z.ZodBoolean>, boolean, unknown>;
+    WEBHOOK_PORT: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    WEBHOOK_HOST: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    WEBHOOK_PATH: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    WEBHOOK_MAX_EVENTS: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    WEBHOOK_EVENT_TTL_MS: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    TUNNEL_ENABLED: z.ZodEffects<z.ZodDefault<z.ZodBoolean>, boolean, unknown>;
+    TUNNEL_PROVIDER: z.ZodOptional<z.ZodDefault<z.ZodEnum<["ngrok", "zrok", "manual"]>>>;
+    NGROK_AUTHTOKEN: z.ZodOptional<z.ZodString>;
+    NGROK_DOMAIN: z.ZodOptional<z.ZodString>;
+    ZROK_TOKEN: z.ZodOptional<z.ZodString>;
+    ZROK_UNIQUE_NAME: z.ZodOptional<z.ZodString>;
+    WEBHOOK_PUBLIC_URL: z.ZodOptional<z.ZodString>;
+    TUNNEL_HEALTH_CHECK_INTERVAL: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    TUNNEL_RECONNECT_MAX_RETRIES: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    TUNNEL_RECONNECT_BACKOFF_MS: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    UNIVERSAL_CRYPTO_DEVICE_ID: string;
+    UNIVERSAL_CRYPTO_BASE_URL: string;
+    WEBHOOK_ENABLED: boolean;
+    TUNNEL_ENABLED: boolean;
+    LOG_LEVEL?: "error" | "info" | "warn" | "debug" | undefined;
+    UNIVERSAL_CRYPTO_DEVICE_SECRET?: string | undefined;
+    NODE_ENV?: "development" | "production" | "test" | undefined;
+    API_TIMEOUT?: number | undefined;
+    MAX_RETRIES?: number | undefined;
+    RETRY_DELAY?: number | undefined;
+    WEBHOOK_PORT?: number | undefined;
+    WEBHOOK_HOST?: string | undefined;
+    WEBHOOK_PATH?: string | undefined;
+    TUNNEL_PROVIDER?: "ngrok" | "zrok" | "manual" | undefined;
+    WEBHOOK_PUBLIC_URL?: string | undefined;
+    NGROK_AUTHTOKEN?: string | undefined;
+    NGROK_DOMAIN?: string | undefined;
+    ZROK_TOKEN?: string | undefined;
+    ZROK_UNIQUE_NAME?: string | undefined;
+    TUNNEL_HEALTH_CHECK_INTERVAL?: number | undefined;
+    TUNNEL_RECONNECT_MAX_RETRIES?: number | undefined;
+    TUNNEL_RECONNECT_BACKOFF_MS?: number | undefined;
+    WEBHOOK_MAX_EVENTS?: number | undefined;
+    WEBHOOK_EVENT_TTL_MS?: number | undefined;
+}, {
+    UNIVERSAL_CRYPTO_DEVICE_ID: string;
+    UNIVERSAL_CRYPTO_BASE_URL: string;
+    LOG_LEVEL?: "error" | "info" | "warn" | "debug" | undefined;
+    UNIVERSAL_CRYPTO_DEVICE_SECRET?: string | undefined;
+    NODE_ENV?: "development" | "production" | "test" | undefined;
+    API_TIMEOUT?: number | undefined;
+    MAX_RETRIES?: number | undefined;
+    RETRY_DELAY?: number | undefined;
+    WEBHOOK_ENABLED?: unknown;
+    WEBHOOK_PORT?: number | undefined;
+    WEBHOOK_HOST?: string | undefined;
+    WEBHOOK_PATH?: string | undefined;
+    TUNNEL_ENABLED?: unknown;
+    TUNNEL_PROVIDER?: "ngrok" | "zrok" | "manual" | undefined;
+    WEBHOOK_PUBLIC_URL?: string | undefined;
+    NGROK_AUTHTOKEN?: string | undefined;
+    NGROK_DOMAIN?: string | undefined;
+    ZROK_TOKEN?: string | undefined;
+    ZROK_UNIQUE_NAME?: string | undefined;
+    TUNNEL_HEALTH_CHECK_INTERVAL?: number | undefined;
+    TUNNEL_RECONNECT_MAX_RETRIES?: number | undefined;
+    TUNNEL_RECONNECT_BACKOFF_MS?: number | undefined;
+    WEBHOOK_MAX_EVENTS?: number | undefined;
+    WEBHOOK_EVENT_TTL_MS?: number | undefined;
+}>;
+export declare function validateEnvironmentConfig(env: Record<string, string | undefined>): ValidationResult<z.infer<typeof envConfigSchema>>;
+export declare function isValidUuid(value: string): boolean;
+export declare function isValidCurrencySymbol(value: string): boolean;
+export declare function isValidUrl(value: string): boolean;
+export declare function sanitizeNotes(notes: string | undefined): string | undefined;
+export declare function normalizeAmount(amount: number): number;
+export declare function getHttpStatusForValidationError(code: string): number;
+//# sourceMappingURL=validation.d.ts.map

package/build/vendors/payments/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/vendors/payments/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAqC3B,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKU,CAAC;AAElD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;EAMU,CAAC;AAEnD,eAAO,MAAM,sBAAsB;;;;;;EAEU,CAAC;AAE9C,eAAO,MAAM,2BAA2B;;;;;;EAEU,CAAC;AAGnD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC;AAGzE,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,CAuCrB;AAGD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,yBAAyB,CAAC,CAE7C;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,0BAA0B,CAAC,CAE9C;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,qBAAqB,CAAC,CAEzC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,0BAA0B,CAAC,CAE9C;AAGD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxD,gBAAgB,CAAC,MAAM,CAAC,CAyB1B;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GACb,gBAAgB,CAAC,iBAAiB,CAAC,CAiBrC;AAGD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgG1B,CAAC;AAEH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC,CAuBnD;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAc3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAGD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAapE"}

package/build/vendors/payments/utils/validation.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+// Input validation utilities using zod for schema validation and type safety
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envConfigSchema = exports.listCurrenciesCatalogSchema = exports.getPaymentStatusSchema = exports.createPaymentRedirectSchema = exports.createPaymentOnchainSchema = void 0;
+exports.validateInput = validateInput;
+exports.validateCreatePaymentOnchain = validateCreatePaymentOnchain;
+exports.validateCreatePaymentRedirect = validateCreatePaymentRedirect;
+exports.validateGetPaymentStatus = validateGetPaymentStatus;
+exports.validateListCurrenciesCatalog = validateListCurrenciesCatalog;
+exports.validateAmountForCurrency = validateAmountForCurrency;
+exports.validatePaymentStatus = validatePaymentStatus;
+exports.validateEnvironmentConfig = validateEnvironmentConfig;
+exports.isValidUuid = isValidUuid;
+exports.isValidCurrencySymbol = isValidCurrencySymbol;
+exports.isValidUrl = isValidUrl;
+exports.sanitizeNotes = sanitizeNotes;
+exports.normalizeAmount = normalizeAmount;
+exports.getHttpStatusForValidationError = getHttpStatusForValidationError;
+const zod_1 = require("zod");
+// Custom zod validators for domain-specific types
+const uuidSchema = zod_1.z.string().uuid('Invalid UUID format');
+const currencySymbolSchema = zod_1.z
+    .string()
+    .regex(/^[A-Z0-9_]+$/, 'Currency symbol must be uppercase alphanumeric with underscores');
+const fiatCurrencySchema = zod_1.z
+    .string()
+    .regex(/^[A-Z]{3}$/, 'Fiat currency must be 3-letter uppercase code (e.g., EUR, USD)');
+const positiveNumberSchema = zod_1.z.number().positive('Amount must be positive');
+const urlSchema = zod_1.z.string().url('Invalid URL format');
+const notesSchema = zod_1.z
+    .string()
+    .max(256, 'Notes cannot exceed 256 characters')
+    .optional();
+// Payment status code validation
+const paymentStatusSchema = zod_1.z.enum([
+    'NR',
+    'PE',
+    'AC',
+    'IA',
+    'OC',
+    'CO',
+    'CA',
+    'EX',
+    'FA',
+]);
+// MCP Tool Input Schemas
+exports.createPaymentOnchainSchema = zod_1.z.object({
+    amount_eur: positiveNumberSchema,
+    input_currency: currencySymbolSchema,
+    fiat: fiatCurrencySchema.default('EUR').optional(),
+    notes: notesSchema,
+});
+exports.createPaymentRedirectSchema = zod_1.z.object({
+    amount_eur: positiveNumberSchema,
+    url_ok: urlSchema.optional(),
+    url_ko: urlSchema.optional(),
+    fiat: fiatCurrencySchema.default('EUR').optional(),
+    notes: notesSchema,
+});
+exports.getPaymentStatusSchema = zod_1.z.object({
+    identifier: uuidSchema,
+});
+exports.listCurrenciesCatalogSchema = zod_1.z.object({
+    filter_by_amount: positiveNumberSchema.optional(),
+});
+// Generic validation function
+function validateInput(schema, input) {
+    try {
+        const result = schema.safeParse(input);
+        if (result.success) {
+            return {
+                success: true,
+                data: result.data,
+            };
+        }
+        // Extract first validation error
+        const firstError = result.error.errors[0];
+        if (!firstError) {
+            return {
+                success: false,
+                error: {
+                    message: 'Validation failed',
+                    code: 'VALIDATION_ERROR',
+                },
+            };
+        }
+        return {
+            success: false,
+            error: {
+                message: firstError.message,
+                field: firstError.path.join('.'),
+                code: firstError.code,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: {
+                message: 'Validation failed due to internal error',
+                code: 'INTERNAL_ERROR',
+            },
+        };
+    }
+}
+// Specific validation functions for each MCP tool
+function validateCreatePaymentOnchain(input) {
+    return validateInput(exports.createPaymentOnchainSchema, input);
+}
+function validateCreatePaymentRedirect(input) {
+    return validateInput(exports.createPaymentRedirectSchema, input);
+}
+function validateGetPaymentStatus(input) {
+    return validateInput(exports.getPaymentStatusSchema, input);
+}
+function validateListCurrenciesCatalog(input) {
+    return validateInput(exports.listCurrenciesCatalogSchema, input);
+}
+// Additional business logic validators
+function validateAmountForCurrency(amount, currency) {
+    if (amount < currency.minAmount) {
+        return {
+            success: false,
+            error: {
+                message: `Amount ${amount} is below minimum ${currency.minAmount} for this currency`,
+                code: 'AMOUNT_BELOW_MINIMUM',
+            },
+        };
+    }
+    if (currency.maxAmount !== null && amount > currency.maxAmount) {
+        return {
+            success: false,
+            error: {
+                message: `Amount ${amount} exceeds maximum ${currency.maxAmount} for this currency`,
+                code: 'AMOUNT_ABOVE_MAXIMUM',
+            },
+        };
+    }
+    return {
+        success: true,
+        data: amount,
+    };
+}
+function validatePaymentStatus(status) {
+    const result = paymentStatusSchema.safeParse(status);
+    if (result.success) {
+        return {
+            success: true,
+            data: result.data,
+        };
+    }
+    return {
+        success: false,
+        error: {
+            message: `Invalid payment status: ${status}. Must be one of: NR, PE, AC, IA, OC, CO, CA, EX, FA`,
+            code: 'INVALID_STATUS',
+        },
+    };
+}
+// Environment variable validation schemas
+exports.envConfigSchema = zod_1.z.object({
+    UNIVERSAL_CRYPTO_DEVICE_ID: zod_1.z
+        .string()
+        .min(8, 'Device ID must be at least 8 characters'),
+    UNIVERSAL_CRYPTO_BASE_URL: zod_1.z.string().url('Base URL must be valid HTTP/HTTPS URL'),
+    UNIVERSAL_CRYPTO_DEVICE_SECRET: zod_1.z.string().optional(),
+    LOG_LEVEL: zod_1.z
+        .enum(['error', 'warn', 'info', 'debug'])
+        .default('info')
+        .optional(),
+    NODE_ENV: zod_1.z
+        .enum(['development', 'production', 'test'])
+        .default('production')
+        .optional(),
+    API_TIMEOUT: zod_1.z.coerce
+        .number()
+        .int()
+        .min(1000)
+        .max(30000)
+        .default(5000)
+        .optional(),
+    MAX_RETRIES: zod_1.z.coerce.number().int().min(0).max(5).default(2).optional(),
+    RETRY_DELAY: zod_1.z.coerce
+        .number()
+        .int()
+        .min(100)
+        .max(10000)
+        .default(1000)
+        .optional(),
+    // Webhook configuration
+    WEBHOOK_ENABLED: zod_1.z.preprocess(val => (val === 'true' || val === '1'), zod_1.z.boolean().default(false)),
+    WEBHOOK_PORT: zod_1.z.coerce
+        .number()
+        .int()
+        .min(1024)
+        .max(65535)
+        .default(3000)
+        .optional(),
+    WEBHOOK_HOST: zod_1.z.string().default('0.0.0.0').optional(),
+    WEBHOOK_PATH: zod_1.z.string().default('/webhook/bitnovo').optional(),
+    WEBHOOK_MAX_EVENTS: zod_1.z.coerce
+        .number()
+        .int()
+        .min(100)
+        .max(10000)
+        .default(1000)
+        .optional(),
+    WEBHOOK_EVENT_TTL_MS: zod_1.z.coerce
+        .number()
+        .int()
+        .min(60000) // 1 minute
+        .max(86400000) // 24 hours
+        .default(3600000) // 1 hour
+        .optional(),
+    // Tunnel configuration
+    TUNNEL_ENABLED: zod_1.z.preprocess(val => (val === 'true' || val === '1'), zod_1.z.boolean().default(true)),
+    TUNNEL_PROVIDER: zod_1.z
+        .enum(['ngrok', 'zrok', 'manual'])
+        .default('ngrok')
+        .optional(),
+    // ngrok specific
+    NGROK_AUTHTOKEN: zod_1.z.string().optional(),
+    NGROK_DOMAIN: zod_1.z.string().optional(), // Free static domain
+    // zrok specific
+    ZROK_TOKEN: zod_1.z.string().optional(),
+    ZROK_UNIQUE_NAME: zod_1.z.string().optional(), // Reserved share name
+    // Manual provider
+    WEBHOOK_PUBLIC_URL: zod_1.z.string().url().optional(), // For manual provider (N8N, Opal, VPS)
+    // Tunnel health and reconnection
+    TUNNEL_HEALTH_CHECK_INTERVAL: zod_1.z.coerce
+        .number()
+        .int()
+        .min(30000) // 30 seconds
+        .max(300000) // 5 minutes
+        .default(60000) // 1 minute
+        .optional(),
+    TUNNEL_RECONNECT_MAX_RETRIES: zod_1.z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .default(10)
+        .optional(),
+    TUNNEL_RECONNECT_BACKOFF_MS: zod_1.z.coerce
+        .number()
+        .int()
+        .min(1000)
+        .max(30000)
+        .default(5000)
+        .optional(),
+});
+function validateEnvironmentConfig(env) {
+    const result = exports.envConfigSchema.safeParse(env);
+    if (!result.success) {
+        const firstError = result.error.errors[0] || {
+            message: 'Validation failed',
+            path: [],
+            code: 'custom',
+        };
+        return {
+            success: false,
+            error: {
+                message: firstError.message,
+                field: firstError.path.join('.'),
+                code: firstError.code,
+            },
+        };
+    }
+    return {
+        success: true,
+        data: result.data,
+    };
+}
+// Utility functions for common validations
+function isValidUuid(value) {
+    return uuidSchema.safeParse(value).success;
+}
+function isValidCurrencySymbol(value) {
+    return currencySymbolSchema.safeParse(value).success;
+}
+function isValidUrl(value) {
+    return urlSchema.safeParse(value).success;
+}
+function sanitizeNotes(notes) {
+    if (!notes)
+        return undefined;
+    // Trim and limit length
+    const trimmed = notes.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    // Remove potentially dangerous characters (basic XSS prevention)
+    const sanitized = trimmed
+        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+        .replace(/<[^>]*>/g, '')
+        .slice(0, 256);
+    return sanitized || undefined;
+}
+function normalizeAmount(amount) {
+    // Round to 2 decimal places to avoid floating point precision issues
+    return Math.round(amount * 100) / 100;
+}
+// Error type mapping for HTTP responses
+function getHttpStatusForValidationError(code) {
+    const statusMap = {
+        INVALID_UUID: 400,
+        INVALID_CURRENCY: 400,
+        INVALID_URL: 400,
+        AMOUNT_BELOW_MINIMUM: 400,
+        AMOUNT_ABOVE_MAXIMUM: 400,
+        INVALID_STATUS: 400,
+        REQUIRED_FIELD: 400,
+        INTERNAL_ERROR: 500,
+    };
+    return statusMap[code] ?? 400;
+}
+//# sourceMappingURL=validation.js.map

package/build/vendors/payments/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/vendors/payments/utils/validation.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,6EAA6E;;;AAuF7E,sCA0CC;AAGD,oEAIC;AAED,sEAIC;AAED,4DAIC;AAED,sEAIC;AAGD,8DA4BC;AAED,sDAmBC;AAqGD,8DAyBC;AAGD,kCAEC;AAED,sDAEC;AAED,gCAEC;AAED,sCAcC;AAED,0CAGC;AAGD,0EAaC;AA5XD,6BAAwB;AASxB,kDAAkD;AAClD,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAC1D,MAAM,oBAAoB,GAAG,OAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CACJ,cAAc,EACd,iEAAiE,CAClE,CAAC;AACJ,MAAM,kBAAkB,GAAG,OAAC;KACzB,MAAM,EAAE;KACR,KAAK,CACJ,YAAY,EACZ,gEAAgE,CACjE,CAAC;AACJ,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAC5E,MAAM,SAAS,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACvD,MAAM,WAAW,GAAG,OAAC;KAClB,MAAM,EAAE;KACR,GAAG,CAAC,GAAG,EAAE,oCAAoC,CAAC;KAC9C,QAAQ,EAAE,CAAC;AAEd,iCAAiC;AACjC,MAAM,mBAAmB,GAAG,OAAC,CAAC,IAAI,CAAC;IACjC,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH,yBAAyB;AACZ,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,oBAAoB;IAChC,cAAc,EAAE,oBAAoB;IACpC,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAClD,KAAK,EAAE,WAAW;CACnB,CAAgD,CAAC;AAErC,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,UAAU,EAAE,oBAAoB;IAChC,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAClD,KAAK,EAAE,WAAW;CACnB,CAAiD,CAAC;AAEtC,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,UAAU;CACvB,CAA4C,CAAC;AAEjC,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,gBAAgB,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAClD,CAAiD,CAAC;AAmBnD,8BAA8B;AAC9B,SAAgB,aAAa,CAC3B,MAAsB,EACtB,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,OAAO,EAAE,mBAAmB;oBAC5B,IAAI,EAAE,kBAAkB;iBACzB;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBAChC,IAAI,EAAE,UAAU,CAAC,IAAI;aACtB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,gBAAgB;aACvB;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,SAAgB,4BAA4B,CAC1C,KAAc;IAEd,OAAO,aAAa,CAAC,kCAA0B,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,aAAa,CAAC,mCAA2B,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,wBAAwB,CACtC,KAAc;IAEd,OAAO,aAAa,CAAC,8BAAsB,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,aAAa,CAAC,mCAA2B,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,uCAAuC;AACvC,SAAgB,yBAAyB,CACvC,MAAc,EACd,QAAyD;IAEzD,IAAI,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,OAAO,EAAE,UAAU,MAAM,qBAAqB,QAAQ,CAAC,SAAS,oBAAoB;gBACpF,IAAI,EAAE,sBAAsB;aAC7B;SACF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,SAAS,KAAK,IAAI,IAAI,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC/D,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,OAAO,EAAE,UAAU,MAAM,oBAAoB,QAAQ,CAAC,SAAS,oBAAoB;gBACnF,IAAI,EAAE,sBAAsB;aAC7B;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM;KACb,CAAC;AACJ,CAAC;AAED,SAAgB,qBAAqB,CACnC,MAAc;IAEd,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAErD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACL,OAAO,EAAE,2BAA2B,MAAM,sDAAsD;YAChG,IAAI,EAAE,gBAAgB;SACvB;KACF,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC7B,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,0BAA0B,EAAE,OAAC;SAC1B,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,yCAAyC,CAAC;IACpD,yBAAyB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,uCAAuC,CAAC;IAClF,8BAA8B,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrD,SAAS,EAAE,OAAC;SACT,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;SACxC,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,EAAE;IACb,QAAQ,EAAE,OAAC;SACR,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;SAC3C,OAAO,CAAC,YAAY,CAAC;SACrB,QAAQ,EAAE;IACb,WAAW,EAAE,OAAC,CAAC,MAAM;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,IAAI,CAAC;SACT,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,EAAE;IACb,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxE,WAAW,EAAE,OAAC,CAAC,MAAM;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,GAAG,CAAC;SACR,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,EAAE;IACb,wBAAwB;IACxB,eAAe,EAAE,OAAC,CAAC,UAAU,CAC3B,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,EACtC,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAC3B;IACD,YAAY,EAAE,OAAC,CAAC,MAAM;SACnB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,IAAI,CAAC;SACT,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,EAAE;IACb,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IACtD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IAC/D,kBAAkB,EAAE,OAAC,CAAC,MAAM;SACzB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,GAAG,CAAC;SACR,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,EAAE;IACb,oBAAoB,EAAE,OAAC,CAAC,MAAM;SAC3B,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW;SACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,WAAW;SACzB,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS;SAC1B,QAAQ,EAAE;IACb,uBAAuB;IACvB,cAAc,EAAE,OAAC,CAAC,UAAU,CAC1B,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,EACtC,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAC1B;IACD,eAAe,EAAE,OAAC;SACf,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACjC,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,EAAE;IACb,iBAAiB;IACjB,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;IAC1D,gBAAgB;IAChB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,sBAAsB;IAC/D,kBAAkB;IAClB,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,uCAAuC;IACxF,iCAAiC;IACjC,4BAA4B,EAAE,OAAC,CAAC,MAAM;SACnC,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa;SACxB,GAAG,CAAC,MAAM,CAAC,CAAC,YAAY;SACxB,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW;SAC1B,QAAQ,EAAE;IACb,4BAA4B,EAAE,OAAC,CAAC,MAAM;SACnC,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,EAAE;IACb,2BAA2B,EAAE,OAAC,CAAC,MAAM;SAClC,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,IAAI,CAAC;SACT,GAAG,CAAC,KAAK,CAAC;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,SAAgB,yBAAyB,CACvC,GAAuC;IAEvC,MAAM,MAAM,GAAG,uBAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;YAC3C,OAAO,EAAE,mBAAmB;YAC5B,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,QAAQ;SACf,CAAC;QACF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBAChC,IAAI,EAAE,UAAU,CAAC,IAAI;aACtB;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC7C,CAAC;AAED,SAAgB,qBAAqB,CAAC,KAAa;IACjD,OAAO,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC5C,CAAC;AAED,SAAgB,aAAa,CAAC,KAAyB;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,wBAAwB;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,iEAAiE;IACjE,MAAM,SAAS,GAAG,OAAO;SACtB,OAAO,CAAC,qDAAqD,EAAE,EAAE,CAAC;SAClE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEjB,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAED,SAAgB,eAAe,CAAC,MAAc;IAC5C,qEAAqE;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACxC,CAAC;AAED,wCAAwC;AACxC,SAAgB,+BAA+B,CAAC,IAAY;IAC1D,MAAM,SAAS,GAA2B;QACxC,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE,GAAG;QACrB,WAAW,EAAE,GAAG;QAChB,oBAAoB,EAAE,GAAG;QACzB,oBAAoB,EAAE,GAAG;QACzB,cAAc,EAAE,GAAG;QACnB,cAAc,EAAE,GAAG;QACnB,cAAc,EAAE,GAAG;KACpB,CAAC;IAEF,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAChC,CAAC"}

package/build/vendors/payments/webhook-handler.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @author Nich
+ * @website x.com/nichxbt
+ * @github github.com/nirholas
+ * @license MIT
+ */
+import { z } from 'zod';
+import type { Configuration } from './types/index.js';
+/**
+ * Bitnovo webhook payload schema
+ * Based on PaymentSerializer from backend reference
+ */
+declare const WebhookPayloadSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    status: z.ZodEnum<["NR", "PE", "AC", "IA", "OC", "CO", "CA", "EX", "FA", "RF"]>;
+    fiat_amount: z.ZodOptional<z.ZodNumber>;
+    notes: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    expired_at: z.ZodOptional<z.ZodString>;
+    expected_input_amount: z.ZodOptional<z.ZodNumber>;
+    input_amount: z.ZodOptional<z.ZodNumber>;
+    confirmed_amount: z.ZodOptional<z.ZodNumber>;
+    unconfirmed_amount: z.ZodOptional<z.ZodNumber>;
+    crypto_amount: z.ZodOptional<z.ZodNumber>;
+    exchange_rate: z.ZodOptional<z.ZodNumber>;
+    network_fee: z.ZodOptional<z.ZodNumber>;
+    expired_time: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    tag_memo: z.ZodOptional<z.ZodString>;
+    input_currency: z.ZodOptional<z.ZodString>;
+    fiat: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    payment_uri: z.ZodOptional<z.ZodString>;
+    web_url: z.ZodOptional<z.ZodString>;
+    good_fee: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    status: "NR" | "PE" | "AC" | "IA" | "OC" | "CO" | "CA" | "EX" | "FA" | "RF";
+    identifier: string;
+    address?: string | undefined;
+    reference?: string | undefined;
+    created_at?: string | undefined;
+    notes?: string | undefined;
+    payment_uri?: string | undefined;
+    web_url?: string | undefined;
+    fiat_amount?: number | undefined;
+    expired_at?: string | undefined;
+    expected_input_amount?: number | undefined;
+    input_amount?: number | undefined;
+    confirmed_amount?: number | undefined;
+    unconfirmed_amount?: number | undefined;
+    crypto_amount?: number | undefined;
+    exchange_rate?: number | undefined;
+    network_fee?: number | undefined;
+    expired_time?: string | undefined;
+    tag_memo?: string | undefined;
+    input_currency?: string | undefined;
+    fiat?: string | undefined;
+    language?: string | undefined;
+    good_fee?: boolean | undefined;
+}, {
+    status: "NR" | "PE" | "AC" | "IA" | "OC" | "CO" | "CA" | "EX" | "FA" | "RF";
+    identifier: string;
+    address?: string | undefined;
+    reference?: string | undefined;
+    created_at?: string | undefined;
+    notes?: string | undefined;
+    payment_uri?: string | undefined;
+    web_url?: string | undefined;
+    fiat_amount?: number | undefined;
+    expired_at?: string | undefined;
+    expected_input_amount?: number | undefined;
+    input_amount?: number | undefined;
+    confirmed_amount?: number | undefined;
+    unconfirmed_amount?: number | undefined;
+    crypto_amount?: number | undefined;
+    exchange_rate?: number | undefined;
+    network_fee?: number | undefined;
+    expired_time?: string | undefined;
+    tag_memo?: string | undefined;
+    input_currency?: string | undefined;
+    fiat?: string | undefined;
+    language?: string | undefined;
+    good_fee?: boolean | undefined;
+}>;
+export type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
+export interface WebhookRequest {
+    headers: {
+        'x-nonce'?: string;
+        'x-signature'?: string;
+        [key: string]: string | undefined;
+    };
+    body: unknown;
+    rawBody: string;
+}
+export interface WebhookHandlerResult {
+    success: boolean;
+    eventId?: string;
+    error?: string;
+    errorCode?: string;
+    statusCode: number;
+}
+export declare class WebhookHandler {
+    private config;
+    private nonceCache;
+    constructor(config: Configuration);
+    /**
+     * Process an incoming webhook request
+     * @param request - The webhook HTTP request
+     * @returns Processing result with status code
+     */
+    handle(request: WebhookRequest): Promise<WebhookHandlerResult>;
+    /**
+     * Generate a unique event ID from identifier and nonce
+     * @param identifier - Payment identifier
+     * @param nonce - Webhook nonce
+     * @returns Unique event ID
+     */
+    private generateEventId;
+    /**
+     * Get webhook handler statistics
+     */
+    getStats(): {
+        noncesCached: number;
+        hasDeviceSecret: boolean;
+    };
+}
+/**
+ * Create a webhook handler instance
+ * @param config - Server configuration
+ * @returns WebhookHandler instance
+ */
+export declare function createWebhookHandler(config: Configuration): WebhookHandler;
+export {};
+//# sourceMappingURL=webhook-handler.d.ts.map

package/build/vendors/payments/webhook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-handler.d.ts","sourceRoot":"","sources":["../../../src/vendors/payments/webhook-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD;;;GAGG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBxB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;IACF,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAmB;gBAEzB,MAAM,EAAE,aAAa;IASjC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4JpE;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;KAC1B;CAMF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAE1E"}