@zendfi/sdk 0.2.0 → 0.3.0

package/dist/express.d.mts

@@ -1,4 +1,4 @@
-import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-BIze3Qop.mjs';
+import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-DG-zic8m.mjs';
 
 /**
  * Express Webhook Handler

package/dist/express.d.ts

@@ -1,4 +1,4 @@
-import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-BIze3Qop.js';
+import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-DG-zic8m.js';
 
 /**
  * Express Webhook Handler

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { Z as ZendFiConfig, C as CreatePaymentRequest, P as Payment, L as ListPaymentsRequest, b as PaginatedResponse, c as CreateSubscriptionPlanRequest, S as SubscriptionPlan, d as CreateSubscriptionRequest, e as Subscription, f as CreatePaymentLinkRequest, g as PaymentLink, h as CreateInstallmentPlanRequest, I as InstallmentPlan, i as CreateEscrowRequest, E as Escrow, A as ApproveEscrowRequest, R as RefundEscrowRequest, D as DisputeEscrowRequest, j as CreateInvoiceRequest, k as Invoice, V as VerifyWebhookRequest, l as WebhookPayload } from './webhook-handler-BIze3Qop.mjs';
-export { F as AuthenticationError, K as CreateInstallmentPlanResponse, q as Currency, o as Environment, v as EscrowStatus, u as InstallmentPlanStatus, J as InstallmentScheduleItem, O as InvoiceLineItem, w as InvoiceStatus, N as NetworkError, s as PaymentStatus, r as PaymentToken, H as RateLimitError, M as ReleaseCondition, z as SplitRecipient, x as SplitStatus, t as SubscriptionStatus, G as ValidationError, y as WebhookEvent, n as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, m as WebhookResult, B as ZendFiError, p as processWebhook } from './webhook-handler-BIze3Qop.mjs';
+import { Z as ZendFiConfig, C as CreatePaymentRequest, P as Payment, L as ListPaymentsRequest, b as PaginatedResponse, c as CreateSubscriptionPlanRequest, S as SubscriptionPlan, d as CreateSubscriptionRequest, e as Subscription, f as CreatePaymentLinkRequest, g as PaymentLink, h as CreateInstallmentPlanRequest, I as InstallmentPlan, i as CreateEscrowRequest, E as Escrow, A as ApproveEscrowRequest, R as RefundEscrowRequest, D as DisputeEscrowRequest, j as CreateInvoiceRequest, k as Invoice, V as VerifyWebhookRequest, l as WebhookPayload } from './webhook-handler-DG-zic8m.mjs';
+export { q as ApiKeyMode, G as AuthenticationError, M as CreateInstallmentPlanResponse, r as Currency, o as Environment, w as EscrowStatus, v as InstallmentPlanStatus, K as InstallmentScheduleItem, Q as InvoiceLineItem, x as InvoiceStatus, N as NetworkError, t as PaymentStatus, s as PaymentToken, J as RateLimitError, O as ReleaseCondition, B as SplitRecipient, y as SplitStatus, u as SubscriptionStatus, H as ValidationError, z as WebhookEvent, n as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, m as WebhookResult, F as ZendFiError, p as processWebhook } from './webhook-handler-DG-zic8m.mjs';
 
 /**
  * ZendFi SDK Client.
@@ -196,6 +196,10 @@ declare class ConfigLoader {
      * Load configuration from various sources
      */
     static load(options?: Partial<ZendFiConfig>): Required<ZendFiConfig>;
+    /**
+     * Detect mode (test/live) from API key prefix
+     */
+    private static detectMode;
     /**
      * Detect environment based on various signals
      */
@@ -206,6 +210,8 @@ declare class ConfigLoader {
     private static loadApiKey;
     /**
      * Get base URL for API
+     * Note: Both test and live modes use the same API endpoint.
+     * The backend routes requests to devnet or mainnet based on API key prefix.
      */
     private static getBaseURL;
     /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Z as ZendFiConfig, C as CreatePaymentRequest, P as Payment, L as ListPaymentsRequest, b as PaginatedResponse, c as CreateSubscriptionPlanRequest, S as SubscriptionPlan, d as CreateSubscriptionRequest, e as Subscription, f as CreatePaymentLinkRequest, g as PaymentLink, h as CreateInstallmentPlanRequest, I as InstallmentPlan, i as CreateEscrowRequest, E as Escrow, A as ApproveEscrowRequest, R as RefundEscrowRequest, D as DisputeEscrowRequest, j as CreateInvoiceRequest, k as Invoice, V as VerifyWebhookRequest, l as WebhookPayload } from './webhook-handler-BIze3Qop.js';
-export { F as AuthenticationError, K as CreateInstallmentPlanResponse, q as Currency, o as Environment, v as EscrowStatus, u as InstallmentPlanStatus, J as InstallmentScheduleItem, O as InvoiceLineItem, w as InvoiceStatus, N as NetworkError, s as PaymentStatus, r as PaymentToken, H as RateLimitError, M as ReleaseCondition, z as SplitRecipient, x as SplitStatus, t as SubscriptionStatus, G as ValidationError, y as WebhookEvent, n as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, m as WebhookResult, B as ZendFiError, p as processWebhook } from './webhook-handler-BIze3Qop.js';
+import { Z as ZendFiConfig, C as CreatePaymentRequest, P as Payment, L as ListPaymentsRequest, b as PaginatedResponse, c as CreateSubscriptionPlanRequest, S as SubscriptionPlan, d as CreateSubscriptionRequest, e as Subscription, f as CreatePaymentLinkRequest, g as PaymentLink, h as CreateInstallmentPlanRequest, I as InstallmentPlan, i as CreateEscrowRequest, E as Escrow, A as ApproveEscrowRequest, R as RefundEscrowRequest, D as DisputeEscrowRequest, j as CreateInvoiceRequest, k as Invoice, V as VerifyWebhookRequest, l as WebhookPayload } from './webhook-handler-DG-zic8m.js';
+export { q as ApiKeyMode, G as AuthenticationError, M as CreateInstallmentPlanResponse, r as Currency, o as Environment, w as EscrowStatus, v as InstallmentPlanStatus, K as InstallmentScheduleItem, Q as InvoiceLineItem, x as InvoiceStatus, N as NetworkError, t as PaymentStatus, s as PaymentToken, J as RateLimitError, O as ReleaseCondition, B as SplitRecipient, y as SplitStatus, u as SubscriptionStatus, H as ValidationError, z as WebhookEvent, n as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, m as WebhookResult, F as ZendFiError, p as processWebhook } from './webhook-handler-DG-zic8m.js';
 
 /**
  * ZendFi SDK Client.
@@ -196,6 +196,10 @@ declare class ConfigLoader {
      * Load configuration from various sources
      */
     static load(options?: Partial<ZendFiConfig>): Required<ZendFiConfig>;
+    /**
+     * Detect mode (test/live) from API key prefix
+     */
+    private static detectMode;
     /**
      * Detect environment based on various signals
      */
@@ -206,6 +210,8 @@ declare class ConfigLoader {
     private static loadApiKey;
     /**
      * Get base URL for API
+     * Note: Both test and live modes use the same API endpoint.
+     * The backend routes requests to devnet or mainnet based on API key prefix.
      */
     private static getBaseURL;
     /**

package/dist/index.js

@@ -92,16 +92,30 @@ var ConfigLoader = class {
   static load(options) {
     const environment = this.detectEnvironment();
     const apiKey = this.loadApiKey(options?.apiKey);
-    const baseURL = this.getBaseURL(environment, options?.baseURL);
+    const mode = this.detectMode(apiKey);
+    const baseURL = this.getBaseURL(environment, mode, options?.baseURL);
     return {
       apiKey,
       baseURL,
       environment,
+      mode,
       timeout: options?.timeout ?? 3e4,
       retries: options?.retries ?? 3,
       idempotencyEnabled: options?.idempotencyEnabled ?? true
     };
   }
+  /**
+   * Detect mode (test/live) from API key prefix
+   */
+  static detectMode(apiKey) {
+    if (apiKey.startsWith("zfi_test_")) {
+      return "test";
+    }
+    if (apiKey.startsWith("zfi_live_")) {
+      return "live";
+    }
+    return "live";
+  }
   /**
    * Detect environment based on various signals
    */
@@ -150,8 +164,10 @@ var ConfigLoader = class {
   }
   /**
    * Get base URL for API
+   * Note: Both test and live modes use the same API endpoint.
+   * The backend routes requests to devnet or mainnet based on API key prefix.
    */
-  static getBaseURL(_environment, explicitURL) {
+  static getBaseURL(_environment, _mode, explicitURL) {
     if (explicitURL) return explicitURL;
     return process.env.ZENDFI_API_URL || "https://api.zendfi.tech";
   }
@@ -183,13 +199,17 @@ var ConfigLoader = class {
         'Invalid API key format. ZendFi API keys should start with "zfi_test_" or "zfi_live_"'
       );
     }
-    if (apiKey.startsWith("zfi_live_")) {
-      const env = this.detectEnvironment();
-      if (env === "development") {
-        console.warn(
-          "\u26A0\uFE0F  Warning: Using a live API key (zfi_live_) in development environment. This will create real transactions. Use a test key (zfi_test_) for development."
-        );
-      }
+    const mode = this.detectMode(apiKey);
+    const env = this.detectEnvironment();
+    if (mode === "live" && env === "development") {
+      console.warn(
+        "\u26A0\uFE0F  Warning: Using a live API key (zfi_live_) in development environment. This will create real mainnet transactions. Use a test key (zfi_test_) for devnet testing."
+      );
+    }
+    if (mode === "test" && env === "production") {
+      console.warn(
+        "\u26A0\uFE0F  Warning: Using a test API key (zfi_test_) in production environment. This will create devnet transactions only. Use a live key (zfi_live_) for mainnet."
+      );
     }
   }
 };
@@ -230,6 +250,11 @@ var ZendFiClient = class {
   constructor(options) {
     this.config = ConfigLoader.load(options);
     ConfigLoader.validateApiKey(this.config.apiKey);
+    if (this.config.environment === "development") {
+      console.log(
+        `\u2713 ZendFi SDK initialized in ${this.config.mode} mode (${this.config.mode === "test" ? "devnet" : "mainnet"})`
+      );
+    }
   }
   /**
    * Create a new payment

package/dist/index.mjs

@@ -50,16 +50,30 @@ var ConfigLoader = class {
   static load(options) {
     const environment = this.detectEnvironment();
     const apiKey = this.loadApiKey(options?.apiKey);
-    const baseURL = this.getBaseURL(environment, options?.baseURL);
+    const mode = this.detectMode(apiKey);
+    const baseURL = this.getBaseURL(environment, mode, options?.baseURL);
     return {
       apiKey,
       baseURL,
       environment,
+      mode,
       timeout: options?.timeout ?? 3e4,
       retries: options?.retries ?? 3,
       idempotencyEnabled: options?.idempotencyEnabled ?? true
     };
   }
+  /**
+   * Detect mode (test/live) from API key prefix
+   */
+  static detectMode(apiKey) {
+    if (apiKey.startsWith("zfi_test_")) {
+      return "test";
+    }
+    if (apiKey.startsWith("zfi_live_")) {
+      return "live";
+    }
+    return "live";
+  }
   /**
    * Detect environment based on various signals
    */
@@ -108,8 +122,10 @@ var ConfigLoader = class {
   }
   /**
    * Get base URL for API
+   * Note: Both test and live modes use the same API endpoint.
+   * The backend routes requests to devnet or mainnet based on API key prefix.
    */
-  static getBaseURL(_environment, explicitURL) {
+  static getBaseURL(_environment, _mode, explicitURL) {
     if (explicitURL) return explicitURL;
     return process.env.ZENDFI_API_URL || "https://api.zendfi.tech";
   }
@@ -141,13 +157,17 @@ var ConfigLoader = class {
         'Invalid API key format. ZendFi API keys should start with "zfi_test_" or "zfi_live_"'
       );
     }
-    if (apiKey.startsWith("zfi_live_")) {
-      const env = this.detectEnvironment();
-      if (env === "development") {
-        console.warn(
-          "\u26A0\uFE0F  Warning: Using a live API key (zfi_live_) in development environment. This will create real transactions. Use a test key (zfi_test_) for development."
-        );
-      }
+    const mode = this.detectMode(apiKey);
+    const env = this.detectEnvironment();
+    if (mode === "live" && env === "development") {
+      console.warn(
+        "\u26A0\uFE0F  Warning: Using a live API key (zfi_live_) in development environment. This will create real mainnet transactions. Use a test key (zfi_test_) for devnet testing."
+      );
+    }
+    if (mode === "test" && env === "production") {
+      console.warn(
+        "\u26A0\uFE0F  Warning: Using a test API key (zfi_test_) in production environment. This will create devnet transactions only. Use a live key (zfi_live_) for mainnet."
+      );
     }
   }
 };
@@ -188,6 +208,11 @@ var ZendFiClient = class {
   constructor(options) {
     this.config = ConfigLoader.load(options);
     ConfigLoader.validateApiKey(this.config.apiKey);
+    if (this.config.environment === "development") {
+      console.log(
+        `\u2713 ZendFi SDK initialized in ${this.config.mode} mode (${this.config.mode === "test" ? "devnet" : "mainnet"})`
+      );
+    }
   }
   /**
    * Create a new payment

package/dist/nextjs.d.mts

@@ -1,4 +1,4 @@
-import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-BIze3Qop.mjs';
+import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-DG-zic8m.mjs';
 
 /**
  * Next.js Webhook Handler for App Router

package/dist/nextjs.d.ts

@@ -1,4 +1,4 @@
-import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-BIze3Qop.js';
+import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-DG-zic8m.js';
 
 /**
  * Next.js Webhook Handler for App Router

package/dist/{webhook-handler-BIze3Qop.d.mts → webhook-handler-DG-zic8m.d.mts}

@@ -3,6 +3,7 @@
  * Complete type definitions for the ZendFi API
  */
 type Environment = 'development' | 'staging' | 'production';
+type ApiKeyMode = 'test' | 'live';
 type Currency = 'USD' | 'EUR' | 'GBP';
 type PaymentToken = 'SOL' | 'USDC' | 'USDT';
 type PaymentStatus = 'pending' | 'confirmed' | 'failed' | 'expired';
@@ -16,6 +17,7 @@ interface ZendFiConfig {
     apiKey?: string;
     baseURL?: string;
     environment?: Environment;
+    mode?: ApiKeyMode;
     timeout?: number;
     retries?: number;
     idempotencyEnabled?: boolean;
@@ -385,4 +387,4 @@ interface WebhookResult {
 }
 declare function processWebhook(a: any, b?: any, c?: any): Promise<WebhookResult>;
 
-export { type ApproveEscrowRequest as A, ZendFiError as B, type CreatePaymentRequest as C, type DisputeEscrowRequest as D, type Escrow as E, AuthenticationError as F, ValidationError as G, RateLimitError as H, type InstallmentPlan as I, type InstallmentScheduleItem as J, type CreateInstallmentPlanResponse as K, type ListPaymentsRequest as L, type ReleaseCondition as M, NetworkError as N, type InvoiceLineItem as O, type Payment as P, type RefundEscrowRequest as R, type SubscriptionPlan as S, type VerifyWebhookRequest as V, type WebhookHandlerConfig as W, type ZendFiConfig as Z, type WebhookHandlers as a, type PaginatedResponse as b, type CreateSubscriptionPlanRequest as c, type CreateSubscriptionRequest as d, type Subscription as e, type CreatePaymentLinkRequest as f, type PaymentLink as g, type CreateInstallmentPlanRequest as h, type CreateEscrowRequest as i, type CreateInvoiceRequest as j, type Invoice as k, type WebhookPayload as l, type WebhookResult as m, type WebhookEventHandler as n, type Environment as o, processWebhook as p, type Currency as q, type PaymentToken as r, type PaymentStatus as s, type SubscriptionStatus as t, type InstallmentPlanStatus as u, type EscrowStatus as v, type InvoiceStatus as w, type SplitStatus as x, type WebhookEvent as y, type SplitRecipient as z };
+export { type ApproveEscrowRequest as A, type SplitRecipient as B, type CreatePaymentRequest as C, type DisputeEscrowRequest as D, type Escrow as E, ZendFiError as F, AuthenticationError as G, ValidationError as H, type InstallmentPlan as I, RateLimitError as J, type InstallmentScheduleItem as K, type ListPaymentsRequest as L, type CreateInstallmentPlanResponse as M, NetworkError as N, type ReleaseCondition as O, type Payment as P, type InvoiceLineItem as Q, type RefundEscrowRequest as R, type SubscriptionPlan as S, type VerifyWebhookRequest as V, type WebhookHandlerConfig as W, type ZendFiConfig as Z, type WebhookHandlers as a, type PaginatedResponse as b, type CreateSubscriptionPlanRequest as c, type CreateSubscriptionRequest as d, type Subscription as e, type CreatePaymentLinkRequest as f, type PaymentLink as g, type CreateInstallmentPlanRequest as h, type CreateEscrowRequest as i, type CreateInvoiceRequest as j, type Invoice as k, type WebhookPayload as l, type WebhookResult as m, type WebhookEventHandler as n, type Environment as o, processWebhook as p, type ApiKeyMode as q, type Currency as r, type PaymentToken as s, type PaymentStatus as t, type SubscriptionStatus as u, type InstallmentPlanStatus as v, type EscrowStatus as w, type InvoiceStatus as x, type SplitStatus as y, type WebhookEvent as z };

package/dist/{webhook-handler-BIze3Qop.d.ts → webhook-handler-DG-zic8m.d.ts}

@@ -3,6 +3,7 @@
  * Complete type definitions for the ZendFi API
  */
 type Environment = 'development' | 'staging' | 'production';
+type ApiKeyMode = 'test' | 'live';
 type Currency = 'USD' | 'EUR' | 'GBP';
 type PaymentToken = 'SOL' | 'USDC' | 'USDT';
 type PaymentStatus = 'pending' | 'confirmed' | 'failed' | 'expired';
@@ -16,6 +17,7 @@ interface ZendFiConfig {
     apiKey?: string;
     baseURL?: string;
     environment?: Environment;
+    mode?: ApiKeyMode;
     timeout?: number;
     retries?: number;
     idempotencyEnabled?: boolean;
@@ -385,4 +387,4 @@ interface WebhookResult {
 }
 declare function processWebhook(a: any, b?: any, c?: any): Promise<WebhookResult>;
 
-export { type ApproveEscrowRequest as A, ZendFiError as B, type CreatePaymentRequest as C, type DisputeEscrowRequest as D, type Escrow as E, AuthenticationError as F, ValidationError as G, RateLimitError as H, type InstallmentPlan as I, type InstallmentScheduleItem as J, type CreateInstallmentPlanResponse as K, type ListPaymentsRequest as L, type ReleaseCondition as M, NetworkError as N, type InvoiceLineItem as O, type Payment as P, type RefundEscrowRequest as R, type SubscriptionPlan as S, type VerifyWebhookRequest as V, type WebhookHandlerConfig as W, type ZendFiConfig as Z, type WebhookHandlers as a, type PaginatedResponse as b, type CreateSubscriptionPlanRequest as c, type CreateSubscriptionRequest as d, type Subscription as e, type CreatePaymentLinkRequest as f, type PaymentLink as g, type CreateInstallmentPlanRequest as h, type CreateEscrowRequest as i, type CreateInvoiceRequest as j, type Invoice as k, type WebhookPayload as l, type WebhookResult as m, type WebhookEventHandler as n, type Environment as o, processWebhook as p, type Currency as q, type PaymentToken as r, type PaymentStatus as s, type SubscriptionStatus as t, type InstallmentPlanStatus as u, type EscrowStatus as v, type InvoiceStatus as w, type SplitStatus as x, type WebhookEvent as y, type SplitRecipient as z };
+export { type ApproveEscrowRequest as A, type SplitRecipient as B, type CreatePaymentRequest as C, type DisputeEscrowRequest as D, type Escrow as E, ZendFiError as F, AuthenticationError as G, ValidationError as H, type InstallmentPlan as I, RateLimitError as J, type InstallmentScheduleItem as K, type ListPaymentsRequest as L, type CreateInstallmentPlanResponse as M, NetworkError as N, type ReleaseCondition as O, type Payment as P, type InvoiceLineItem as Q, type RefundEscrowRequest as R, type SubscriptionPlan as S, type VerifyWebhookRequest as V, type WebhookHandlerConfig as W, type ZendFiConfig as Z, type WebhookHandlers as a, type PaginatedResponse as b, type CreateSubscriptionPlanRequest as c, type CreateSubscriptionRequest as d, type Subscription as e, type CreatePaymentLinkRequest as f, type PaymentLink as g, type CreateInstallmentPlanRequest as h, type CreateEscrowRequest as i, type CreateInvoiceRequest as j, type Invoice as k, type WebhookPayload as l, type WebhookResult as m, type WebhookEventHandler as n, type Environment as o, processWebhook as p, type ApiKeyMode as q, type Currency as r, type PaymentToken as s, type PaymentStatus as t, type SubscriptionStatus as u, type InstallmentPlanStatus as v, type EscrowStatus as w, type InvoiceStatus as x, type SplitStatus as y, type WebhookEvent as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zendfi/sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zero-config TypeScript SDK for ZendFi crypto payments",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",