@djangocfg/ext-payments 1.0.9 → 1.0.11

package/dist/config.cjs

@@ -27,7 +27,7 @@ var import_ext_base = require("@djangocfg/ext-base");
 // package.json
 var package_default = {
   name: "@djangocfg/ext-payments",
-  version: "1.0.9",
+  version: "1.0.11",
   description: "Payments system extension for DjangoCFG",
   keywords: [
     "django",

package/dist/config.js

@@ -4,7 +4,7 @@ import { createExtensionConfig } from "@djangocfg/ext-base";
 // package.json
 var package_default = {
   name: "@djangocfg/ext-payments",
-  version: "1.0.9",
+  version: "1.0.11",
   description: "Payments system extension for DjangoCFG",
   keywords: [
     "django",

package/dist/hooks.cjs

@@ -129,7 +129,7 @@ var models_exports = {};
 // src/api/generated/ext_payments/http.ts
 var FetchAdapter = class {
   async request(request) {
-    const { method, url, headers, body, params, formData } = request;
+    const { method, url, headers, body, params, formData, binaryBody } = request;
     let finalUrl = url;
     if (params) {
       const searchParams = new URLSearchParams();
@@ -147,6 +147,9 @@ var FetchAdapter = class {
     let requestBody;
     if (formData) {
       requestBody = formData;
+    } else if (binaryBody) {
+      finalHeaders["Content-Type"] = "application/octet-stream";
+      requestBody = binaryBody;
     } else if (body) {
       finalHeaders["Content-Type"] = "application/json";
       requestBody = JSON.stringify(body);
@@ -471,11 +474,13 @@ var APIClient = class {
   httpClient;
   logger = null;
   retryConfig = null;
+  tokenGetter = null;
   // Sub-clients
   ext_payments_payments;
   constructor(baseUrl, options) {
     this.baseUrl = baseUrl.replace(/\/$/, "");
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
     if (options?.loggerConfig !== void 0) {
       this.logger = new APILogger(options.loggerConfig);
     }
@@ -498,6 +503,19 @@ var APIClient = class {
     }
     return null;
   }
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken() {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.
@@ -528,7 +546,7 @@ var APIClient = class {
     const headers = {
       ...options?.headers || {}
     };
-    if (!options?.formData && !headers["Content-Type"]) {
+    if (!options?.formData && !options?.binaryBody && !headers["Content-Type"]) {
       headers["Content-Type"] = "application/json";
     }
     if (this.logger) {
@@ -547,7 +565,8 @@ var APIClient = class {
         headers,
         params: options?.params,
         body: options?.body,
-        formData: options?.formData
+        formData: options?.formData,
+        binaryBody: options?.binaryBody
       });
       const duration = Date.now() - startTime;
       if (response.status >= 400) {
@@ -883,7 +902,7 @@ var PaymentDetailSchema = zod.z.object({
   status_display: zod.z.string(),
   pay_address: zod.z.string().nullable(),
   qr_code_url: zod.z.string().nullable(),
-  payment_url: zod.z.url().nullable(),
+  payment_url: zod.z.union([zod.z.url(), zod.z.literal("")]).nullable(),
   transaction_hash: zod.z.string().nullable(),
   explorer_link: zod.z.string().nullable(),
   confirmations_count: zod.z.int(),
@@ -968,15 +987,28 @@ __export(fetchers_exports, {
 
 // src/api/generated/ext_payments/api-instance.ts
 var globalAPI = null;
+var autoConfigAttempted = false;
+function tryAutoConfigureFromEnv() {
+  if (autoConfigAttempted) return;
+  autoConfigAttempted = true;
+  if (globalAPI) return;
+  if (typeof process === "undefined" || !process.env) return;
+  const baseUrl = process.env.NEXT_PUBLIC_API_URL || process.env.VITE_API_URL || process.env.REACT_APP_API_URL || process.env.API_URL;
+  if (baseUrl) {
+    globalAPI = new API(baseUrl);
+  }
+}
 function getAPIInstance() {
+  tryAutoConfigureFromEnv();
   if (!globalAPI) {
     throw new Error(
-      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })'
+      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })\n\nOr set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     );
   }
   return globalAPI;
 }
 function isAPIConfigured() {
+  tryAutoConfigureFromEnv();
   return globalAPI !== null;
 }
 function configureAPI(config) {
@@ -1291,7 +1323,8 @@ var API = class {
     this._loadTokensFromStorage();
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1303,7 +1336,8 @@ var API = class {
   _reinitClients() {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1394,6 +1428,7 @@ var API = class {
     return "./schema.json";
   }
 };
+api.initializeExtensionAPI(configureAPI);
 var apiPayments = api.createExtensionAPI(API);
 function usePaymentsBalanceRetrieve(client) {
   return useSWR__default.default(
@@ -2617,7 +2652,7 @@ var PaymentsLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-payments",
-  version: "1.0.9",
+  version: "1.0.11",
   description: "Payments system extension for DjangoCFG",
   keywords: [
     "django",

package/dist/hooks.js

@@ -1,7 +1,7 @@
 import { createConsola, consola } from 'consola';
 import pRetry, { AbortError } from 'p-retry';
 import { z } from 'zod';
-import { createExtensionAPI } from '@djangocfg/ext-base/api';
+import { initializeExtensionAPI, createExtensionAPI } from '@djangocfg/ext-base/api';
 import { RefreshCw, Plus, XCircle, ExternalLink, Wallet, CreditCard, History, Clock, AlertCircle, CheckCircle2, Search, Filter, ArrowDownLeft, ArrowUpRight } from 'lucide-react';
 import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Form, FormField, FormItem, FormLabel, FormControl, Input, FormDescription, FormMessage, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, TokenIcon, DialogFooter, Button, CopyButton, Tabs, TabsList, TabsTrigger, TabsContent, Card, CardHeader, CardTitle, Skeleton, CardContent, Badge, Table, TableHeader, TableRow, TableHead, TableBody, TableCell } from '@djangocfg/ui-core';
 import { createContext, useContext, useState, useMemo, useEffect } from 'react';
@@ -121,7 +121,7 @@ var models_exports = {};
 // src/api/generated/ext_payments/http.ts
 var FetchAdapter = class {
   async request(request) {
-    const { method, url, headers, body, params, formData } = request;
+    const { method, url, headers, body, params, formData, binaryBody } = request;
     let finalUrl = url;
     if (params) {
       const searchParams = new URLSearchParams();
@@ -139,6 +139,9 @@ var FetchAdapter = class {
     let requestBody;
     if (formData) {
       requestBody = formData;
+    } else if (binaryBody) {
+      finalHeaders["Content-Type"] = "application/octet-stream";
+      requestBody = binaryBody;
     } else if (body) {
       finalHeaders["Content-Type"] = "application/json";
       requestBody = JSON.stringify(body);
@@ -463,11 +466,13 @@ var APIClient = class {
   httpClient;
   logger = null;
   retryConfig = null;
+  tokenGetter = null;
   // Sub-clients
   ext_payments_payments;
   constructor(baseUrl, options) {
     this.baseUrl = baseUrl.replace(/\/$/, "");
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
     if (options?.loggerConfig !== void 0) {
       this.logger = new APILogger(options.loggerConfig);
     }
@@ -490,6 +495,19 @@ var APIClient = class {
     }
     return null;
   }
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken() {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.
@@ -520,7 +538,7 @@ var APIClient = class {
     const headers = {
       ...options?.headers || {}
     };
-    if (!options?.formData && !headers["Content-Type"]) {
+    if (!options?.formData && !options?.binaryBody && !headers["Content-Type"]) {
       headers["Content-Type"] = "application/json";
     }
     if (this.logger) {
@@ -539,7 +557,8 @@ var APIClient = class {
         headers,
         params: options?.params,
         body: options?.body,
-        formData: options?.formData
+        formData: options?.formData,
+        binaryBody: options?.binaryBody
       });
       const duration = Date.now() - startTime;
       if (response.status >= 400) {
@@ -875,7 +894,7 @@ var PaymentDetailSchema = z.object({
   status_display: z.string(),
   pay_address: z.string().nullable(),
   qr_code_url: z.string().nullable(),
-  payment_url: z.url().nullable(),
+  payment_url: z.union([z.url(), z.literal("")]).nullable(),
   transaction_hash: z.string().nullable(),
   explorer_link: z.string().nullable(),
   confirmations_count: z.int(),
@@ -960,15 +979,28 @@ __export(fetchers_exports, {
 
 // src/api/generated/ext_payments/api-instance.ts
 var globalAPI = null;
+var autoConfigAttempted = false;
+function tryAutoConfigureFromEnv() {
+  if (autoConfigAttempted) return;
+  autoConfigAttempted = true;
+  if (globalAPI) return;
+  if (typeof process === "undefined" || !process.env) return;
+  const baseUrl = process.env.NEXT_PUBLIC_API_URL || process.env.VITE_API_URL || process.env.REACT_APP_API_URL || process.env.API_URL;
+  if (baseUrl) {
+    globalAPI = new API(baseUrl);
+  }
+}
 function getAPIInstance() {
+  tryAutoConfigureFromEnv();
   if (!globalAPI) {
     throw new Error(
-      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })'
+      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })\n\nOr set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     );
   }
   return globalAPI;
 }
 function isAPIConfigured() {
+  tryAutoConfigureFromEnv();
   return globalAPI !== null;
 }
 function configureAPI(config) {
@@ -1283,7 +1315,8 @@ var API = class {
     this._loadTokensFromStorage();
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1295,7 +1328,8 @@ var API = class {
   _reinitClients() {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1386,6 +1420,7 @@ var API = class {
     return "./schema.json";
   }
 };
+initializeExtensionAPI(configureAPI);
 var apiPayments = createExtensionAPI(API);
 function usePaymentsBalanceRetrieve(client) {
   return useSWR(
@@ -2609,7 +2644,7 @@ var PaymentsLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-payments",
-  version: "1.0.9",
+  version: "1.0.11",
   description: "Payments system extension for DjangoCFG",
   keywords: [
     "django",

package/dist/index.cjs

@@ -129,7 +129,7 @@ var models_exports = {};
 // src/api/generated/ext_payments/http.ts
 var FetchAdapter = class {
   async request(request) {
-    const { method, url, headers, body, params, formData } = request;
+    const { method, url, headers, body, params, formData, binaryBody } = request;
     let finalUrl = url;
     if (params) {
       const searchParams = new URLSearchParams();
@@ -147,6 +147,9 @@ var FetchAdapter = class {
     let requestBody;
     if (formData) {
       requestBody = formData;
+    } else if (binaryBody) {
+      finalHeaders["Content-Type"] = "application/octet-stream";
+      requestBody = binaryBody;
     } else if (body) {
       finalHeaders["Content-Type"] = "application/json";
       requestBody = JSON.stringify(body);
@@ -471,11 +474,13 @@ var APIClient = class {
   httpClient;
   logger = null;
   retryConfig = null;
+  tokenGetter = null;
   // Sub-clients
   ext_payments_payments;
   constructor(baseUrl, options) {
     this.baseUrl = baseUrl.replace(/\/$/, "");
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
     if (options?.loggerConfig !== void 0) {
       this.logger = new APILogger(options.loggerConfig);
     }
@@ -498,6 +503,19 @@ var APIClient = class {
     }
     return null;
   }
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken() {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.
@@ -528,7 +546,7 @@ var APIClient = class {
     const headers = {
       ...options?.headers || {}
     };
-    if (!options?.formData && !headers["Content-Type"]) {
+    if (!options?.formData && !options?.binaryBody && !headers["Content-Type"]) {
       headers["Content-Type"] = "application/json";
     }
     if (this.logger) {
@@ -547,7 +565,8 @@ var APIClient = class {
         headers,
         params: options?.params,
         body: options?.body,
-        formData: options?.formData
+        formData: options?.formData,
+        binaryBody: options?.binaryBody
       });
       const duration = Date.now() - startTime;
       if (response.status >= 400) {
@@ -883,7 +902,7 @@ var PaymentDetailSchema = zod.z.object({
   status_display: zod.z.string(),
   pay_address: zod.z.string().nullable(),
   qr_code_url: zod.z.string().nullable(),
-  payment_url: zod.z.url().nullable(),
+  payment_url: zod.z.union([zod.z.url(), zod.z.literal("")]).nullable(),
   transaction_hash: zod.z.string().nullable(),
   explorer_link: zod.z.string().nullable(),
   confirmations_count: zod.z.int(),
@@ -968,15 +987,28 @@ __export(fetchers_exports, {
 
 // src/api/generated/ext_payments/api-instance.ts
 var globalAPI = null;
+var autoConfigAttempted = false;
+function tryAutoConfigureFromEnv() {
+  if (autoConfigAttempted) return;
+  autoConfigAttempted = true;
+  if (globalAPI) return;
+  if (typeof process === "undefined" || !process.env) return;
+  const baseUrl = process.env.NEXT_PUBLIC_API_URL || process.env.VITE_API_URL || process.env.REACT_APP_API_URL || process.env.API_URL;
+  if (baseUrl) {
+    globalAPI = new API(baseUrl);
+  }
+}
 function getAPIInstance() {
+  tryAutoConfigureFromEnv();
   if (!globalAPI) {
     throw new Error(
-      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })'
+      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })\n\nOr set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     );
   }
   return globalAPI;
 }
 function isAPIConfigured() {
+  tryAutoConfigureFromEnv();
   return globalAPI !== null;
 }
 function configureAPI(config) {
@@ -1291,7 +1323,8 @@ var API = class {
     this._loadTokensFromStorage();
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1303,7 +1336,8 @@ var API = class {
   _reinitClients() {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1394,6 +1428,7 @@ var API = class {
     return "./schema.json";
   }
 };
+api.initializeExtensionAPI(configureAPI);
 var apiPayments = api.createExtensionAPI(API);
 function usePaymentsBalanceRetrieve(client) {
   return useSWR__default.default(
@@ -2561,7 +2596,7 @@ var PaymentsLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-payments",
-  version: "1.0.9",
+  version: "1.0.11",
   description: "Payments system extension for DjangoCFG",
   keywords: [
     "django",

package/dist/index.d.cts

@@ -279,6 +279,8 @@ interface HttpRequest {
     params?: Record<string, any>;
     /** FormData for file uploads (multipart/form-data) */
     formData?: FormData;
+    /** Binary data for octet-stream uploads */
+    binaryBody?: Blob | ArrayBuffer;
 }
 interface HttpResponse<T = any> {
     data: T;
@@ -531,11 +533,13 @@ declare class APIClient {
     private httpClient;
     private logger;
     private retryConfig;
+    private tokenGetter;
     ext_payments_payments: ExtPaymentsPayments;
     constructor(baseUrl: string, options?: {
         httpClient?: HttpClientAdapter;
         loggerConfig?: Partial<LoggerConfig>;
         retryConfig?: RetryConfig;
+        tokenGetter?: () => string | null;
     });
     /**
      * Get CSRF token from cookies (for SessionAuthentication).
@@ -543,6 +547,15 @@ declare class APIClient {
      * Returns null if cookie doesn't exist (JWT-only auth).
      */
     getCsrfToken(): string | null;
+    /**
+     * Get the base URL for building streaming/download URLs.
+     */
+    getBaseUrl(): string;
+    /**
+     * Get JWT token for URL authentication (used in streaming endpoints).
+     * Returns null if no token getter is configured or no token is available.
+     */
+    getToken(): string | null;
     /**
      * Make HTTP request with Django CSRF and session handling.
      * Automatically retries on network errors and 5xx server errors.
@@ -551,6 +564,7 @@ declare class APIClient {
         params?: Record<string, any>;
         body?: any;
         formData?: FormData;
+        binaryBody?: Blob | ArrayBuffer;
         headers?: Record<string, string>;
     }): Promise<T>;
     /**
@@ -715,7 +729,7 @@ declare const PaymentDetailSchema: z.ZodObject<{
     status_display: z.ZodString;
     pay_address: z.ZodNullable<z.ZodString>;
     qr_code_url: z.ZodNullable<z.ZodString>;
-    payment_url: z.ZodNullable<z.ZodURL>;
+    payment_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     transaction_hash: z.ZodNullable<z.ZodString>;
     explorer_link: z.ZodNullable<z.ZodString>;
     confirmations_count: z.ZodInt;
@@ -995,30 +1009,38 @@ declare namespace index {
 }
 
 /**
- * Global API Instance - Singleton configuration
+ * Global API Instance - Singleton configuration with auto-configuration support
  *
- * This module provides a global API instance that can be configured once
- * and used throughout your application.
+ * This module provides a global API instance that auto-configures from
+ * environment variables or can be configured manually.
  *
- * Usage:
+ * AUTO-CONFIGURATION (recommended):
+ * Set one of these environment variables and the API will auto-configure:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ *
+ * Then just use fetchers and hooks directly:
+ * ```typescript
+ * import { getUsers } from './_utils/fetchers'
+ * const users = await getUsers({ page: 1 })
+ * ```
+ *
+ * MANUAL CONFIGURATION:
  * ```typescript
- * // Configure once (e.g., in your app entry point)
  * import { configureAPI } from './api-instance'
  *
  * configureAPI({
  *   baseUrl: 'https://api.example.com',
  *   token: 'your-jwt-token'
  * })
- *
- * // Then use fetchers and hooks anywhere without configuration
- * import { getUsers } from './fetchers'
- * const users = await getUsers({ page: 1 })
  * ```
  *
  * For SSR or multiple instances:
  * ```typescript
  * import { API } from './index'
- * import { getUsers } from './fetchers'
+ * import { getUsers } from './_utils/fetchers'
  *
  * const api = new API('https://api.example.com')
  * const users = await getUsers({ page: 1 }, api)
@@ -1027,11 +1049,12 @@ declare namespace index {
 
 /**
  * Get the global API instance
- * @throws Error if API is not configured
+ * Auto-configures from environment variables on first call if not manually configured.
+ * @throws Error if API is not configured and no env variable is set
  */
 declare function getAPIInstance(): API;
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 declare function isAPIConfigured(): boolean;
 /**

package/dist/index.d.ts

@@ -279,6 +279,8 @@ interface HttpRequest {
     params?: Record<string, any>;
     /** FormData for file uploads (multipart/form-data) */
     formData?: FormData;
+    /** Binary data for octet-stream uploads */
+    binaryBody?: Blob | ArrayBuffer;
 }
 interface HttpResponse<T = any> {
     data: T;
@@ -531,11 +533,13 @@ declare class APIClient {
     private httpClient;
     private logger;
     private retryConfig;
+    private tokenGetter;
     ext_payments_payments: ExtPaymentsPayments;
     constructor(baseUrl: string, options?: {
         httpClient?: HttpClientAdapter;
         loggerConfig?: Partial<LoggerConfig>;
         retryConfig?: RetryConfig;
+        tokenGetter?: () => string | null;
     });
     /**
      * Get CSRF token from cookies (for SessionAuthentication).
@@ -543,6 +547,15 @@ declare class APIClient {
      * Returns null if cookie doesn't exist (JWT-only auth).
      */
     getCsrfToken(): string | null;
+    /**
+     * Get the base URL for building streaming/download URLs.
+     */
+    getBaseUrl(): string;
+    /**
+     * Get JWT token for URL authentication (used in streaming endpoints).
+     * Returns null if no token getter is configured or no token is available.
+     */
+    getToken(): string | null;
     /**
      * Make HTTP request with Django CSRF and session handling.
      * Automatically retries on network errors and 5xx server errors.
@@ -551,6 +564,7 @@ declare class APIClient {
         params?: Record<string, any>;
         body?: any;
         formData?: FormData;
+        binaryBody?: Blob | ArrayBuffer;
         headers?: Record<string, string>;
     }): Promise<T>;
     /**
@@ -715,7 +729,7 @@ declare const PaymentDetailSchema: z.ZodObject<{
     status_display: z.ZodString;
     pay_address: z.ZodNullable<z.ZodString>;
     qr_code_url: z.ZodNullable<z.ZodString>;
-    payment_url: z.ZodNullable<z.ZodURL>;
+    payment_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     transaction_hash: z.ZodNullable<z.ZodString>;
     explorer_link: z.ZodNullable<z.ZodString>;
     confirmations_count: z.ZodInt;
@@ -995,30 +1009,38 @@ declare namespace index {
 }
 
 /**
- * Global API Instance - Singleton configuration
+ * Global API Instance - Singleton configuration with auto-configuration support
  *
- * This module provides a global API instance that can be configured once
- * and used throughout your application.
+ * This module provides a global API instance that auto-configures from
+ * environment variables or can be configured manually.
  *
- * Usage:
+ * AUTO-CONFIGURATION (recommended):
+ * Set one of these environment variables and the API will auto-configure:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ *
+ * Then just use fetchers and hooks directly:
+ * ```typescript
+ * import { getUsers } from './_utils/fetchers'
+ * const users = await getUsers({ page: 1 })
+ * ```
+ *
+ * MANUAL CONFIGURATION:
  * ```typescript
- * // Configure once (e.g., in your app entry point)
  * import { configureAPI } from './api-instance'
  *
  * configureAPI({
  *   baseUrl: 'https://api.example.com',
  *   token: 'your-jwt-token'
  * })
- *
- * // Then use fetchers and hooks anywhere without configuration
- * import { getUsers } from './fetchers'
- * const users = await getUsers({ page: 1 })
  * ```
  *
  * For SSR or multiple instances:
  * ```typescript
  * import { API } from './index'
- * import { getUsers } from './fetchers'
+ * import { getUsers } from './_utils/fetchers'
  *
  * const api = new API('https://api.example.com')
  * const users = await getUsers({ page: 1 }, api)
@@ -1027,11 +1049,12 @@ declare namespace index {
 
 /**
  * Get the global API instance
- * @throws Error if API is not configured
+ * Auto-configures from environment variables on first call if not manually configured.
+ * @throws Error if API is not configured and no env variable is set
  */
 declare function getAPIInstance(): API;
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 declare function isAPIConfigured(): boolean;
 /**

package/dist/index.js

@@ -1,7 +1,7 @@
 import { createConsola, consola } from 'consola';
 import pRetry, { AbortError } from 'p-retry';
 import { z } from 'zod';
-import { createExtensionAPI } from '@djangocfg/ext-base/api';
+import { initializeExtensionAPI, createExtensionAPI } from '@djangocfg/ext-base/api';
 import { Wallet, CreditCard, History, RefreshCw, Plus, XCircle, ExternalLink, Search, Filter, Clock, AlertCircle, CheckCircle2, ArrowDownLeft, ArrowUpRight } from 'lucide-react';
 import { Tabs, TabsList, TabsTrigger, TabsContent, Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Form, FormField, FormItem, FormLabel, FormControl, Input, FormDescription, FormMessage, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, TokenIcon, DialogFooter, Button, CopyButton, Card, CardHeader, CardTitle, Skeleton, CardContent, Badge, Table, TableHeader, TableRow, TableHead, TableBody, TableCell } from '@djangocfg/ui-core';
 import { createContext, useState, useMemo, useEffect, useContext } from 'react';
@@ -121,7 +121,7 @@ var models_exports = {};
 // src/api/generated/ext_payments/http.ts
 var FetchAdapter = class {
   async request(request) {
-    const { method, url, headers, body, params, formData } = request;
+    const { method, url, headers, body, params, formData, binaryBody } = request;
     let finalUrl = url;
     if (params) {
       const searchParams = new URLSearchParams();
@@ -139,6 +139,9 @@ var FetchAdapter = class {
     let requestBody;
     if (formData) {
       requestBody = formData;
+    } else if (binaryBody) {
+      finalHeaders["Content-Type"] = "application/octet-stream";
+      requestBody = binaryBody;
     } else if (body) {
       finalHeaders["Content-Type"] = "application/json";
       requestBody = JSON.stringify(body);
@@ -463,11 +466,13 @@ var APIClient = class {
   httpClient;
   logger = null;
   retryConfig = null;
+  tokenGetter = null;
   // Sub-clients
   ext_payments_payments;
   constructor(baseUrl, options) {
     this.baseUrl = baseUrl.replace(/\/$/, "");
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
     if (options?.loggerConfig !== void 0) {
       this.logger = new APILogger(options.loggerConfig);
     }
@@ -490,6 +495,19 @@ var APIClient = class {
     }
     return null;
   }
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken() {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.
@@ -520,7 +538,7 @@ var APIClient = class {
     const headers = {
       ...options?.headers || {}
     };
-    if (!options?.formData && !headers["Content-Type"]) {
+    if (!options?.formData && !options?.binaryBody && !headers["Content-Type"]) {
       headers["Content-Type"] = "application/json";
     }
     if (this.logger) {
@@ -539,7 +557,8 @@ var APIClient = class {
         headers,
         params: options?.params,
         body: options?.body,
-        formData: options?.formData
+        formData: options?.formData,
+        binaryBody: options?.binaryBody
       });
       const duration = Date.now() - startTime;
       if (response.status >= 400) {
@@ -875,7 +894,7 @@ var PaymentDetailSchema = z.object({
   status_display: z.string(),
   pay_address: z.string().nullable(),
   qr_code_url: z.string().nullable(),
-  payment_url: z.url().nullable(),
+  payment_url: z.union([z.url(), z.literal("")]).nullable(),
   transaction_hash: z.string().nullable(),
   explorer_link: z.string().nullable(),
   confirmations_count: z.int(),
@@ -960,15 +979,28 @@ __export(fetchers_exports, {
 
 // src/api/generated/ext_payments/api-instance.ts
 var globalAPI = null;
+var autoConfigAttempted = false;
+function tryAutoConfigureFromEnv() {
+  if (autoConfigAttempted) return;
+  autoConfigAttempted = true;
+  if (globalAPI) return;
+  if (typeof process === "undefined" || !process.env) return;
+  const baseUrl = process.env.NEXT_PUBLIC_API_URL || process.env.VITE_API_URL || process.env.REACT_APP_API_URL || process.env.API_URL;
+  if (baseUrl) {
+    globalAPI = new API(baseUrl);
+  }
+}
 function getAPIInstance() {
+  tryAutoConfigureFromEnv();
   if (!globalAPI) {
     throw new Error(
-      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })'
+      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\nExample:\n  import { configureAPI } from "./api-instance"\n  configureAPI({ baseUrl: "https://api.example.com" })\n\nOr set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     );
   }
   return globalAPI;
 }
 function isAPIConfigured() {
+  tryAutoConfigureFromEnv();
   return globalAPI !== null;
 }
 function configureAPI(config) {
@@ -1283,7 +1315,8 @@ var API = class {
     this._loadTokensFromStorage();
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1295,7 +1328,8 @@ var API = class {
   _reinitClients() {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig
+      loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken()
     });
     this._injectAuthHeader();
     this.ext_payments_payments = this._client.ext_payments_payments;
@@ -1386,6 +1420,7 @@ var API = class {
     return "./schema.json";
   }
 };
+initializeExtensionAPI(configureAPI);
 var apiPayments = createExtensionAPI(API);
 function usePaymentsBalanceRetrieve(client) {
   return useSWR(
@@ -2553,7 +2588,7 @@ var PaymentsLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-payments",
-  version: "1.0.9",
+  version: "1.0.11",
   description: "Payments system extension for DjangoCFG",
   keywords: [
     "django",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ext-payments",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Payments system extension for DjangoCFG",
   "keywords": [
     "django",
@@ -59,10 +59,10 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.104",
+    "@djangocfg/api": "^2.1.107",
     "@djangocfg/ext-base": "^1.0.8",
-    "@djangocfg/ui-core": "^2.1.104",
-    "@djangocfg/ui-nextjs": "^2.1.104",
+    "@djangocfg/ui-core": "^2.1.107",
+    "@djangocfg/ui-nextjs": "^2.1.107",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "next": "^15.5.7",
@@ -73,10 +73,10 @@
     "moment": "^2.30.1"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.104",
+    "@djangocfg/api": "^2.1.107",
     "@djangocfg/ext-base": "^1.0.8",
-    "@djangocfg/typescript-config": "^2.1.104",
-    "@djangocfg/ui-nextjs": "^2.1.104",
+    "@djangocfg/typescript-config": "^2.1.107",
+    "@djangocfg/ui-nextjs": "^2.1.107",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     "consola": "^3.4.2",

package/src/api/generated/ext_payments/CLAUDE.md

@@ -65,12 +65,5 @@ openapi_client = OpenAPIClientConfig(
 )
 ```
 
-**Copy to Next.js** (if `nextjs_admin` configured):
-```python
-nextjs_admin = NextJsAdminConfig(
-    project_path="../frontend/apps/...",
-    api_output_path="app/_lib/api/generated",
-)
-```
-
 @see https://djangocfg.com/docs/features/api-generation
+

package/src/api/generated/ext_payments/_utils/schemas/PaymentDetail.schema.ts

@@ -25,7 +25,7 @@ export const PaymentDetailSchema = z.object({
   status_display: z.string(),
   pay_address: z.string().nullable(),
   qr_code_url: z.string().nullable(),
-  payment_url: z.url().nullable(),
+  payment_url: z.union([z.url(), z.literal('')]).nullable(),
   transaction_hash: z.string().nullable(),
   explorer_link: z.string().nullable(),
   confirmations_count: z.int(),

package/src/api/generated/ext_payments/api-instance.ts

@@ -1,29 +1,37 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
 /**
- * Global API Instance - Singleton configuration
+ * Global API Instance - Singleton configuration with auto-configuration support
  *
- * This module provides a global API instance that can be configured once
- * and used throughout your application.
+ * This module provides a global API instance that auto-configures from
+ * environment variables or can be configured manually.
  *
- * Usage:
+ * AUTO-CONFIGURATION (recommended):
+ * Set one of these environment variables and the API will auto-configure:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ *
+ * Then just use fetchers and hooks directly:
+ * ```typescript
+ * import { getUsers } from './_utils/fetchers'
+ * const users = await getUsers({ page: 1 })
+ * ```
+ *
+ * MANUAL CONFIGURATION:
  * ```typescript
- * // Configure once (e.g., in your app entry point)
  * import { configureAPI } from './api-instance'
  *
  * configureAPI({
  *   baseUrl: 'https://api.example.com',
  *   token: 'your-jwt-token'
  * })
- *
- * // Then use fetchers and hooks anywhere without configuration
- * import { getUsers } from './fetchers'
- * const users = await getUsers({ page: 1 })
  * ```
  *
  * For SSR or multiple instances:
  * ```typescript
  * import { API } from './index'
- * import { getUsers } from './fetchers'
+ * import { getUsers } from './_utils/fetchers'
  *
  * const api = new API('https://api.example.com')
  * const users = await getUsers({ page: 1 }, api)
@@ -33,27 +41,67 @@
 import { API, type APIOptions } from './index'
 
 let globalAPI: API | null = null
+let autoConfigAttempted = false
+
+/**
+ * Auto-configure from environment variable if available (Next.js pattern)
+ * This allows hooks and fetchers to work without explicit configureAPI() call
+ *
+ * Supported environment variables:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ */
+function tryAutoConfigureFromEnv(): void {
+  // Only attempt once
+  if (autoConfigAttempted) return
+  autoConfigAttempted = true
+
+  // Skip if already configured
+  if (globalAPI) return
+
+  // Skip if process is not available (pure browser without bundler)
+  if (typeof process === 'undefined' || !process.env) return
+
+  // Try different environment variable patterns
+  const baseUrl =
+    process.env.NEXT_PUBLIC_API_URL ||
+    process.env.VITE_API_URL ||
+    process.env.REACT_APP_API_URL ||
+    process.env.API_URL
+
+  if (baseUrl) {
+    globalAPI = new API(baseUrl)
+  }
+}
 
 /**
  * Get the global API instance
- * @throws Error if API is not configured
+ * Auto-configures from environment variables on first call if not manually configured.
+ * @throws Error if API is not configured and no env variable is set
  */
 export function getAPIInstance(): API {
+  // Try auto-configuration on first access (lazy initialization)
+  tryAutoConfigureFromEnv()
+
   if (!globalAPI) {
     throw new Error(
       'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\n' +
       'Example:\n' +
       '  import { configureAPI } from "./api-instance"\n' +
-      '  configureAPI({ baseUrl: "https://api.example.com" })'
+      '  configureAPI({ baseUrl: "https://api.example.com" })\n\n' +
+      'Or set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     )
   }
   return globalAPI
 }
 
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 export function isAPIConfigured(): boolean {
+  tryAutoConfigureFromEnv()
   return globalAPI !== null
 }
 

package/src/api/generated/ext_payments/client.ts

@@ -25,6 +25,7 @@ export class APIClient {
   private httpClient: HttpClientAdapter;
   private logger: APILogger | null = null;
   private retryConfig: RetryConfig | null = null;
+  private tokenGetter: (() => string | null) | null = null;
 
   // Sub-clients
   public ext_payments_payments: ExtPaymentsPayments;
@@ -35,10 +36,12 @@ export class APIClient {
       httpClient?: HttpClientAdapter;
       loggerConfig?: Partial<LoggerConfig>;
       retryConfig?: RetryConfig;
+      tokenGetter?: () => string | null;
     }
   ) {
     this.baseUrl = baseUrl.replace(/\/$/, '');
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
 
     // Initialize logger if config provided
     if (options?.loggerConfig !== undefined) {
@@ -69,6 +72,21 @@ export class APIClient {
     return null;
   }
 
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken(): string | null {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
+
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.
@@ -80,6 +98,7 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
@@ -116,6 +135,7 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
@@ -129,8 +149,8 @@ export class APIClient {
       ...(options?.headers || {})
     };
 
-    // Don't set Content-Type for FormData (browser will set it with boundary)
-    if (!options?.formData && !headers['Content-Type']) {
+    // Don't set Content-Type for FormData/binaryBody (browser will set it with boundary)
+    if (!options?.formData && !options?.binaryBody && !headers['Content-Type']) {
       headers['Content-Type'] = 'application/json';
     }
 
@@ -157,6 +177,7 @@ export class APIClient {
         params: options?.params,
         body: options?.body,
         formData: options?.formData,
+        binaryBody: options?.binaryBody,
       });
 
       const duration = Date.now() - startTime;

package/src/api/generated/ext_payments/http.ts

@@ -14,6 +14,8 @@ export interface HttpRequest {
   params?: Record<string, any>;
   /** FormData for file uploads (multipart/form-data) */
   formData?: FormData;
+  /** Binary data for octet-stream uploads */
+  binaryBody?: Blob | ArrayBuffer;
 }
 
 export interface HttpResponse<T = any> {
@@ -37,7 +39,7 @@ export interface HttpClientAdapter {
  */
 export class FetchAdapter implements HttpClientAdapter {
   async request<T = any>(request: HttpRequest): Promise<HttpResponse<T>> {
-    const { method, url, headers, body, params, formData } = request;
+    const { method, url, headers, body, params, formData, binaryBody } = request;
 
     // Build URL with query params
     let finalUrl = url;
@@ -58,12 +60,16 @@ export class FetchAdapter implements HttpClientAdapter {
     const finalHeaders: Record<string, string> = { ...headers };
 
     // Determine body and content-type
-    let requestBody: string | FormData | undefined;
+    let requestBody: string | FormData | Blob | ArrayBuffer | undefined;
 
     if (formData) {
       // For multipart/form-data, let browser set Content-Type with boundary
       requestBody = formData;
       // Don't set Content-Type - browser will set it with boundary
+    } else if (binaryBody) {
+      // Binary upload (application/octet-stream)
+      finalHeaders['Content-Type'] = 'application/octet-stream';
+      requestBody = binaryBody;
     } else if (body) {
       // JSON request
       finalHeaders['Content-Type'] = 'application/json';

package/src/api/generated/ext_payments/index.ts

@@ -133,10 +133,11 @@ export class API {
 
     this._loadTokensFromStorage();
 
-    // Initialize APIClient
+    // Initialize APIClient with token getter for URL authentication
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)
@@ -155,6 +156,7 @@ export class API {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)

package/src/api/index.ts

@@ -1,4 +1,4 @@
-import { createExtensionAPI } from '@djangocfg/ext-base/api';
+import { createExtensionAPI, initializeExtensionAPI } from '@djangocfg/ext-base/api';
 
 /**
  * Payments Extension API
@@ -6,5 +6,10 @@ import { createExtensionAPI } from '@djangocfg/ext-base/api';
  * Pre-configured API instance with shared authentication
  */
 import { API } from './generated/ext_payments';
+import { configureAPI } from './generated/ext_payments/api-instance';
 
+// Initialize global API singleton for hooks and fetchers
+initializeExtensionAPI(configureAPI);
+
+// Create instance for direct usage
 export const apiPayments = createExtensionAPI(API);