@gpt-core/admin 0.10.13 → 0.10.21

package/README.md

@@ -32,8 +32,11 @@ AI_CONTEXT_END -->
 > **TL;DR for Claude, Cursor, Copilot, and other AI assistants:**
 >
 > ```typescript
-> import { GptAdmin } from '@gpt-core/admin';
-> const admin = new GptAdmin({ baseUrl: 'https://api.example.com', token: 'admin-jwt' });
+> import { GptAdmin } from "@gpt-core/admin";
+> const admin = new GptAdmin({
+>   baseUrl: "https://api.example.com",
+>   token: "admin-jwt",
+> });
 > ```
 >
 > **Common operations:**
@@ -75,12 +78,12 @@ pnpm add @gpt-core/admin
 ## Quick Start
 
 ```typescript
-import { GptAdmin } from '@gpt-core/admin';
+import { GptAdmin } from "@gpt-core/admin";
 
 // Initialize admin client
 const admin = new GptAdmin({
-  baseUrl: 'https://api.gpt-core.com',
-  token: process.env.ADMIN_JWT_TOKEN,    // Admin JWT token
+  baseUrl: "https://api.gpt-core.com",
+  token: process.env.ADMIN_JWT_TOKEN, // Admin JWT token
   applicationId: process.env.APPLICATION_ID, // Your application ID
 });
 
@@ -91,7 +94,9 @@ console.log(`Total files: ${stats.file_count}`);
 
 // List webhook configurations
 const webhooks = await admin.webhooks.configs.list();
-console.log(`Active webhooks: ${webhooks.filter(w => w.attributes.enabled).length}`);
+console.log(
+  `Active webhooks: ${webhooks.filter((w) => w.attributes.enabled).length}`,
+);
 ```
 
 ## Configuration
@@ -99,13 +104,13 @@ console.log(`Active webhooks: ${webhooks.filter(w => w.attributes.enabled).lengt
 ```typescript
 const admin = new GptAdmin({
   // Required: API base URL
-  baseUrl: 'https://api.gpt-core.com',
+  baseUrl: "https://api.gpt-core.com",
 
   // Required: Admin JWT token
-  token: 'admin-jwt-token',
+  token: "admin-jwt-token",
 
   // Required: Application ID
-  applicationId: 'your-app-id',
+  applicationId: "your-app-id",
 });
 ```
 
@@ -120,7 +125,7 @@ APPLICATION_ID=your-application-id
 
 ```typescript
 // lib/admin-client.ts
-import { GptAdmin } from '@gpt-core/admin';
+import { GptAdmin } from "@gpt-core/admin";
 
 export const admin = new GptAdmin({
   baseUrl: process.env.ADMIN_API_URL!,
@@ -149,10 +154,10 @@ Pin a specific API version to protect your integration from breaking changes:
 
 ```typescript
 const admin = new GptAdmin({
-  baseUrl: 'https://api.gpt-core.com',
+  baseUrl: "https://api.gpt-core.com",
   token: process.env.ADMIN_JWT_TOKEN,
   applicationId: process.env.APPLICATION_ID,
-  apiVersion: '2025-12-03',  // Pin to this version
+  apiVersion: "2025-12-03", // Pin to this version
 });
 ```
 
@@ -195,35 +200,35 @@ const configs = await admin.webhooks.configs.list();
 
 ```typescript
 const webhook = await admin.webhooks.configs.create(
-  'My Webhook',                          // name
-  'https://your-server.com/webhook',    // url
-  ['document.analyzed', 'thread.message.created'], // events
-  'app-123',                             // application_id
-  'your-webhook-secret',                 // secret (optional)
-  true                                   // enabled
+  "My Webhook", // name
+  "https://your-server.com/webhook", // url
+  ["document.analyzed", "thread.message.created"], // events
+  "app-123", // application_id
+  "your-webhook-secret", // secret (optional)
+  true, // enabled
 );
 ```
 
 #### Update Webhook Config
 
 ```typescript
-const config = await admin.webhooks.configs.update('webhook-id', {
+const config = await admin.webhooks.configs.update("webhook-id", {
   enabled: false,
-  events: ['document.analyzed'],
+  events: ["document.analyzed"],
 });
 ```
 
 #### Delete Webhook Config
 
 ```typescript
-await admin.webhooks.configs.delete('webhook-id');
+await admin.webhooks.configs.delete("webhook-id");
 ```
 
 #### Test Webhook Config
 
 ```typescript
-const result = await admin.webhooks.configs.test('webhook-id');
-console.log('Test delivery ID:', result.delivery_id);
+const result = await admin.webhooks.configs.test("webhook-id");
+console.log("Test delivery ID:", result.delivery_id);
 ```
 
 #### Webhook Deliveries
@@ -233,10 +238,10 @@ console.log('Test delivery ID:', result.delivery_id);
 const deliveries = await admin.webhooks.deliveries.list();
 
 // Get delivery details
-const delivery = await admin.webhooks.deliveries.get('delivery-id');
+const delivery = await admin.webhooks.deliveries.get("delivery-id");
 
 // Retry failed delivery
-await admin.webhooks.deliveries.retry('delivery-id');
+await admin.webhooks.deliveries.retry("delivery-id");
 ```
 
 ### Storage Administration
@@ -247,19 +252,19 @@ const stats = await admin.storage.stats();
 console.log(stats.total_size, stats.file_count);
 
 // Get stats for specific workspace
-const workspaceStats = await admin.storage.stats('workspace-id');
+const workspaceStats = await admin.storage.stats("workspace-id");
 
 // List all buckets
 const buckets = await admin.storage.buckets.list();
 
 // Get bucket details
-const bucket = await admin.storage.buckets.get('bucket-id');
+const bucket = await admin.storage.buckets.get("bucket-id");
 
 // Get bucket stats
-const bucketStats = await admin.storage.buckets.stats('bucket-id');
+const bucketStats = await admin.storage.buckets.stats("bucket-id");
 
 // List bucket objects
-const objects = await admin.storage.buckets.objects('bucket-id');
+const objects = await admin.storage.buckets.objects("bucket-id");
 ```
 
 ### Account Management
@@ -269,13 +274,13 @@ const objects = await admin.storage.buckets.objects('bucket-id');
 const accounts = await admin.accounts.list();
 
 // Get account details
-const account = await admin.accounts.get('account-id');
+const account = await admin.accounts.get("account-id");
 
 // Credit an account
-await admin.accounts.credit('account-id', 1000, 'Bonus credits');
+await admin.accounts.credit("account-id", 1000, "Bonus credits");
 
 // Debit an account
-await admin.accounts.debit('account-id', 500, 'Usage charge');
+await admin.accounts.debit("account-id", 500, "Usage charge");
 ```
 
 ### Document Administration
@@ -285,13 +290,13 @@ await admin.accounts.debit('account-id', 500, 'Usage charge');
 const documents = await admin.documents.list();
 
 // Get document details
-const document = await admin.documents.get('doc-id');
+const document = await admin.documents.get("doc-id");
 
 // Bulk delete documents
-await admin.documents.bulkDelete(['doc-id-1', 'doc-id-2']);
+await admin.documents.bulkDelete(["doc-id-1", "doc-id-2"]);
 
 // Bulk reprocess documents
-await admin.documents.bulkReprocess(['doc-id-1', 'doc-id-2']);
+await admin.documents.bulkReprocess(["doc-id-1", "doc-id-2"]);
 ```
 
 ### API Key Management
@@ -301,21 +306,22 @@ await admin.documents.bulkReprocess(['doc-id-1', 'doc-id-2']);
 const keys = await admin.apiKeys.list();
 
 // Get API key details
-const key = await admin.apiKeys.get('key-id');
+const key = await admin.apiKeys.get("key-id");
 
 // Allocate credits to API key
-await admin.apiKeys.allocate('key-id', 5000, 'Monthly allocation');
+await admin.apiKeys.allocate("key-id", 5000, "Monthly allocation");
 
 // Revoke API key
-await admin.apiKeys.revoke('key-id');
+await admin.apiKeys.revoke("key-id");
 
 // Rotate API key
-await admin.apiKeys.rotate('key-id');
+await admin.apiKeys.rotate("key-id");
 ```
 
 ## Webhook Events
 
 Available webhook events:
+
 - `document.uploaded`
 - `document.analyzed`
 - `document.deleted`
@@ -328,13 +334,14 @@ Available webhook events:
 ## Bulk Operations
 
 All bulk operations support:
+
 - Minimum: 1 item
 - Maximum: 100 items per request
 - Validation via Zod schemas
 
 ```typescript
 // Bulk delete up to 100 documents
-const documentIds = ['doc-1', 'doc-2', 'doc-3'];
+const documentIds = ["doc-1", "doc-2", "doc-3"];
 await admin.documents.bulkDelete(documentIds);
 
 // Bulk reprocess documents
@@ -355,12 +362,12 @@ await admin.documents.bulkReprocess(documentIds);
 
 ```typescript
 try {
-  await admin.accounts.credit('account-id', 1000);
+  await admin.accounts.credit("account-id", 1000);
 } catch (error) {
   if (error instanceof ZodError) {
-    console.error('Validation error:', error.errors);
+    console.error("Validation error:", error.errors);
   } else {
-    console.error('API error:', error);
+    console.error("API error:", error);
   }
 }
 ```
@@ -369,10 +376,10 @@ try {
 
 ```typescript
 const admin = new GptAdmin({
-  baseUrl: 'https://api.gpt-core.com',  // API base URL
-  token: 'admin-jwt-token',              // Admin JWT token
-  applicationId: 'app-id',               // Application ID
-  apiKey: 'api-key',                     // Optional: API key
+  baseUrl: "https://api.gpt-core.com", // API base URL
+  token: "admin-jwt-token", // Admin JWT token
+  applicationId: "app-id", // Application ID
+  apiKey: "api-key", // Optional: API key
 });
 ```
 
@@ -387,8 +394,8 @@ import type {
   Account,
   Document,
   ApiKey,
-  Bucket
-} from '@gpt-core/admin';
+  Bucket,
+} from "@gpt-core/admin";
 ```
 
 ## Testing