@plyaz/types 1.16.7 → 1.16.9

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

@@ -5,6 +5,17 @@ import type { PROVIDER_PRODUCT_STATUS } from './enums';
  * Billing cycle for subscription or recurring payments
  */
 export type BillingCycle = 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'one-time';
+export type Interval = 'day' | 'week' | 'month' | 'year';
+export interface CustomInterval {
+    /** Stripe-compatible interval (for fixed intervals) */
+    interval?: Interval;
+    /** Number of intervals (for fixed intervals) */
+    interval_count?: number;
+    /** Custom start date (optional) */
+    startDate?: Date;
+    /** Custom end date (optional) */
+    endDate?: Date;
+}
 /**
  * Parameters to create a new product in the payment provider
  */

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

@@ -353,20 +353,40 @@ export interface SavedPaymentMethod<TMetadata extends object = object> {
 export interface CreateSubscriptionParams<TMetadata extends object = object> {
     /** Plyaz user ID (Stripe customer ID or your internal user ID mapped to Stripe) */
     userId: string;
+    /** Selected payment method from supported options */
+    paymentMethod: PAYMENT_METHOD;
+    /**
+     * Optional provider override for advanced use cases
+     * If not specified, optimal provider will be auto-selected
+     */
+    provider?: PAYMENT_PROVIDER_TYPE;
     /** Plan to subscribe the user to (internal plan name) */
     plan: string;
-    /** Stripe Price ID for the subscription */
+    /** Product pricing */
     priceId: string;
-    /** Optional payment method ID (for existing customers) */
-    paymentMethodId?: string;
     /** Optional trial period in days */
     trialDays?: number;
-    /** URL to redirect after successful checkout */
-    successUrl: string;
-    /** URL to redirect after canceled checkout */
-    cancelUrl: string;
+    /** URL to redirect user after successful payment completion */
+    returnUrl?: string;
+    /** URL to redirect user after payment cancellation */
+    cancelUrl?: string;
+    /**
+     * Idempotency key to prevent duplicate payment processing
+     * Should be unique per payment attempt, recommended: UUID v4
+     */
+    idempotencyKey?: string;
     /** Optional metadata for additional info */
-    metadata?: TMetadata;
+    metadata?: {
+        /** Geographic and device information */
+        geoInfo?: {
+            country: string;
+            region?: string;
+            city?: string;
+            timezone?: string;
+        };
+        /** Custom metadata fields */
+        custom?: TMetadata;
+    };
 }
 export interface SubscriptionResult<TMetadata extends object = object> {
     /** Checkout session URL for user to complete subscription */

package/package.json

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