@djangocfg/api 2.1.54 → 2.1.56

package/dist/index.d.cts

@@ -821,7 +821,7 @@ declare class MemoryStorageAdapter$1 implements StorageAdapter$1 {
  */
 declare const CentrifugoTokenSchema: z.ZodObject<{
     token: z.ZodString;
-    centrifugo_url: z.ZodURL;
+    centrifugo_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     expires_at: z.ZodISODateTime;
     channels: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -841,8 +841,8 @@ type CentrifugoToken = z.infer<typeof CentrifugoTokenSchema>;
  * Request to start OAuth flow.
  */
 declare const OAuthAuthorizeRequestRequestSchema: z.ZodObject<{
-    redirect_uri: z.ZodOptional<z.ZodURL>;
-    source_url: z.ZodOptional<z.ZodURL>;
+    redirect_uri: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
+    source_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -860,7 +860,7 @@ type OAuthAuthorizeRequestRequest = z.infer<typeof OAuthAuthorizeRequestRequestS
  * Response with OAuth authorization URL.
  */
 declare const OAuthAuthorizeResponseSchema: z.ZodObject<{
-    authorization_url: z.ZodURL;
+    authorization_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     state: z.ZodString;
 }, z.core.$strip>;
 /**
@@ -881,7 +881,7 @@ type OAuthAuthorizeResponse = z.infer<typeof OAuthAuthorizeResponseSchema>;
 declare const OAuthCallbackRequestRequestSchema: z.ZodObject<{
     code: z.ZodString;
     state: z.ZodString;
-    redirect_uri: z.ZodOptional<z.ZodURL>;
+    redirect_uri: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -904,7 +904,7 @@ declare const OAuthConnectionSchema: z.ZodObject<{
     provider_display: z.ZodString;
     provider_username: z.ZodString;
     provider_email: z.ZodEmail;
-    provider_avatar_url: z.ZodURL;
+    provider_avatar_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     connected_at: z.ZodISODateTime;
     last_login_at: z.ZodISODateTime;
 }, z.core.$strip>;
@@ -961,7 +961,7 @@ type OAuthError = z.infer<typeof OAuthErrorSchema>;
  * Response with available OAuth providers.
  */
 declare const OAuthProvidersResponseSchema: z.ZodObject<{
-    providers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    providers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -981,7 +981,7 @@ type OAuthProvidersResponse = z.infer<typeof OAuthProvidersResponseSchema>;
 declare const OAuthTokenResponseSchema: z.ZodObject<{
     access: z.ZodString;
     refresh: z.ZodString;
-    user: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>>;
+    user: z.ZodRecord<z.ZodString, z.ZodAny>;
     is_new_user: z.ZodBoolean;
     is_new_connection: z.ZodBoolean;
 }, z.core.$strip>;
@@ -1021,7 +1021,7 @@ type OTPErrorResponse = z.infer<typeof OTPErrorResponseSchema>;
 declare const OTPRequestRequestSchema: z.ZodObject<{
     identifier: z.ZodString;
     channel: z.ZodOptional<z.ZodEnum<typeof OTPRequestRequestChannel>>;
-    source_url: z.ZodOptional<z.ZodURL>;
+    source_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -1060,7 +1060,7 @@ declare const OTPVerifyRequestSchema: z.ZodObject<{
     identifier: z.ZodString;
     otp: z.ZodString;
     channel: z.ZodOptional<z.ZodEnum<typeof OTPVerifyRequestChannel>>;
-    source_url: z.ZodOptional<z.ZodURL>;
+    source_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -1091,7 +1091,7 @@ declare const OTPVerifyResponseSchema: z.ZodObject<{
         company: z.ZodOptional<z.ZodString>;
         phone: z.ZodOptional<z.ZodString>;
         position: z.ZodOptional<z.ZodString>;
-        avatar: z.ZodNullable<z.ZodURL>;
+        avatar: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
         is_staff: z.ZodBoolean;
         is_superuser: z.ZodBoolean;
         date_joined: z.ZodISODateTime;
@@ -1099,7 +1099,7 @@ declare const OTPVerifyResponseSchema: z.ZodObject<{
         unanswered_messages_count: z.ZodInt;
         centrifugo: z.ZodNullable<z.ZodObject<{
             token: z.ZodString;
-            centrifugo_url: z.ZodURL;
+            centrifugo_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
             expires_at: z.ZodISODateTime;
             channels: z.ZodArray<z.ZodString>;
         }, z.core.$strip>>;
@@ -1182,7 +1182,7 @@ declare const UserSchema: z.ZodObject<{
     company: z.ZodOptional<z.ZodString>;
     phone: z.ZodOptional<z.ZodString>;
     position: z.ZodOptional<z.ZodString>;
-    avatar: z.ZodNullable<z.ZodURL>;
+    avatar: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     is_staff: z.ZodBoolean;
     is_superuser: z.ZodBoolean;
     date_joined: z.ZodISODateTime;
@@ -1190,7 +1190,7 @@ declare const UserSchema: z.ZodObject<{
     unanswered_messages_count: z.ZodInt;
     centrifugo: z.ZodNullable<z.ZodObject<{
         token: z.ZodString;
-        centrifugo_url: z.ZodURL;
+        centrifugo_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
         expires_at: z.ZodISODateTime;
         channels: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
@@ -1503,30 +1503,38 @@ declare namespace index$4 {
 }
 
 /**
- * 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)
@@ -1535,11 +1543,12 @@ declare namespace index$4 {
 
 /**
  * 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$1(): API$1;
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 declare function isAPIConfigured$1(): boolean;
 /**
@@ -2287,8 +2296,8 @@ declare class MemoryStorageAdapter implements StorageAdapter {
 declare const SendPushRequestRequestSchema: z.ZodObject<{
     title: z.ZodString;
     body: z.ZodString;
-    icon: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
-    url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    icon: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -2325,7 +2334,7 @@ type SendPushResponse = z.infer<typeof SendPushResponseSchema>;
  * Request serializer for subscribing to push notifications.
  */
 declare const SubscribeRequestRequestSchema: z.ZodObject<{
-    endpoint: z.ZodURL;
+    endpoint: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     keys: z.ZodRecord<z.ZodString, z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -2533,30 +2542,38 @@ declare namespace index$1 {
 }
 
 /**
- * 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)
@@ -2565,11 +2582,12 @@ declare namespace index$1 {
 
 /**
  * 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

@@ -821,7 +821,7 @@ declare class MemoryStorageAdapter$1 implements StorageAdapter$1 {
  */
 declare const CentrifugoTokenSchema: z.ZodObject<{
     token: z.ZodString;
-    centrifugo_url: z.ZodURL;
+    centrifugo_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     expires_at: z.ZodISODateTime;
     channels: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -841,8 +841,8 @@ type CentrifugoToken = z.infer<typeof CentrifugoTokenSchema>;
  * Request to start OAuth flow.
  */
 declare const OAuthAuthorizeRequestRequestSchema: z.ZodObject<{
-    redirect_uri: z.ZodOptional<z.ZodURL>;
-    source_url: z.ZodOptional<z.ZodURL>;
+    redirect_uri: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
+    source_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -860,7 +860,7 @@ type OAuthAuthorizeRequestRequest = z.infer<typeof OAuthAuthorizeRequestRequestS
  * Response with OAuth authorization URL.
  */
 declare const OAuthAuthorizeResponseSchema: z.ZodObject<{
-    authorization_url: z.ZodURL;
+    authorization_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     state: z.ZodString;
 }, z.core.$strip>;
 /**
@@ -881,7 +881,7 @@ type OAuthAuthorizeResponse = z.infer<typeof OAuthAuthorizeResponseSchema>;
 declare const OAuthCallbackRequestRequestSchema: z.ZodObject<{
     code: z.ZodString;
     state: z.ZodString;
-    redirect_uri: z.ZodOptional<z.ZodURL>;
+    redirect_uri: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -904,7 +904,7 @@ declare const OAuthConnectionSchema: z.ZodObject<{
     provider_display: z.ZodString;
     provider_username: z.ZodString;
     provider_email: z.ZodEmail;
-    provider_avatar_url: z.ZodURL;
+    provider_avatar_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     connected_at: z.ZodISODateTime;
     last_login_at: z.ZodISODateTime;
 }, z.core.$strip>;
@@ -961,7 +961,7 @@ type OAuthError = z.infer<typeof OAuthErrorSchema>;
  * Response with available OAuth providers.
  */
 declare const OAuthProvidersResponseSchema: z.ZodObject<{
-    providers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    providers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -981,7 +981,7 @@ type OAuthProvidersResponse = z.infer<typeof OAuthProvidersResponseSchema>;
 declare const OAuthTokenResponseSchema: z.ZodObject<{
     access: z.ZodString;
     refresh: z.ZodString;
-    user: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>>;
+    user: z.ZodRecord<z.ZodString, z.ZodAny>;
     is_new_user: z.ZodBoolean;
     is_new_connection: z.ZodBoolean;
 }, z.core.$strip>;
@@ -1021,7 +1021,7 @@ type OTPErrorResponse = z.infer<typeof OTPErrorResponseSchema>;
 declare const OTPRequestRequestSchema: z.ZodObject<{
     identifier: z.ZodString;
     channel: z.ZodOptional<z.ZodEnum<typeof OTPRequestRequestChannel>>;
-    source_url: z.ZodOptional<z.ZodURL>;
+    source_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -1060,7 +1060,7 @@ declare const OTPVerifyRequestSchema: z.ZodObject<{
     identifier: z.ZodString;
     otp: z.ZodString;
     channel: z.ZodOptional<z.ZodEnum<typeof OTPVerifyRequestChannel>>;
-    source_url: z.ZodOptional<z.ZodURL>;
+    source_url: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -1091,7 +1091,7 @@ declare const OTPVerifyResponseSchema: z.ZodObject<{
         company: z.ZodOptional<z.ZodString>;
         phone: z.ZodOptional<z.ZodString>;
         position: z.ZodOptional<z.ZodString>;
-        avatar: z.ZodNullable<z.ZodURL>;
+        avatar: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
         is_staff: z.ZodBoolean;
         is_superuser: z.ZodBoolean;
         date_joined: z.ZodISODateTime;
@@ -1099,7 +1099,7 @@ declare const OTPVerifyResponseSchema: z.ZodObject<{
         unanswered_messages_count: z.ZodInt;
         centrifugo: z.ZodNullable<z.ZodObject<{
             token: z.ZodString;
-            centrifugo_url: z.ZodURL;
+            centrifugo_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
             expires_at: z.ZodISODateTime;
             channels: z.ZodArray<z.ZodString>;
         }, z.core.$strip>>;
@@ -1182,7 +1182,7 @@ declare const UserSchema: z.ZodObject<{
     company: z.ZodOptional<z.ZodString>;
     phone: z.ZodOptional<z.ZodString>;
     position: z.ZodOptional<z.ZodString>;
-    avatar: z.ZodNullable<z.ZodURL>;
+    avatar: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>;
     is_staff: z.ZodBoolean;
     is_superuser: z.ZodBoolean;
     date_joined: z.ZodISODateTime;
@@ -1190,7 +1190,7 @@ declare const UserSchema: z.ZodObject<{
     unanswered_messages_count: z.ZodInt;
     centrifugo: z.ZodNullable<z.ZodObject<{
         token: z.ZodString;
-        centrifugo_url: z.ZodURL;
+        centrifugo_url: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
         expires_at: z.ZodISODateTime;
         channels: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
@@ -1503,30 +1503,38 @@ declare namespace index$4 {
 }
 
 /**
- * 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)
@@ -1535,11 +1543,12 @@ declare namespace index$4 {
 
 /**
  * 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$1(): API$1;
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 declare function isAPIConfigured$1(): boolean;
 /**
@@ -2287,8 +2296,8 @@ declare class MemoryStorageAdapter implements StorageAdapter {
 declare const SendPushRequestRequestSchema: z.ZodObject<{
     title: z.ZodString;
     body: z.ZodString;
-    icon: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
-    url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    icon: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>>>;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -2325,7 +2334,7 @@ type SendPushResponse = z.infer<typeof SendPushResponseSchema>;
  * Request serializer for subscribing to push notifications.
  */
 declare const SubscribeRequestRequestSchema: z.ZodObject<{
-    endpoint: z.ZodURL;
+    endpoint: z.ZodUnion<readonly [z.ZodURL, z.ZodLiteral<"">]>;
     keys: z.ZodRecord<z.ZodString, z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -2533,30 +2542,38 @@ declare namespace index$1 {
 }
 
 /**
- * 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)
@@ -2565,11 +2582,12 @@ declare namespace index$1 {
 
 /**
  * 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;
 /**