@djangocfg/ext-newsletter 1.0.9 → 1.0.10

package/src/api/generated/ext_newsletter/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_newsletter/client.ts

@@ -31,6 +31,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_newsletter_bulk_email: ExtNewsletterBulkEmail;
@@ -47,10 +48,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) {
@@ -87,6 +90,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.
@@ -98,6 +116,7 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
@@ -134,6 +153,7 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
@@ -147,8 +167,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';
     }
 
@@ -175,6 +195,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_newsletter/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_newsletter/index.ts

@@ -163,10 +163,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)
@@ -191,6 +192,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';
 
 /**
  * Newsletter 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_newsletter';
+import { configureAPI } from './generated/ext_newsletter/api-instance';
 
+// Initialize global API singleton for hooks and fetchers
+initializeExtensionAPI(configureAPI);
+
+// Create instance for direct usage
 export const apiNewsletter = createExtensionAPI(API);