@plyaz/types 1.13.14 → 1.13.15

package/dist/payments/base-error/types.d.ts

@@ -2,9 +2,9 @@ import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE, ProviderCapabilities, Provider
 import type { Money } from '../transaction';
 import type { BaseErrorContext } from '../../api';
 import type { EventProcessingMetadata, PaymentEventPayload, PAYMENTEVENTTYPE } from '../events';
-import type { CURRENCY_CODES } from '@plyaz/config';
 import type { PAYMENT_ERROR_CATEGORY } from './enum';
 import type { ERROR_SEVERITY } from '../../errors';
+import type { CurrencyCode } from '@plyaz/config';
 /**
  * Base adapter options used for constructing provider adapters.
  */
@@ -12,7 +12,7 @@ export interface BasePaymentAdapterOptions {
     name: PAYMENTPROVIDERTYPE;
     apiVersion: string;
     methods: PAYMENTMETHOD[];
-    currencies: (typeof CURRENCY_CODES)[];
+    currencies: CurrencyCode[];
     capabilities: ProviderCapabilities;
     providerConfiguration: ProviderConfiguration;
 }

package/dist/payments/gateways/provider/types.d.ts

@@ -1,4 +1,4 @@
-import type { CURRENCY_CODES } from '@plyaz/config';
+import type { CurrencyCode } from '@plyaz/config';
 import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE } from '../../provider';
 /**
  * Base configuration interface that all payment providers must implement.
@@ -238,13 +238,13 @@ export interface ProviderFeeConfiguration {
         /** Fixed fee per transaction (in cents) */
         fixed: number;
         /** Currency for fixed fees */
-        currency: typeof CURRENCY_CODES;
+        currency: CurrencyCode;
     };
     /** Payment method specific fees */
     methodFees: Record<PAYMENTMETHOD, {
         percentage: number;
         fixed: number;
-        currency: typeof CURRENCY_CODES;
+        currency: CurrencyCode;
     }>;
     /** Volume-based fee tiers */
     volumeTiers: VolumeTier[];
@@ -252,7 +252,7 @@ export interface ProviderFeeConfiguration {
     regionalFees: Record<string, {
         percentage: number;
         fixed: number;
-        currency: typeof CURRENCY_CODES;
+        currency: CurrencyCode;
     }>;
     /** Additional fee types */
     additionalFees: {
@@ -269,7 +269,7 @@ export interface ProviderFeeConfiguration {
         /** Chargeback fees */
         chargeback?: {
             amount: number;
-            currency: typeof CURRENCY_CODES;
+            currency: CurrencyCode;
         };
         /** Refund processing fees */
         refund?: {
@@ -284,12 +284,12 @@ export interface ProviderFeeConfiguration {
         /** Minimum fee amount */
         minimumFee?: {
             amount: number;
-            currency: typeof CURRENCY_CODES;
+            currency: CurrencyCode;
         };
         /** Maximum fee amount */
         maximumFee?: {
             amount: number;
-            currency: typeof CURRENCY_CODES;
+            currency: CurrencyCode;
         };
     };
 }
@@ -302,13 +302,13 @@ export interface VolumeTier {
     /** Minimum monthly volume to qualify */
     minimumVolume: {
         amount: number;
-        currency: typeof CURRENCY_CODES;
+        currency: CurrencyCode;
     };
     /** Fee rates for this tier */
     feeRates: {
         percentage: number;
         fixed: number;
-        currency: typeof CURRENCY_CODES;
+        currency: CurrencyCode;
     };
     /** Tier benefits */
     benefits?: string[];
@@ -324,12 +324,12 @@ export interface ProviderLimitsConfiguration<TProviderSpecific extends object =
         /** Minimum transaction amount */
         minimum: Record<PAYMENTMETHOD, {
             amount: number;
-            currency: typeof CURRENCY_CODES;
+            currency: CurrencyCode;
         }>;
         /** Maximum transaction amount */
         maximum: Record<PAYMENTMETHOD, {
             amount: number;
-            currency: typeof CURRENCY_CODES;
+            currency: CurrencyCode;
         }>;
     };
     /** Velocity limits */
@@ -341,7 +341,7 @@ export interface ProviderLimitsConfiguration<TProviderSpecific extends object =
             /** Maximum total amount */
             maxAmount: {
                 amount: number;
-                currency: typeof CURRENCY_CODES;
+                currency: CurrencyCode;
             };
         };
         /** Monthly transaction limits */
@@ -349,7 +349,7 @@ export interface ProviderLimitsConfiguration<TProviderSpecific extends object =
             maxTransactions: number;
             maxAmount: {
                 amount: number;
-                currency: typeof CURRENCY_CODES;
+                currency: CurrencyCode;
             };
         };
     };

package/dist/payments/gateways/routings/types.d.ts

@@ -1,4 +1,4 @@
-import type { CURRENCY_CODES } from '@plyaz/config';
+import type { CurrencyCode } from '@plyaz/config';
 import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE, TRANSACTIONTYPE, USERTYPE } from '../../provider';
 import type { VolumeTier } from '../provider/types';
 import type { COSTOPTIMIZATIONSTRATEGY, FAILOVERSTRATEGY, LOADBALANCINGSTRATEGY, PERFORMANCEMETRICTYPE, REGULATORYFRAMEWORK, ROUTINGSTRATEGY } from './enums';
@@ -35,7 +35,7 @@ export interface ProviderSelectionRules {
     /** Amount-based provider selection */
     amountBasedSelection: AmountBasedRule[];
     /** Currency-specific provider preferences */
-    currencySpecificProviders: Record<keyof typeof CURRENCY_CODES, ProviderPreference[]>;
+    currencySpecificProviders: Record<CurrencyCode, ProviderPreference[]>;
     /** Region-specific provider preferences */
     regionSpecificProviders: Record<string, ProviderPreference[]>;
     /** User type specific preferences */
@@ -60,12 +60,12 @@ export interface ProviderPreference {
     /** Maximum transaction amount for this provider */
     maxAmount?: {
         amount: number;
-        currency: typeof CURRENCY_CODES;
+        currency: CurrencyCode;
     };
     /** Minimum transaction amount for this provider */
     minAmount?: {
         amount: number;
-        currency: typeof CURRENCY_CODES;
+        currency: CurrencyCode;
     };
     /** Health check requirements */
     healthRequirements: {
@@ -100,11 +100,11 @@ export interface AmountBasedRule {
     amountRange: {
         min: {
             amount: number;
-            currency: typeof CURRENCY_CODES;
+            currency: CurrencyCode;
         };
         max: {
             amount: number;
-            currency: typeof CURRENCY_CODES;
+            currency: CurrencyCode;
         };
     };
     /** Preferred providers for this amount range */
@@ -307,7 +307,7 @@ export interface GeographicRoutingConfig {
         enabled: boolean;
         /** Zone definitions */
         zones: Record<string, {
-            currencies: (typeof CURRENCY_CODES)[];
+            currencies: CurrencyCode[];
             preferredProviders: PAYMENTPROVIDERTYPE[];
         }>;
     };
@@ -330,11 +330,11 @@ export interface RegionRoutingConfig {
         transactionLimits: {
             daily: {
                 amount: number;
-                currency: typeof CURRENCY_CODES;
+                currency: CurrencyCode;
             };
             monthly: {
                 amount: number;
-                currency: typeof CURRENCY_CODES;
+                currency: CurrencyCode;
             };
         };
         /** Required licenses */
@@ -368,11 +368,11 @@ export interface ComplianceRule {
         amountThresholds?: {
             min?: {
                 amount: number;
-                currency: typeof CURRENCY_CODES;
+                currency: CurrencyCode;
             };
             max?: {
                 amount: number;
-                currency: typeof CURRENCY_CODES;
+                currency: CurrencyCode;
             };
         };
         /** User types affected */
@@ -510,3 +510,22 @@ export interface ABTestExperiment {
     /** Experiment active status */
     active: boolean;
 }
+/**
+ * Enumerates all routing rule identifiers used within RouterStrategy.
+ *
+ * Purpose:
+ * - Avoid hardcoded strings for rule names
+ * - Provide consistent naming for debugging and error contexts
+ * - Improve developer experience via auto-completion
+ */
+export declare enum ROUTER_RULE_NAME {
+    AmountBasedSelection = "amountBasedSelection",
+    CurrencySpecificProviders = "currencySpecificProviders",
+    RegionSelection = "regionSelection",
+    RegionCompliance = "regionCompliance",
+    UserTypeSelection = "userTypeSelection",
+    TimeBasedSelection = "timeBasedSelection",
+    CustomRuleEvaluation = "customRuleEvaluation",
+    ABTesting = "abTesting",
+    DefaultSelection = "defaultSelection"
+}

package/dist/payments/provider/adapter/types.d.ts

@@ -1,4 +1,4 @@
-import type { CURRENCY_CODES } from '@plyaz/config';
+import type { CurrencyCode } from '@plyaz/config';
 import type { ProviderHealthStatus } from '../../../features';
 import type { BaseProviderConfig } from '../../gateways';
 import type { PaymentResult, ProcessPaymentRequest } from '../../request';
@@ -25,7 +25,7 @@ export interface PaymentAdapter {
     /** Payment methods supported by this provider */
     readonly supportedMethods: PAYMENTMETHOD[];
     /** Currencies supported by this provider */
-    readonly supportedCurrencies: typeof CURRENCY_CODES[];
+    readonly supportedCurrencies: CurrencyCode[];
     /** Detailed capabilities of this provider */
     readonly capabilities: ProviderCapabilities;
     /** Provider configuration and metadata */

package/dist/payments/provider/core/types.d.ts

@@ -1,4 +1,4 @@
-import type { CURRENCY_CODES } from '@plyaz/config';
+import type { CurrencyCode } from '@plyaz/config';
 import type { FeeBreakdown, Money } from '../../transaction';
 import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE, PAYMENTSTATUS } from '../provider-capability';
 /**
@@ -256,7 +256,7 @@ export interface NormalizedPaymentRequest<TMetadata extends object = object> {
     /** Payment method */
     method: PAYMENTMETHOD;
     /** CurrencyCode */
-    CurrencyCode: typeof CURRENCY_CODES;
+    CurrencyCode: CurrencyCode;
     /** User initiating the transaction */
     userId: string;
     /** Product or service being purchased */
@@ -288,7 +288,7 @@ export interface TransactionDetails<TMetadata extends object = object> {
     /** Payment method used */
     method: PAYMENTMETHOD;
     /** CurrencyCode of the transaction */
-    CurrencyCode: typeof CURRENCY_CODES;
+    CurrencyCode: CurrencyCode;
     /** Timestamp when transaction was created */
     createdAt: Date;
     /** Timestamp of the latest status update */
@@ -329,7 +329,7 @@ export interface AdapterConfiguration<TMetadata extends object = object> {
     };
     /** Supported payment methods and currencies */
     supportedMethods: PAYMENTMETHOD[];
-    supportedCurrencies: (typeof CURRENCY_CODES)[];
+    supportedCurrencies: CurrencyCode[];
     /** Additional configuration or metadata */
     metadata?: TMetadata;
 }
@@ -383,7 +383,7 @@ export interface PayoutParams<TMetadata extends object = object> {
     /** Amount to pay out */
     amount: Money;
     /** CurrencyCode of payout */
-    CurrencyCode: typeof CURRENCY_CODES;
+    CurrencyCode: CurrencyCode;
     /** Optional bank account / wallet ID at provider */
     destinationId?: string;
     /** Optional description */
@@ -415,7 +415,7 @@ export interface ReceiptData<TMetadata extends object = object> {
     receiptId: string;
     issuedAt: Date;
     amount: Money;
-    CurrencyCode: typeof CURRENCY_CODES;
+    CurrencyCode: CurrencyCode;
     lineItems?: Array<{
         name: string;
         quantity: number;

package/dist/payments/provider/payment-provider/types.d.ts

@@ -4,7 +4,7 @@ import type { PaymentResult, ProcessPaymentRequest } from '../../request';
 import type { FeeBreakdown, Money } from '../../transaction';
 import type { CreateCustomerParams, CustomerResult, FeeCalculationOptions, PaymentStatusResult, RefundParams, RefundResult, SavedPaymentMethodResult, SavePaymentMethodParams, TransactionHistory, TransactionHistoryParams, WebhookPayload, WebhookResult } from '../core';
 import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE } from '../provider-capability';
-import type { CURRENCY_CODES } from '@plyaz/config';
+import type { CurrencyCode } from '@plyaz/config';
 /**
  * Core interface that all payment providers must implement.
  * This interface ensures consistent behavior across all providers
@@ -22,7 +22,7 @@ export interface PaymentProvider {
     /** Payment methods supported by this provider */
     readonly supportedMethods: PAYMENTMETHOD[];
     /** Currencies supported by this provider */
-    readonly supportedCurrencies: typeof CURRENCY_CODES[];
+    readonly supportedCurrencies: CurrencyCode[];
     /** Detailed capabilities of this provider */
     readonly capabilities: ProviderCapabilities;
     /** Provider configuration and metadata */

package/dist/payments/transaction/types.d.ts

@@ -1,4 +1,4 @@
-import type { CURRENCY_CODES } from '@plyaz/config';
+import type { CurrencyCode } from '@plyaz/config';
 /**
  * Core money interface for handling monetary values throughout the system.
  * All monetary amounts are stored in the smallest currency unit to avoid
@@ -20,7 +20,7 @@ export interface Money {
      * Currency code following ISO 4217 standard for fiat currencies
      * and custom codes for cryptocurrencies (BTC, ETH, etc.)
      */
-    currency: typeof CURRENCY_CODES;
+    currency: CurrencyCode;
     /**
      * Human-readable formatted amount for display purposes
      * Example: "$50.00", "€45.50", "0.001 BTC"
@@ -35,7 +35,7 @@ export interface Money {
      * Original currency if this amount was converted
      * Helps with audit trails and reconciliation
      */
-    originalCurrency?: typeof CURRENCY_CODES;
+    originalCurrency?: CurrencyCode;
     /**
      * Timestamp when exchange rate was calculated
      * Important for cryptocurrency and volatile currency exchanges

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.13.14",
+  "version": "1.13.15",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",
@@ -192,6 +192,7 @@
   "keywords": [],
   "packageManager": "pnpm@10.11.0",
   "dependencies": {
+    "@plyaz/config": "^1.7.3",
     "pino": "^10.0.0",
     "type-fest": "^4.41.0",
     "zustand": "^5.0.0"
@@ -204,7 +205,6 @@
     "@eslint/markdown": "^6.5.0",
     "@nestjs/common": "^11.1.7",
     "@next/eslint-plugin-next": "^15.0.3",
-    "@plyaz/config": "^1.6.5",
     "@plyaz/devtools": "^1.9.4",
     "@tanstack/react-query": "5.85.6",
     "@testing-library/react": "^16.3.0",