@djangocfg/api 2.1.55 → 2.1.56

package/src/generated/cfg_webpush/_utils/schemas/SendPushRequestRequest.schema.ts

@@ -12,8 +12,8 @@ import { z } from 'zod'
 export const SendPushRequestRequestSchema = z.object({
   title: z.string().min(1).max(255),
   body: z.string().min(1),
-  icon: z.url().nullable().optional(),
-  url: z.url().nullable().optional(),
+  icon: z.union([z.url(), z.literal('')]).nullable().optional(),
+  url: z.union([z.url(), z.literal('')]).nullable().optional(),
 })
 
 /**

package/src/generated/cfg_webpush/_utils/schemas/SubscribeRequestRequest.schema.ts

@@ -10,7 +10,7 @@ import { z } from 'zod'
  * Request serializer for subscribing to push notifications.
  */
 export const SubscribeRequestRequestSchema = z.object({
-  endpoint: z.url(),
+  endpoint: z.union([z.url(), z.literal('')]),
   keys: z.record(z.string(), z.string().min(1)),
 })
 

package/src/generated/cfg_webpush/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
 }