@plyaz/types 1.12.0 → 1.12.2

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

@@ -1,8 +1,9 @@
 import type { ProviderHealthStatus } from '../../../features';
 import type { CURRENCY } from '../../currency';
-import type { PaymentResult } from '../../request';
+import type { BaseProviderConfig } from '../../gateways';
+import type { PaymentResult, ProcessPaymentRequest } from '../../request';
 import type { FeeBreakdown, Money } from '../../transaction';
-import type { AdapterConfiguration, CreateCustomerParams, CreatePaymentParams, CreateSubscriptionParams, CustomerResult, FeeCalculationOptions, FeeStructure, PaymentProviderConfig, PaymentStatusResult, PayoutParams, PayoutResult, RefundParams, RefundResult, SavedPaymentMethod, SavedPaymentMethodResult, SavePaymentMethodParams, SubscriptionResult, TransactionDetails, TransactionHistory, TransactionHistoryParams, WebhookPayload, WebhookResult } from '../core';
+import type { AdapterConfiguration, CreateCustomerParams, CreateSubscriptionParams, CustomerResult, FeeCalculationOptions, FeeStructure, PaymentStatusResult, PayoutParams, PayoutResult, RefundParams, RefundResult, SavedPaymentMethod, SavedPaymentMethodResult, SavePaymentMethodParams, SubscriptionResult, TransactionDetails, TransactionHistory, TransactionHistoryParams, WebhookPayload, WebhookResult } from '../core';
 import type { ProviderCapabilities, ProviderConfiguration } from '../payment-provider';
 import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE } from '../provider-capability';
 /**
@@ -41,7 +42,7 @@ export interface PaymentAdapter {
      * @throws ProviderConfigurationError if configuration is invalid
      * @throws ProviderConnectionError if unable to connect to provider
      */
-    initialize(config: PaymentProviderConfig): Promise<void>;
+    initialize(config: BaseProviderConfig): Promise<void>;
     /**
      * Shutdown the provider and clean up resources.
      * This method should:
@@ -67,7 +68,7 @@ export interface PaymentAdapter {
      * @throws PaymentValidationError for invalid parameters
      * @throws PaymentProcessingError for provider errors
      */
-    createPayment(params: CreatePaymentParams): Promise<PaymentResult>;
+    createPayment(params: ProcessPaymentRequest): Promise<PaymentResult>;
     /**
      * Capture a previously authorized payment (if supported)
      * Used in two-step payment flows

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

@@ -1,87 +1,6 @@
 import type { CURRENCY } from '../../currency';
 import type { FeeBreakdown, Money } from '../../transaction';
 import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE, PAYMENTSTATUS } from '../provider-capability';
-/**
- * High-level configuration for initializing a payment provider.
- *
- * This configuration is passed to the provider adapter during initialization.
- * It must contain everything required to:
- * - Authenticate with the provider
- * - Configure operational behavior
- * - Enable webhook verification
- * - Support different environments (sandbox, production, etc.)
- */
-export interface PaymentProviderConfig<TExtra extends object = object, TCustomHeaders extends Record<string, string> = Record<string, string>> {
-    /** Provider type identifier (e.g., stripe, paypal) */
-    provider: PAYMENTPROVIDERTYPE;
-    /** Primary authentication */
-    apiKey?: string;
-    secretKey?: string;
-    /** For Stripe client-side integrations */
-    publishableKey?: string;
-    /** Optional merchant/account identifiers */
-    merchantId?: string;
-    accountId?: string;
-    /** Optional API version pinning */
-    apiVersion?: string;
-    /** Environment */
-    environment: 'sandbox' | 'staging' | 'production';
-    apiBaseUrl?: string;
-    /** Currency and region support */
-    supportedCurrencies?: CURRENCY[];
-    supportedRegions?: string[];
-    /** Webhook configuration */
-    webhook?: {
-        url: string;
-        secret?: string;
-        /** Support multiple webhook endpoints if needed */
-        secrets?: Record<string, string>;
-        events?: string[];
-        tolerance?: number;
-    };
-    /** Request config */
-    requestTimeout?: number;
-    retryPolicy?: {
-        maxRetries: number;
-        backoffMs: number;
-    };
-    /** Debug and advanced options */
-    debug?: boolean;
-    customHeaders?: TCustomHeaders;
-    extra?: TExtra;
-    /** Optional secondary credentials (e.g., key rotation) */
-    secondaryCredentials?: {
-        apiKey?: string;
-        secretKey?: string;
-    };
-}
-/**
- * Core parameters for initiating a payment transaction with any provider.
- * This type is **provider-agnostic** and later normalized/translated
- * inside the provider adapter.
- */
-export interface CreatePaymentParams<TMetadata extends object = object> {
-    /** Amount to be charged, always in smallest currency unit */
-    amount: Money;
-    /** Payment method selected for this transaction */
-    method: PAYMENTMETHOD;
-    /** Currency of the transaction */
-    currency: CURRENCY;
-    /** Unique identifier for the user initiating the transaction */
-    userId: string;
-    /** Product or service being paid for */
-    productId: string;
-    /** Description for statement or receipt */
-    description?: string;
-    /** URL to redirect user after successful payment */
-    returnUrl?: string;
-    /** URL to redirect user after failed/cancelled payment */
-    cancelUrl?: string;
-    /** Optional idempotency key to prevent duplicate charges */
-    idempotencyKey?: string;
-    /** Additional metadata (campaign, subscription, geo info, etc.) */
-    metadata?: TMetadata;
-}
 /**
  * Parameters required to initiate a refund.
  * Refunds can be full or partial.

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

@@ -1,8 +1,9 @@
 import type { ProviderHealthStatus } from '../../../features';
 import type { CURRENCY } from '../../currency';
+import type { BaseProviderConfig } from '../../gateways';
 import type { PaymentResult, ProcessPaymentRequest } from '../../request';
 import type { FeeBreakdown, Money } from '../../transaction';
-import type { CreateCustomerParams, CustomerResult, FeeCalculationOptions, PaymentProviderConfig, PaymentStatusResult, RefundParams, RefundResult, SavedPaymentMethodResult, SavePaymentMethodParams, TransactionHistory, TransactionHistoryParams, WebhookPayload, WebhookResult } from '../core';
+import type { CreateCustomerParams, CustomerResult, FeeCalculationOptions, PaymentStatusResult, RefundParams, RefundResult, SavedPaymentMethodResult, SavePaymentMethodParams, TransactionHistory, TransactionHistoryParams, WebhookPayload, WebhookResult } from '../core';
 import type { PAYMENTMETHOD, PAYMENTPROVIDERTYPE } from '../provider-capability';
 /**
  * Core interface that all payment providers must implement.
@@ -38,7 +39,7 @@ export interface PaymentProvider {
      * @throws ProviderConfigurationError if configuration is invalid
      * @throws ProviderConnectionError if unable to connect to provider
      */
-    initialize(config: PaymentProviderConfig): Promise<void>;
+    initialize(config: BaseProviderConfig): Promise<void>;
     /**
      * Shutdown the provider and clean up resources.
      * This method should:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.12.0",
+  "version": "1.12.2",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",

package/dist/auth/config/index.d.ts

@@ -1 +0,0 @@
-export type * from './types';

package/dist/auth/config/types.d.ts

@@ -1,67 +0,0 @@
-import type { UserContext, AuthCredentials } from '../types';
-/**
- * @plyaz/auth/providers/base/auth-service-provider.interface
- * The contract for all external authentication service adapters (Supabase, Internal DB, etc.).
- * This ensures our strategies remain vendor-agnostic.
- */
-export interface AuthServiceProvider {
-    /**
-     * Synchronizes an external user ID (e.g., from Clerk or Web3) with the internal RLS database.
-     * This method ensures the user exists internally and issues an RLS token.
-     * * @param externalId The unique ID from the external provider (e.g., Clerk's 'sub').
-     * @param email The user's primary email address.
-     * @returns An object containing the internal UserContext and the RLS JWT.
-     */
-    syncUserFromExternalToken(externalId: string, email: string): Promise<{
-        user: UserContext;
-        supabaseRlsToken: string;
-    }>;
-    /** Handles traditional login via email/password (used as a fallback or if Clerk is bypassed). */
-    authenticate(credentials: AuthCredentials): Promise<UserContext>;
-    /** Registers a new user with the provider. */
-    register(credentials: AuthCredentials): Promise<UserContext>;
-    /** Retrieves basic user profile information by internal ID. */
-    getUserById(userId: string): Promise<UserContext | null>;
-    /** Requests a password reset (only relevant for traditional auth flows). */
-    requestPasswordReset(email: string): Promise<void>;
-}
-/**
- * The contract for all external OAuth authentication providers (Google, GitHub, etc.).
- * This interface ensures our strategies remain vendor-agnostic and defines
- * the core functionality required to authenticate with an OAuth service.
- */
-export interface OAuthProvider {
-    /**
-     * Generates the URL to redirect the user to for authentication.
-     * This URL will typically include a client ID, redirect URI, and scopes.
-     * @param redirectUrl The URL to which the user will be redirected after authentication.
-     * @returns The full URL for the OAuth login page.
-     */
-    getRedirectUrl(redirectUrl: string): string;
-    /**
-     * Exchanges an authorization code for an access token and user information.
-     * This method is called after the user has successfully authenticated with the provider.
-     * @param code The authorization code received from the OAuth provider.
-     * @returns A promise that resolves to the user's details and a refresh token.
-     */
-    exchangeCodeForToken(code: string): Promise<{
-        accessToken: string;
-        refreshToken: string;
-        expiresIn: number;
-        user: {
-            providerId: string;
-            email: string;
-            name?: string;
-            profileImageUrl?: string;
-        };
-    }>;
-    /**
-     * (Optional) Refreshes an access token using a refresh token.
-     * @param refreshToken The refresh token provided by the provider.
-     * @returns A new access token and its expiration time.
-     */
-    refreshToken?(refreshToken: string): Promise<{
-        accessToken: string;
-        expiresIn: number;
-    }>;
-}