@gpt-core/admin 0.10.20 → 0.11.0

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

package/dist/index.d.mts

@@ -30,7 +30,7 @@ declare abstract class BaseClient {
     constructor(config?: BaseClientConfig);
     protected unwrap<T>(resource: unknown): T;
     protected getHeaders(): {
-        'x-application-key': string;
+        "x-application-key": string;
     };
 }
 

package/dist/index.d.ts

@@ -30,7 +30,7 @@ declare abstract class BaseClient {
     constructor(config?: BaseClientConfig);
     protected unwrap<T>(resource: unknown): T;
     protected getHeaders(): {
-        'x-application-key': string;
+        "x-application-key": string;
     };
 }
 

package/dist/index.js

@@ -873,7 +873,8 @@ function isSecureUrl(url) {
   try {
     const parsed = new URL(url);
     if (parsed.protocol === "https:") return true;
-    if (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1") return true;
+    if (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1")
+      return true;
     return false;
   } catch {
     return false;
@@ -898,7 +899,10 @@ var BaseClient = class {
           "[GPT Core SDK] Warning: Sending credentials over non-HTTPS connection."
         );
       }
-      req.headers.set("Accept", `application/vnd.api+json; version=${this.apiVersion}`);
+      req.headers.set(
+        "Accept",
+        `application/vnd.api+json; version=${this.apiVersion}`
+      );
       req.headers.set("Content-Type", "application/vnd.api+json");
       if (config.apiKey) {
         req.headers.set("x-application-key", config.apiKey);
@@ -1226,7 +1230,9 @@ var GptAdmin = class extends BaseClient {
        * Get storage statistics
        */
       stats: async (workspaceId) => {
-        const validated = StorageStatsRequestSchema.parse({ workspace_id: workspaceId });
+        const validated = StorageStatsRequestSchema.parse({
+          workspace_id: workspaceId
+        });
         const { data } = await getAdminStorageStats({
           headers: this.getHeaders(),
           query: validated.workspace_id ? { filter: { workspace_id: validated.workspace_id } } : void 0
@@ -1316,7 +1322,9 @@ var GptAdmin = class extends BaseClient {
     this.webhooks = {
       configs: {
         list: async () => {
-          const { data } = await getAdminWebhookConfigs({ headers: this.getHeaders() });
+          const { data } = await getAdminWebhookConfigs({
+            headers: this.getHeaders()
+          });
           return this.unwrap(data?.data);
         },
         create: async (name, url, events, applicationId, secret, enabled = true) => {
@@ -1376,7 +1384,9 @@ var GptAdmin = class extends BaseClient {
       },
       deliveries: {
         list: async () => {
-          const { data } = await getAdminWebhookDeliveries({ headers: this.getHeaders() });
+          const { data } = await getAdminWebhookDeliveries({
+            headers: this.getHeaders()
+          });
           return this.unwrap(data?.data);
         },
         get: async (id) => {
@@ -1400,7 +1410,9 @@ var GptAdmin = class extends BaseClient {
      */
     this.documents = {
       list: async () => {
-        const { data } = await getAdminExtractionDocuments({ headers: this.getHeaders() });
+        const { data } = await getAdminExtractionDocuments({
+          headers: this.getHeaders()
+        });
         return this.unwrap(data?.data);
       },
       get: async (id) => {
@@ -1411,11 +1423,15 @@ var GptAdmin = class extends BaseClient {
         return this.unwrap(data?.data);
       },
       stats: async () => {
-        const { data } = await getAdminDocumentsStats({ headers: this.getHeaders() });
+        const { data } = await getAdminDocumentsStats({
+          headers: this.getHeaders()
+        });
         return this.unwrap(data?.data);
       },
       bulkDelete: async (documentIds) => {
-        const validated = DocumentBulkDeleteSchema.parse({ document_ids: documentIds });
+        const validated = DocumentBulkDeleteSchema.parse({
+          document_ids: documentIds
+        });
         const { data } = await postAdminDocumentsBulkDelete({
           headers: this.getHeaders(),
           body: {
@@ -1573,7 +1589,9 @@ function handleApiError(error) {
     const entries = hdrs instanceof Headers ? Array.from(hdrs.entries()) : Object.entries(hdrs);
     const filtered = entries.filter(([key]) => {
       const lowerKey = key.toLowerCase();
-      return !sensitiveHeaderPatterns.some((pattern) => lowerKey.includes(pattern));
+      return !sensitiveHeaderPatterns.some(
+        (pattern) => lowerKey.includes(pattern)
+      );
     });
     return filtered.length > 0 ? Object.fromEntries(filtered) : void 0;
   };
@@ -1596,7 +1614,11 @@ function handleApiError(error) {
       throw new ValidationError(message, errors, errorOptions);
     case 429: {
       const retryAfter = headers?.get?.("retry-after") || headers?.["retry-after"];
-      throw new RateLimitError(message, retryAfter ? parseInt(retryAfter, 10) : void 0, errorOptions);
+      throw new RateLimitError(
+        message,
+        retryAfter ? parseInt(retryAfter, 10) : void 0,
+        errorOptions
+      );
     }
     case 500:
     case 502:

package/dist/index.mjs

@@ -824,7 +824,8 @@ function isSecureUrl(url) {
   try {
     const parsed = new URL(url);
     if (parsed.protocol === "https:") return true;
-    if (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1") return true;
+    if (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1")
+      return true;
     return false;
   } catch {
     return false;
@@ -849,7 +850,10 @@ var BaseClient = class {
           "[GPT Core SDK] Warning: Sending credentials over non-HTTPS connection."
         );
       }
-      req.headers.set("Accept", `application/vnd.api+json; version=${this.apiVersion}`);
+      req.headers.set(
+        "Accept",
+        `application/vnd.api+json; version=${this.apiVersion}`
+      );
       req.headers.set("Content-Type", "application/vnd.api+json");
       if (config.apiKey) {
         req.headers.set("x-application-key", config.apiKey);
@@ -1177,7 +1181,9 @@ var GptAdmin = class extends BaseClient {
        * Get storage statistics
        */
       stats: async (workspaceId) => {
-        const validated = StorageStatsRequestSchema.parse({ workspace_id: workspaceId });
+        const validated = StorageStatsRequestSchema.parse({
+          workspace_id: workspaceId
+        });
         const { data } = await getAdminStorageStats({
           headers: this.getHeaders(),
           query: validated.workspace_id ? { filter: { workspace_id: validated.workspace_id } } : void 0
@@ -1267,7 +1273,9 @@ var GptAdmin = class extends BaseClient {
     this.webhooks = {
       configs: {
         list: async () => {
-          const { data } = await getAdminWebhookConfigs({ headers: this.getHeaders() });
+          const { data } = await getAdminWebhookConfigs({
+            headers: this.getHeaders()
+          });
           return this.unwrap(data?.data);
         },
         create: async (name, url, events, applicationId, secret, enabled = true) => {
@@ -1327,7 +1335,9 @@ var GptAdmin = class extends BaseClient {
       },
       deliveries: {
         list: async () => {
-          const { data } = await getAdminWebhookDeliveries({ headers: this.getHeaders() });
+          const { data } = await getAdminWebhookDeliveries({
+            headers: this.getHeaders()
+          });
           return this.unwrap(data?.data);
         },
         get: async (id) => {
@@ -1351,7 +1361,9 @@ var GptAdmin = class extends BaseClient {
      */
     this.documents = {
       list: async () => {
-        const { data } = await getAdminExtractionDocuments({ headers: this.getHeaders() });
+        const { data } = await getAdminExtractionDocuments({
+          headers: this.getHeaders()
+        });
         return this.unwrap(data?.data);
       },
       get: async (id) => {
@@ -1362,11 +1374,15 @@ var GptAdmin = class extends BaseClient {
         return this.unwrap(data?.data);
       },
       stats: async () => {
-        const { data } = await getAdminDocumentsStats({ headers: this.getHeaders() });
+        const { data } = await getAdminDocumentsStats({
+          headers: this.getHeaders()
+        });
         return this.unwrap(data?.data);
       },
       bulkDelete: async (documentIds) => {
-        const validated = DocumentBulkDeleteSchema.parse({ document_ids: documentIds });
+        const validated = DocumentBulkDeleteSchema.parse({
+          document_ids: documentIds
+        });
         const { data } = await postAdminDocumentsBulkDelete({
           headers: this.getHeaders(),
           body: {
@@ -1524,7 +1540,9 @@ function handleApiError(error) {
     const entries = hdrs instanceof Headers ? Array.from(hdrs.entries()) : Object.entries(hdrs);
     const filtered = entries.filter(([key]) => {
       const lowerKey = key.toLowerCase();
-      return !sensitiveHeaderPatterns.some((pattern) => lowerKey.includes(pattern));
+      return !sensitiveHeaderPatterns.some(
+        (pattern) => lowerKey.includes(pattern)
+      );
     });
     return filtered.length > 0 ? Object.fromEntries(filtered) : void 0;
   };
@@ -1547,7 +1565,11 @@ function handleApiError(error) {
       throw new ValidationError(message, errors, errorOptions);
     case 429: {
       const retryAfter = headers?.get?.("retry-after") || headers?.["retry-after"];
-      throw new RateLimitError(message, retryAfter ? parseInt(retryAfter, 10) : void 0, errorOptions);
+      throw new RateLimitError(
+        message,
+        retryAfter ? parseInt(retryAfter, 10) : void 0,
+        errorOptions
+      );
     }
     case 500:
     case 502:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpt-core/admin",
-  "version": "0.10.20",
+  "version": "0.11.0",
   "description": "TypeScript SDK for GPT Core Admin API - Platform administration and ISV management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -45,12 +45,21 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/GPT-Integrators/gpt-core-sdks.git",
-    "directory": "ts/packages/admin"
+    "url": "git+https://github.com/GPT-Integrators/gpt-core.git",
+    "directory": "sdks/ts/packages/admin"
   },
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "generate": "bunx openapi-ts",
+    "typecheck": "bunx tsc --noEmit",
+    "build": "bun run typecheck && bunx tsup src/index.ts --format cjs,esm --dts",
+    "test": "bunx vitest run",
+    "test:watch": "bunx vitest",
+    "test:ui": "bunx vitest --ui",
+    "test:coverage": "bunx vitest run --coverage"
+  },
   "dependencies": {
     "zod": "^3.25.76"
   },
@@ -62,14 +71,5 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.15"
-  },
-  "scripts": {
-    "generate": "bunx openapi-ts",
-    "typecheck": "bunx tsc --noEmit",
-    "build": "bun run typecheck && bunx tsup src/index.ts --format cjs,esm --dts",
-    "test": "bunx vitest run",
-    "test:watch": "bunx vitest",
-    "test:ui": "bunx vitest --ui",
-    "test:coverage": "bunx vitest run --coverage"
   }
-}
+}