@gpt-core/admin 0.9.39 → 0.10.1

package/dist/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   ApiKeyAllocateSchema: () => ApiKeyAllocateSchema,
   AuthenticationError: () => AuthenticationError,
   AuthorizationError: () => AuthorizationError,
+  DEFAULT_API_VERSION: () => DEFAULT_API_VERSION,
   DocumentBulkDeleteSchema: () => DocumentBulkDeleteSchema,
   DocumentBulkReprocessSchema: () => DocumentBulkReprocessSchema,
   GptAdmin: () => GptAdmin,
@@ -867,14 +868,16 @@ var client = createClient(
 );
 
 // src/base-client.ts
+var DEFAULT_API_VERSION = "2025-12-03";
 var BaseClient = class {
   constructor(config = {}) {
     this.config = config;
+    this.apiVersion = config.apiVersion ?? DEFAULT_API_VERSION;
     if (config.baseUrl) {
       client.setConfig({ baseUrl: config.baseUrl });
     }
     client.interceptors.request.use((req) => {
-      req.headers.set("Accept", "application/vnd.api+json");
+      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);
@@ -1580,6 +1583,7 @@ var index_default = GptAdmin;
   ApiKeyAllocateSchema,
   AuthenticationError,
   AuthorizationError,
+  DEFAULT_API_VERSION,
   DocumentBulkDeleteSchema,
   DocumentBulkReprocessSchema,
   GptAdmin,

package/dist/index.mjs

@@ -819,14 +819,16 @@ var client = createClient(
 );
 
 // src/base-client.ts
+var DEFAULT_API_VERSION = "2025-12-03";
 var BaseClient = class {
   constructor(config = {}) {
     this.config = config;
+    this.apiVersion = config.apiVersion ?? DEFAULT_API_VERSION;
     if (config.baseUrl) {
       client.setConfig({ baseUrl: config.baseUrl });
     }
     client.interceptors.request.use((req) => {
-      req.headers.set("Accept", "application/vnd.api+json");
+      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);
@@ -1531,6 +1533,7 @@ export {
   ApiKeyAllocateSchema,
   AuthenticationError,
   AuthorizationError,
+  DEFAULT_API_VERSION,
   DocumentBulkDeleteSchema,
   DocumentBulkReprocessSchema,
   GptAdmin,

package/llms.txt

@@ -23,6 +23,39 @@ client.setConfig({
 });
 ```
 
+## API Versioning
+
+The SDK sends an API version header with every request.
+Default version: 2025-12-03
+
+### Configuration
+
+```typescript
+import { GptAdmin, DEFAULT_API_VERSION } from '@gpt-core/admin';
+
+// Use SDK default version
+const client = new GptAdmin({ baseUrl, apiKey });
+
+// Pin to specific version (recommended for production)
+const client = new GptAdmin({ baseUrl, apiKey, apiVersion: '2025-12-03' });
+
+// Read effective version
+client.apiVersion // "2025-12-03"
+```
+
+### Config Options
+
+- `baseUrl` (string) - API base URL
+- `token` (string) - User JWT for Bearer auth
+- `apiKey` (string) - Application key for x-application-key header
+- `applicationId` (string) - Application ID for scoped admin operations
+- `retry` (object|false) - Retry config or disable
+- `apiVersion` (string) - API version date, defaults to DEFAULT_API_VERSION
+
+### Response Header
+
+Every response includes: `x-api-version: 2025-12-03`
+
 ## Accounts
 
 - `getAccounts()` - List accounts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpt-core/admin",
-  "version": "0.9.39",
+  "version": "0.10.01",
   "description": "TypeScript SDK for GPT Core Admin API - Platform administration and ISV management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",