@djangocfg/ext-knowbase 1.0.8 → 1.0.10

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 'swr';
 import { createExtensionConfig } from '@djangocfg/ext-base';
 
@@ -309,7 +309,14 @@ var ExtKnowbaseKnowbase = class {
    * Upload archive file and process it synchronously
    */
   async systemArchivesCreate(data) {
-    const response = await this.client.request("POST", "/cfg/knowbase/system/archives/", { formData: data });
+    const formData = new FormData();
+    formData.append("file", data.file);
+    if (data.title !== void 0) formData.append("title", String(data.title));
+    if (data.description !== void 0) formData.append("description", String(data.description));
+    if (data.category_ids !== void 0) formData.append("category_ids", String(data.category_ids));
+    if (data.is_public !== void 0) formData.append("is_public", String(data.is_public));
+    if (data.process_immediately !== void 0) formData.append("process_immediately", String(data.process_immediately));
+    const response = await this.client.request("POST", "/cfg/knowbase/system/archives/", { formData });
     return response;
   }
   /**
@@ -576,7 +583,7 @@ var models_exports = {};
 // src/api/generated/ext_knowbase/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();
@@ -594,6 +601,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);
@@ -918,11 +928,13 @@ var APIClient = class {
   httpClient;
   logger = null;
   retryConfig = null;
+  tokenGetter = null;
   // Sub-clients
   ext_knowbase_knowbase;
   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);
     }
@@ -945,6 +957,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.
@@ -975,7 +1000,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) {
@@ -994,7 +1019,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) {
@@ -1378,6 +1404,7 @@ __export(schemas_exports, {
   ArchiveSearchRequestRequestSchema: () => ArchiveSearchRequestRequestSchema,
   ArchiveSearchResultSchema: () => ArchiveSearchResultSchema,
   ArchiveStatisticsSchema: () => ArchiveStatisticsSchema,
+  CfgKnowbaseSystemArchivesCreateRequestSchema: () => CfgKnowbaseSystemArchivesCreateRequestSchema,
   ChatHistorySchema: () => ChatHistorySchema,
   ChatMessageSchema: () => ChatMessageSchema,
   ChatQueryRequestSchema: () => ChatQueryRequestSchema,
@@ -1513,9 +1540,9 @@ var ArchiveSearchRequestRequestSchema = z.object({
 var ArchiveSearchResultSchema = z.object({
   chunk: ArchiveItemChunkSchema,
   similarity_score: z.number(),
-  context_summary: z.record(z.string(), z.record(z.string(), z.any())),
-  archive_info: z.record(z.string(), z.record(z.string(), z.any())),
-  item_info: z.record(z.string(), z.record(z.string(), z.any()))
+  context_summary: z.record(z.string(), z.any()),
+  archive_info: z.record(z.string(), z.any()),
+  item_info: z.record(z.string(), z.any())
 });
 var ArchiveStatisticsSchema = z.object({
   total_archives: z.int(),
@@ -1529,6 +1556,14 @@ var ArchiveStatisticsSchema = z.object({
   avg_items_per_archive: z.number(),
   avg_chunks_per_archive: z.number()
 });
+var CfgKnowbaseSystemArchivesCreateRequestSchema = z.object({
+  file: z.union([z.instanceof(File), z.instanceof(Blob)]).optional(),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  category_ids: z.array(z.string()).optional(),
+  is_public: z.boolean().optional(),
+  process_immediately: z.boolean().optional()
+});
 var ChatMessageSchema = z.object({
   id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i),
   role: z.nativeEnum(ChatMessageRole),
@@ -1647,7 +1682,7 @@ var DocumentArchiveSchema = z.object({
   description: z.string().optional(),
   categories: z.array(DocumentCategorySchema),
   is_public: z.boolean().optional(),
-  archive_file: z.url(),
+  archive_file: z.union([z.url(), z.literal("")]),
   original_filename: z.string(),
   file_size: z.int(),
   archive_type: z.nativeEnum(DocumentArchiveArchiveType),
@@ -1673,7 +1708,7 @@ var DocumentArchiveDetailSchema = z.object({
   description: z.string().optional(),
   categories: z.array(DocumentCategorySchema),
   is_public: z.boolean().optional(),
-  archive_file: z.url(),
+  archive_file: z.union([z.url(), z.literal("")]),
   original_filename: z.string(),
   file_size: z.int(),
   archive_type: z.nativeEnum(DocumentArchiveDetailArchiveType),
@@ -2043,15 +2078,28 @@ __export(fetchers_exports, {
 
 // src/api/generated/ext_knowbase/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) {
@@ -4202,7 +4250,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_knowbase_knowbase = this._client.ext_knowbase_knowbase;
@@ -4214,7 +4263,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_knowbase_knowbase = this._client.ext_knowbase_knowbase;
@@ -4307,12 +4357,13 @@ var API = class {
 };
 
 // src/api/index.ts
+initializeExtensionAPI(configureAPI);
 var apiKnowbase = createExtensionAPI(API);
 
 // package.json
 var package_default = {
   name: "@djangocfg/ext-knowbase",
-  version: "1.0.8",
+  version: "1.0.10",
   description: "Knowledge base and chat extension for DjangoCFG",
   keywords: [
     "django",
@@ -4373,6 +4424,7 @@ var package_default = {
   peerDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/ui-core": "workspace:*",
     "@djangocfg/ui-nextjs": "workspace:*",
     consola: "^3.4.2",
     "lucide-react": "^0.545.0",
@@ -4388,6 +4440,7 @@ var package_default = {
   devDependencies: {
     "@djangocfg/api": "workspace:*",
     "@djangocfg/ext-base": "workspace:*",
+    "@djangocfg/ui-core": "workspace:*",
     "@djangocfg/typescript-config": "workspace:*",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
@@ -4435,4 +4488,4 @@ export default function DocsPage() {
   ]
 });
 
-export { API, APIClient, APIError, APILogger, ArchiveItemChunkDetailSchema, ArchiveItemChunkRequestSchema, ArchiveItemChunkSchema, ArchiveItemDetailSchema, ArchiveItemRequestSchema, ArchiveItemSchema, ArchiveProcessingResultSchema, ArchiveSearchRequestRequestSchema, ArchiveSearchResultSchema, ArchiveStatisticsSchema, ChatHistorySchema, ChatMessageSchema, ChatQueryRequestSchema, ChatResponseRequestSchema, ChatResponseSchema, ChatSessionCreateRequestSchema, ChatSessionRequestSchema, ChatSessionSchema, ChatSourceRequestSchema, ChatSourceSchema, ChunkRevectorizationRequestRequestSchema, CookieStorageAdapter, DEFAULT_RETRY_CONFIG, DocumentArchiveDetailSchema, DocumentArchiveListSchema, DocumentArchiveRequestSchema, DocumentArchiveSchema, DocumentCategoryRequestSchema, DocumentCategorySchema, DocumentCreateRequestSchema, DocumentProcessingStatusSchema, DocumentRequestSchema, DocumentSchema, DocumentStatsSchema, enums_exports as Enums, models_exports as ExtKnowbaseKnowbaseTypes, FetchAdapter, fetchers_exports as Fetchers, LocalStorageAdapter, MemoryStorageAdapter, NetworkError, PaginatedArchiveItemChunkListSchema, PaginatedArchiveItemListSchema, PaginatedArchiveSearchResultListSchema, PaginatedChatResponseListSchema, PaginatedChatSessionListSchema, PaginatedDocumentArchiveListListSchema, PaginatedDocumentListSchema, PaginatedPublicCategoryListSchema, PaginatedPublicDocumentListListSchema, PatchedArchiveItemChunkRequestSchema, PatchedArchiveItemRequestSchema, PatchedChatResponseRequestSchema, PatchedChatSessionRequestSchema, PatchedDocumentArchiveRequestSchema, PatchedDocumentRequestSchema, PublicCategorySchema, PublicDocumentListSchema, PublicDocumentSchema, REFRESH_TOKEN_KEY, schemas_exports as Schemas, TOKEN_KEY, VectorizationResultSchema, VectorizationStatisticsSchema, apiKnowbase, clearAPITokens, configureAPI, createKnowbaseAdminChatCreate, createKnowbaseAdminChatQueryCreate, createKnowbaseAdminDocumentsCreate, createKnowbaseAdminDocumentsReprocessCreate, createKnowbaseAdminSessionsActivateCreate, createKnowbaseAdminSessionsArchiveCreate, createKnowbaseAdminSessionsCreate, createKnowbaseSystemArchivesCreate, createKnowbaseSystemArchivesRevectorizeCreate, createKnowbaseSystemArchivesSearchCreate, createKnowbaseSystemChunksCreate, createKnowbaseSystemChunksVectorizeCreate, createKnowbaseSystemItemsCreate, deleteKnowbaseAdminChatDestroy, deleteKnowbaseAdminDocumentsDestroy, deleteKnowbaseAdminSessionsDestroy, deleteKnowbaseSystemArchivesDestroy, deleteKnowbaseSystemChunksDestroy, deleteKnowbaseSystemItemsDestroy, dispatchValidationError, extensionConfig, formatZodError, getAPIInstance, getKnowbaseAdminChatHistoryRetrieve, getKnowbaseAdminChatList, getKnowbaseAdminChatRetrieve, getKnowbaseAdminDocumentsList, getKnowbaseAdminDocumentsRetrieve, getKnowbaseAdminDocumentsStatsRetrieve, getKnowbaseAdminDocumentsStatusRetrieve, getKnowbaseAdminSessionsList, getKnowbaseAdminSessionsRetrieve, getKnowbaseCategoriesList, getKnowbaseCategoriesRetrieve, getKnowbaseDocumentsList, getKnowbaseDocumentsRetrieve, getKnowbaseSystemArchivesFileTreeRetrieve, getKnowbaseSystemArchivesItemsList, getKnowbaseSystemArchivesList, getKnowbaseSystemArchivesRetrieve, getKnowbaseSystemArchivesStatisticsRetrieve, getKnowbaseSystemArchivesVectorizationStatsRetrieve, getKnowbaseSystemChunksContextRetrieve, getKnowbaseSystemChunksList, getKnowbaseSystemChunksRetrieve, getKnowbaseSystemItemsChunksList, getKnowbaseSystemItemsContentRetrieve, getKnowbaseSystemItemsList, getKnowbaseSystemItemsRetrieve, isAPIConfigured, onValidationError, partialUpdateKnowbaseAdminChatPartialUpdate, partialUpdateKnowbaseAdminDocumentsPartialUpdate, partialUpdateKnowbaseAdminSessionsPartialUpdate, partialUpdateKnowbaseSystemArchivesPartialUpdate, partialUpdateKnowbaseSystemChunksPartialUpdate, partialUpdateKnowbaseSystemItemsPartialUpdate, reconfigureAPI, resetAPI, shouldRetry, updateKnowbaseAdminChatUpdate, updateKnowbaseAdminDocumentsUpdate, updateKnowbaseAdminSessionsUpdate, updateKnowbaseSystemArchivesUpdate, updateKnowbaseSystemChunksUpdate, updateKnowbaseSystemItemsUpdate, withRetry };
+export { API, APIClient, APIError, APILogger, ArchiveItemChunkDetailSchema, ArchiveItemChunkRequestSchema, ArchiveItemChunkSchema, ArchiveItemDetailSchema, ArchiveItemRequestSchema, ArchiveItemSchema, ArchiveProcessingResultSchema, ArchiveSearchRequestRequestSchema, ArchiveSearchResultSchema, ArchiveStatisticsSchema, CfgKnowbaseSystemArchivesCreateRequestSchema, ChatHistorySchema, ChatMessageSchema, ChatQueryRequestSchema, ChatResponseRequestSchema, ChatResponseSchema, ChatSessionCreateRequestSchema, ChatSessionRequestSchema, ChatSessionSchema, ChatSourceRequestSchema, ChatSourceSchema, ChunkRevectorizationRequestRequestSchema, CookieStorageAdapter, DEFAULT_RETRY_CONFIG, DocumentArchiveDetailSchema, DocumentArchiveListSchema, DocumentArchiveRequestSchema, DocumentArchiveSchema, DocumentCategoryRequestSchema, DocumentCategorySchema, DocumentCreateRequestSchema, DocumentProcessingStatusSchema, DocumentRequestSchema, DocumentSchema, DocumentStatsSchema, enums_exports as Enums, models_exports as ExtKnowbaseKnowbaseTypes, FetchAdapter, fetchers_exports as Fetchers, LocalStorageAdapter, MemoryStorageAdapter, NetworkError, PaginatedArchiveItemChunkListSchema, PaginatedArchiveItemListSchema, PaginatedArchiveSearchResultListSchema, PaginatedChatResponseListSchema, PaginatedChatSessionListSchema, PaginatedDocumentArchiveListListSchema, PaginatedDocumentListSchema, PaginatedPublicCategoryListSchema, PaginatedPublicDocumentListListSchema, PatchedArchiveItemChunkRequestSchema, PatchedArchiveItemRequestSchema, PatchedChatResponseRequestSchema, PatchedChatSessionRequestSchema, PatchedDocumentArchiveRequestSchema, PatchedDocumentRequestSchema, PublicCategorySchema, PublicDocumentListSchema, PublicDocumentSchema, REFRESH_TOKEN_KEY, schemas_exports as Schemas, TOKEN_KEY, VectorizationResultSchema, VectorizationStatisticsSchema, apiKnowbase, clearAPITokens, configureAPI, createKnowbaseAdminChatCreate, createKnowbaseAdminChatQueryCreate, createKnowbaseAdminDocumentsCreate, createKnowbaseAdminDocumentsReprocessCreate, createKnowbaseAdminSessionsActivateCreate, createKnowbaseAdminSessionsArchiveCreate, createKnowbaseAdminSessionsCreate, createKnowbaseSystemArchivesCreate, createKnowbaseSystemArchivesRevectorizeCreate, createKnowbaseSystemArchivesSearchCreate, createKnowbaseSystemChunksCreate, createKnowbaseSystemChunksVectorizeCreate, createKnowbaseSystemItemsCreate, deleteKnowbaseAdminChatDestroy, deleteKnowbaseAdminDocumentsDestroy, deleteKnowbaseAdminSessionsDestroy, deleteKnowbaseSystemArchivesDestroy, deleteKnowbaseSystemChunksDestroy, deleteKnowbaseSystemItemsDestroy, dispatchValidationError, extensionConfig, formatZodError, getAPIInstance, getKnowbaseAdminChatHistoryRetrieve, getKnowbaseAdminChatList, getKnowbaseAdminChatRetrieve, getKnowbaseAdminDocumentsList, getKnowbaseAdminDocumentsRetrieve, getKnowbaseAdminDocumentsStatsRetrieve, getKnowbaseAdminDocumentsStatusRetrieve, getKnowbaseAdminSessionsList, getKnowbaseAdminSessionsRetrieve, getKnowbaseCategoriesList, getKnowbaseCategoriesRetrieve, getKnowbaseDocumentsList, getKnowbaseDocumentsRetrieve, getKnowbaseSystemArchivesFileTreeRetrieve, getKnowbaseSystemArchivesItemsList, getKnowbaseSystemArchivesList, getKnowbaseSystemArchivesRetrieve, getKnowbaseSystemArchivesStatisticsRetrieve, getKnowbaseSystemArchivesVectorizationStatsRetrieve, getKnowbaseSystemChunksContextRetrieve, getKnowbaseSystemChunksList, getKnowbaseSystemChunksRetrieve, getKnowbaseSystemItemsChunksList, getKnowbaseSystemItemsContentRetrieve, getKnowbaseSystemItemsList, getKnowbaseSystemItemsRetrieve, isAPIConfigured, onValidationError, partialUpdateKnowbaseAdminChatPartialUpdate, partialUpdateKnowbaseAdminDocumentsPartialUpdate, partialUpdateKnowbaseAdminSessionsPartialUpdate, partialUpdateKnowbaseSystemArchivesPartialUpdate, partialUpdateKnowbaseSystemChunksPartialUpdate, partialUpdateKnowbaseSystemItemsPartialUpdate, reconfigureAPI, resetAPI, shouldRetry, updateKnowbaseAdminChatUpdate, updateKnowbaseAdminDocumentsUpdate, updateKnowbaseAdminSessionsUpdate, updateKnowbaseSystemArchivesUpdate, updateKnowbaseSystemChunksUpdate, updateKnowbaseSystemItemsUpdate, withRetry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ext-knowbase",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Knowledge base and chat extension for DjangoCFG",
   "keywords": [
     "django",
@@ -59,9 +59,10 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.91",
+    "@djangocfg/api": "^2.1.107",
     "@djangocfg/ext-base": "^1.0.8",
-    "@djangocfg/ui-nextjs": "^2.1.91",
+    "@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",
@@ -74,9 +75,10 @@
     "moment": "^2.30.1"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.91",
+    "@djangocfg/api": "^2.1.107",
     "@djangocfg/ext-base": "^1.0.8",
-    "@djangocfg/typescript-config": "^2.1.91",
+    "@djangocfg/ui-core": "^2.1.107",
+    "@djangocfg/typescript-config": "^2.1.107",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     "consola": "^3.4.2",

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

@@ -12,7 +12,7 @@ python manage.py generate_client --groups ext_knowbase --typescript
 |---|---|
 | Version | 3.0.3 |
 | Operations | 57 |
-| Schemas | 52 |
+| Schemas | 53 |
 
 ## Resources
 
@@ -53,12 +53,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_knowbase/_utils/fetchers/ext_knowbase__knowbase.ts

@@ -40,6 +40,7 @@ import { ArchiveItemRequestSchema, type ArchiveItemRequest } from '../schemas/Ar
 import { ArchiveProcessingResultSchema, type ArchiveProcessingResult } from '../schemas/ArchiveProcessingResult.schema'
 import { ArchiveSearchRequestRequestSchema, type ArchiveSearchRequestRequest } from '../schemas/ArchiveSearchRequestRequest.schema'
 import { ArchiveStatisticsSchema, type ArchiveStatistics } from '../schemas/ArchiveStatistics.schema'
+import { CfgKnowbaseSystemArchivesCreateRequestSchema, type CfgKnowbaseSystemArchivesCreateRequest } from '../schemas/CfgKnowbaseSystemArchivesCreateRequest.schema'
 import { ChatHistorySchema, type ChatHistory } from '../schemas/ChatHistory.schema'
 import { ChatQueryRequestSchema, type ChatQueryRequest } from '../schemas/ChatQueryRequest.schema'
 import { ChatResponseSchema, type ChatResponse } from '../schemas/ChatResponse.schema'
@@ -1664,7 +1665,7 @@ export async function getKnowbaseSystemArchivesList(  params?: { page?: number;
  * @method POST
  * @path /cfg/knowbase/system/archives/
  */
-export async function createKnowbaseSystemArchivesCreate(  data: any,  client?: any
+export async function createKnowbaseSystemArchivesCreate(  data: CfgKnowbaseSystemArchivesCreateRequest,  client?: any
 ): Promise<ArchiveProcessingResult> {
   const api = client || getAPIInstance()
   const response = await api.ext_knowbase_knowbase.systemArchivesCreate(data)

package/src/api/generated/ext_knowbase/_utils/hooks/ext_knowbase__knowbase.ts

@@ -30,6 +30,7 @@ import type { ArchiveItemRequest } from '../schemas/ArchiveItemRequest.schema'
 import type { ArchiveProcessingResult } from '../schemas/ArchiveProcessingResult.schema'
 import type { ArchiveSearchRequestRequest } from '../schemas/ArchiveSearchRequestRequest.schema'
 import type { ArchiveStatistics } from '../schemas/ArchiveStatistics.schema'
+import type { CfgKnowbaseSystemArchivesCreateRequest } from '../schemas/CfgKnowbaseSystemArchivesCreateRequest.schema'
 import type { ChatHistory } from '../schemas/ChatHistory.schema'
 import type { ChatQueryRequest } from '../schemas/ChatQueryRequest.schema'
 import type { ChatResponse } from '../schemas/ChatResponse.schema'
@@ -563,7 +564,7 @@ export function useKnowbaseSystemArchivesList(params?: { page?: number; page_siz
 export function useCreateKnowbaseSystemArchivesCreate() {
   const { mutate } = useSWRConfig()
 
-  return async (data: any, client?: API): Promise<ArchiveProcessingResult> => {
+  return async (data: CfgKnowbaseSystemArchivesCreateRequest, client?: API): Promise<ArchiveProcessingResult> => {
     const result = await Fetchers.createKnowbaseSystemArchivesCreate(data, client)
     // Revalidate related queries
     mutate('cfg-knowbase-system-archives')

package/src/api/generated/ext_knowbase/_utils/schemas/ArchiveSearchResult.schema.ts

@@ -13,9 +13,9 @@ import { ArchiveItemChunkSchema } from './ArchiveItemChunk.schema'
 export const ArchiveSearchResultSchema = z.object({
   chunk: ArchiveItemChunkSchema,
   similarity_score: z.number(),
-  context_summary: z.record(z.string(), z.record(z.string(), z.any())),
-  archive_info: z.record(z.string(), z.record(z.string(), z.any())),
-  item_info: z.record(z.string(), z.record(z.string(), z.any())),
+  context_summary: z.record(z.string(), z.any()),
+  archive_info: z.record(z.string(), z.any()),
+  item_info: z.record(z.string(), z.any()),
 })
 
 /**

package/src/api/generated/ext_knowbase/_utils/schemas/CfgKnowbaseSystemArchivesCreateRequest.schema.ts

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for CfgKnowbaseSystemArchivesCreateRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  */
+import { z } from 'zod'
+
+export const CfgKnowbaseSystemArchivesCreateRequestSchema = z.object({
+  file: z.union([z.instanceof(File), z.instanceof(Blob)]).optional(),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  category_ids: z.array(z.string()).optional(),
+  is_public: z.boolean().optional(),
+  process_immediately: z.boolean().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type CfgKnowbaseSystemArchivesCreateRequest = z.infer<typeof CfgKnowbaseSystemArchivesCreateRequestSchema>

package/src/api/generated/ext_knowbase/_utils/schemas/DocumentArchive.schema.ts

@@ -17,7 +17,7 @@ export const DocumentArchiveSchema = z.object({
   description: z.string().optional(),
   categories: z.array(DocumentCategorySchema),
   is_public: z.boolean().optional(),
-  archive_file: z.url(),
+  archive_file: z.union([z.url(), z.literal('')]),
   original_filename: z.string(),
   file_size: z.int(),
   archive_type: z.nativeEnum(Enums.DocumentArchiveArchiveType),

package/src/api/generated/ext_knowbase/_utils/schemas/DocumentArchiveDetail.schema.ts

@@ -18,7 +18,7 @@ export const DocumentArchiveDetailSchema = z.object({
   description: z.string().optional(),
   categories: z.array(DocumentCategorySchema),
   is_public: z.boolean().optional(),
-  archive_file: z.url(),
+  archive_file: z.union([z.url(), z.literal('')]),
   original_filename: z.string(),
   file_size: z.int(),
   archive_type: z.nativeEnum(Enums.DocumentArchiveDetailArchiveType),

package/src/api/generated/ext_knowbase/_utils/schemas/index.ts

@@ -27,6 +27,7 @@ export * from './ArchiveProcessingResult.schema'
 export * from './ArchiveSearchRequestRequest.schema'
 export * from './ArchiveSearchResult.schema'
 export * from './ArchiveStatistics.schema'
+export * from './CfgKnowbaseSystemArchivesCreateRequest.schema'
 export * from './ChatHistory.schema'
 export * from './ChatMessage.schema'
 export * from './ChatQueryRequest.schema'

package/src/api/generated/ext_knowbase/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_knowbase/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_knowbase_knowbase: ExtKnowbaseKnowbase;
@@ -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_knowbase/ext_knowbase__knowbase/client.ts

@@ -356,8 +356,15 @@ export class ExtKnowbaseKnowbase {
    * 
    * Upload archive file and process it synchronously
    */
-  async systemArchivesCreate(data: FormData): Promise<Models.ArchiveProcessingResult> {
-    const response = await this.client.request('POST', "/cfg/knowbase/system/archives/", { formData: data });
+  async systemArchivesCreate(data: Models.CfgKnowbaseSystemArchivesCreateRequest): Promise<Models.ArchiveProcessingResult> {
+    const formData = new FormData();
+    formData.append('file', data.file);
+    if (data.title !== undefined) formData.append('title', String(data.title));
+    if (data.description !== undefined) formData.append('description', String(data.description));
+    if (data.category_ids !== undefined) formData.append('category_ids', String(data.category_ids));
+    if (data.is_public !== undefined) formData.append('is_public', String(data.is_public));
+    if (data.process_immediately !== undefined) formData.append('process_immediately', String(data.process_immediately));
+    const response = await this.client.request('POST', "/cfg/knowbase/system/archives/", { formData });
     return response;
   }
 

package/src/api/generated/ext_knowbase/ext_knowbase__knowbase/models.ts

@@ -434,6 +434,19 @@ export interface PaginatedDocumentArchiveListList {
   results: Array<DocumentArchiveList>;
 }
 
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface CfgKnowbaseSystemArchivesCreateRequest {
+  file?: File | Blob;
+  title?: string;
+  description?: string;
+  category_ids?: Array<string>;
+  is_public?: boolean;
+  process_immediately?: boolean;
+}
+
 /**
  * Archive processing result serializer.
  *