@gpt-core/client 0.10.12 → 0.10.20

package/dist/index.js

@@ -41,6 +41,7 @@ __export(index_exports, {
   PresignedUploadSchema: () => PresignedUploadSchema,
   RateLimitError: () => RateLimitError,
   RegisterRequestSchema: () => RegisterRequestSchema,
+  RetryTimeoutError: () => RetryTimeoutError,
   SearchRequestSchema: () => SearchRequestSchema,
   ServerError: () => ServerError,
   ThreadCreateSchema: () => ThreadCreateSchema,
@@ -152,6 +153,7 @@ __export(index_exports, {
   getExtractionResults: () => getExtractionResults,
   getExtractionResultsById: () => getExtractionResultsById,
   getExtractionResultsDocumentByDocumentId: () => getExtractionResultsDocumentByDocumentId,
+  getExtractionResultsDocumentByDocumentIdHistory: () => getExtractionResultsDocumentByDocumentIdHistory,
   getExtractionResultsWorkspaceByWorkspaceId: () => getExtractionResultsWorkspaceByWorkspaceId,
   getExtractionSchemaDiscoveriesById: () => getExtractionSchemaDiscoveriesById,
   getFieldTemplates: () => getFieldTemplates,
@@ -570,6 +572,7 @@ __export(sdk_gen_exports, {
   getExtractionResults: () => getExtractionResults,
   getExtractionResultsById: () => getExtractionResultsById,
   getExtractionResultsDocumentByDocumentId: () => getExtractionResultsDocumentByDocumentId,
+  getExtractionResultsDocumentByDocumentIdHistory: () => getExtractionResultsDocumentByDocumentIdHistory,
   getExtractionResultsWorkspaceByWorkspaceId: () => getExtractionResultsWorkspaceByWorkspaceId,
   getExtractionSchemaDiscoveriesById: () => getExtractionSchemaDiscoveriesById,
   getFieldTemplates: () => getFieldTemplates,
@@ -1813,7 +1816,12 @@ var patchApiKeysByIdRevoke = (options) => (options.client ?? client).patch({
   }
 });
 var getAiChunksDocumentByDocumentId = (options) => (options.client ?? client).get({
-  querySerializer: { parameters: { fields: { object: { style: "form" } } } },
+  querySerializer: {
+    parameters: {
+      filter: { object: { style: "form" } },
+      fields: { object: { style: "form" } }
+    }
+  },
   security: [{ scheme: "bearer", type: "http" }],
   url: "/ai/chunks/document/{document_id}",
   ...options
@@ -4864,6 +4872,18 @@ var patchAiConversationsById = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
+var getExtractionResultsDocumentByDocumentIdHistory = (options) => (options.client ?? client).get({
+  querySerializer: {
+    parameters: {
+      filter: { object: { style: "form" } },
+      page: { object: { style: "form" } },
+      fields: { object: { style: "form" } }
+    }
+  },
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/extraction/results/document/{document_id}/history",
+  ...options
+});
 var getInvitationsMe = (options) => (options.client ?? client).get({
   querySerializer: {
     parameters: {
@@ -5366,10 +5386,33 @@ function handleApiError(error) {
   } else if (error?.message) {
     message = error.message;
   }
+  const sensitiveHeaderPatterns = [
+    "set-cookie",
+    "authorization",
+    "x-application-key",
+    "x-api-key",
+    "cookie",
+    "x-forwarded-for",
+    "x-real-ip",
+    "proxy-authorization",
+    "x-client-ip",
+    "x-forwarded",
+    "cf-connecting-ip",
+    "x-cluster-client-ip"
+  ];
+  const filterSensitiveHeaders = (hdrs) => {
+    if (!hdrs) return void 0;
+    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 filtered.length > 0 ? Object.fromEntries(filtered) : void 0;
+  };
   const errorOptions = {
     statusCode,
     requestId,
-    headers: headers ? headers.entries ? Object.fromEntries(headers.entries()) : Object.fromEntries(Object.entries(headers)) : void 0,
+    headers: filterSensitiveHeaders(headers),
     body,
     cause: error
   };
@@ -5503,15 +5546,20 @@ var DEFAULT_RETRY_CONFIG = {
   // 1 second
   maxDelay: 32e3,
   // 32 seconds
-  retryableStatusCodes: [429, 500, 502, 503, 504]
+  retryableStatusCodes: [429, 500, 502, 503, 504],
+  totalTimeout: 3e5,
+  // 5 minutes total timeout
+  maxRetryAfter: 60
+  // Max 60 seconds from Retry-After header
 };
 function isRetryableError(error, retryableStatusCodes) {
   const statusCode = error?.status || error?.statusCode || error?.response?.status;
   return retryableStatusCodes.includes(statusCode);
 }
-function calculateBackoff(attempt, initialDelay, maxDelay, retryAfter) {
-  if (retryAfter) {
-    return Math.min(retryAfter * 1e3, maxDelay);
+function calculateBackoff(attempt, initialDelay, maxDelay, retryAfter, maxRetryAfter = 60) {
+  if (retryAfter !== void 0 && retryAfter > 0) {
+    const cappedRetryAfter = Math.min(retryAfter, maxRetryAfter);
+    return Math.min(cappedRetryAfter * 1e3, maxDelay);
   }
   const exponentialDelay = initialDelay * Math.pow(2, attempt);
   const jitter = Math.random() * 0.3 * exponentialDelay;
@@ -5521,9 +5569,26 @@ function calculateBackoff(attempt, initialDelay, maxDelay, retryAfter) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+var RetryTimeoutError = class extends Error {
+  constructor(message, lastError) {
+    super(message);
+    this.lastError = lastError;
+    this.name = "RetryTimeoutError";
+  }
+};
 async function retryWithBackoff(fn, config = DEFAULT_RETRY_CONFIG) {
   let lastError;
+  const startTime = Date.now();
+  const totalTimeout = config.totalTimeout ?? DEFAULT_RETRY_CONFIG.totalTimeout;
+  const maxRetryAfter = config.maxRetryAfter ?? DEFAULT_RETRY_CONFIG.maxRetryAfter;
   for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    const elapsed = Date.now() - startTime;
+    if (elapsed >= totalTimeout) {
+      throw new RetryTimeoutError(
+        `Retry timeout exceeded after ${elapsed}ms (limit: ${totalTimeout}ms)`,
+        lastError
+      );
+    }
     try {
       return await fn();
     } catch (error) {
@@ -5532,14 +5597,29 @@ async function retryWithBackoff(fn, config = DEFAULT_RETRY_CONFIG) {
         throw error;
       }
       const errorWithHeaders = error;
-      const retryAfter = errorWithHeaders?.response?.headers?.get?.("retry-after") || errorWithHeaders?.response?.headers?.["retry-after"] || errorWithHeaders?.headers?.get?.("retry-after") || errorWithHeaders?.headers?.["retry-after"];
-      const retryAfterSeconds = retryAfter ? parseInt(retryAfter, 10) : void 0;
+      const headers = errorWithHeaders?.response?.headers || errorWithHeaders?.headers;
+      const retryAfter = headers?.get?.("retry-after") || headers?.["retry-after"];
+      let retryAfterSeconds;
+      if (retryAfter) {
+        const parsed = parseInt(String(retryAfter), 10);
+        if (!isNaN(parsed) && parsed > 0 && parsed <= maxRetryAfter) {
+          retryAfterSeconds = parsed;
+        }
+      }
       const delay = calculateBackoff(
         attempt,
         config.initialDelay,
         config.maxDelay,
-        retryAfterSeconds
+        retryAfterSeconds,
+        maxRetryAfter
       );
+      const remainingTimeout = totalTimeout - (Date.now() - startTime);
+      if (delay >= remainingTimeout) {
+        throw new RetryTimeoutError(
+          `Retry would exceed timeout (delay: ${delay}ms, remaining: ${remainingTimeout}ms)`,
+          lastError
+        );
+      }
       await sleep(delay);
     }
   }
@@ -5573,15 +5653,35 @@ async function* paginateAll(fetcher, options = {}) {
     page++;
   }
 }
+var DEFAULT_LIMIT = 1e4;
+var WARNING_THRESHOLD = 1e3;
 async function paginateToArray(fetcher, options = {}) {
+  const safeOptions = {
+    pageSize: options.pageSize || 20,
+    // Security: Apply default limit to prevent unbounded memory usage
+    limit: options.limit ?? DEFAULT_LIMIT
+  };
+  if (!options.limit && typeof process !== "undefined" && process.env?.NODE_ENV !== "test") {
+    console.warn(
+      `[GPT Core SDK] Fetching up to ${DEFAULT_LIMIT} items. For large datasets, consider using paginateAll() with streaming instead.`
+    );
+  }
+  if (safeOptions.limit > WARNING_THRESHOLD) {
+    console.warn(
+      `[GPT Core SDK] Fetching more than ${WARNING_THRESHOLD} items may consume significant memory.`
+    );
+  }
   const results = [];
-  for await (const item of paginateAll(fetcher, options)) {
+  for await (const item of paginateAll(fetcher, safeOptions)) {
     results.push(item);
   }
   return results;
 }
 
 // src/streaming.ts
+var DEFAULT_STREAM_TIMEOUT = 3e5;
+var DEFAULT_MAX_CHUNKS = 1e4;
+var DEFAULT_MAX_BUFFER_SIZE = 10 * 1024 * 1024;
 async function* streamSSE(response, options = {}) {
   if (!response.body) {
     throw new Error("Response body is null");
@@ -5589,8 +5689,23 @@ async function* streamSSE(response, options = {}) {
   const reader = response.body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  const timeout = options.timeout ?? DEFAULT_STREAM_TIMEOUT;
+  const maxChunks = options.maxChunks ?? DEFAULT_MAX_CHUNKS;
+  const maxBufferSize = options.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;
+  const startTime = Date.now();
+  let chunkCount = 0;
+  let bufferSize = 0;
   try {
     while (true) {
+      const elapsed = Date.now() - startTime;
+      if (elapsed > timeout) {
+        reader.cancel();
+        throw new Error(`Stream timeout exceeded after ${elapsed}ms (limit: ${timeout}ms)`);
+      }
+      if (chunkCount >= maxChunks) {
+        reader.cancel();
+        throw new Error(`Maximum chunk limit exceeded (${maxChunks})`);
+      }
       const { done, value } = await reader.read();
       if (done) {
         break;
@@ -5599,6 +5714,11 @@ async function* streamSSE(response, options = {}) {
         reader.cancel();
         throw new Error("Stream aborted");
       }
+      bufferSize += value.length;
+      if (bufferSize > maxBufferSize) {
+        reader.cancel();
+        throw new Error(`Stream buffer size exceeded (${bufferSize} bytes, limit: ${maxBufferSize})`);
+      }
       buffer += decoder.decode(value, { stream: true });
       const lines = buffer.split("\n");
       buffer = lines.pop() || "";
@@ -5608,6 +5728,7 @@ async function* streamSSE(response, options = {}) {
           if (data === "[DONE]" || data.trim() === "") {
             continue;
           }
+          chunkCount++;
           try {
             const parsed = JSON.parse(data);
             yield parsed;
@@ -5872,6 +5993,7 @@ var index_default = gptCore;
   PresignedUploadSchema,
   RateLimitError,
   RegisterRequestSchema,
+  RetryTimeoutError,
   SearchRequestSchema,
   ServerError,
   ThreadCreateSchema,
@@ -5982,6 +6104,7 @@ var index_default = gptCore;
   getExtractionResults,
   getExtractionResultsById,
   getExtractionResultsDocumentByDocumentId,
+  getExtractionResultsDocumentByDocumentIdHistory,
   getExtractionResultsWorkspaceByWorkspaceId,
   getExtractionSchemaDiscoveriesById,
   getFieldTemplates,

package/dist/index.mjs

@@ -105,6 +105,7 @@ __export(sdk_gen_exports, {
   getExtractionResults: () => getExtractionResults,
   getExtractionResultsById: () => getExtractionResultsById,
   getExtractionResultsDocumentByDocumentId: () => getExtractionResultsDocumentByDocumentId,
+  getExtractionResultsDocumentByDocumentIdHistory: () => getExtractionResultsDocumentByDocumentIdHistory,
   getExtractionResultsWorkspaceByWorkspaceId: () => getExtractionResultsWorkspaceByWorkspaceId,
   getExtractionSchemaDiscoveriesById: () => getExtractionSchemaDiscoveriesById,
   getFieldTemplates: () => getFieldTemplates,
@@ -1348,7 +1349,12 @@ var patchApiKeysByIdRevoke = (options) => (options.client ?? client).patch({
   }
 });
 var getAiChunksDocumentByDocumentId = (options) => (options.client ?? client).get({
-  querySerializer: { parameters: { fields: { object: { style: "form" } } } },
+  querySerializer: {
+    parameters: {
+      filter: { object: { style: "form" } },
+      fields: { object: { style: "form" } }
+    }
+  },
   security: [{ scheme: "bearer", type: "http" }],
   url: "/ai/chunks/document/{document_id}",
   ...options
@@ -4399,6 +4405,18 @@ var patchAiConversationsById = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
+var getExtractionResultsDocumentByDocumentIdHistory = (options) => (options.client ?? client).get({
+  querySerializer: {
+    parameters: {
+      filter: { object: { style: "form" } },
+      page: { object: { style: "form" } },
+      fields: { object: { style: "form" } }
+    }
+  },
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/extraction/results/document/{document_id}/history",
+  ...options
+});
 var getInvitationsMe = (options) => (options.client ?? client).get({
   querySerializer: {
     parameters: {
@@ -4901,10 +4919,33 @@ function handleApiError(error) {
   } else if (error?.message) {
     message = error.message;
   }
+  const sensitiveHeaderPatterns = [
+    "set-cookie",
+    "authorization",
+    "x-application-key",
+    "x-api-key",
+    "cookie",
+    "x-forwarded-for",
+    "x-real-ip",
+    "proxy-authorization",
+    "x-client-ip",
+    "x-forwarded",
+    "cf-connecting-ip",
+    "x-cluster-client-ip"
+  ];
+  const filterSensitiveHeaders = (hdrs) => {
+    if (!hdrs) return void 0;
+    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 filtered.length > 0 ? Object.fromEntries(filtered) : void 0;
+  };
   const errorOptions = {
     statusCode,
     requestId,
-    headers: headers ? headers.entries ? Object.fromEntries(headers.entries()) : Object.fromEntries(Object.entries(headers)) : void 0,
+    headers: filterSensitiveHeaders(headers),
     body,
     cause: error
   };
@@ -5038,15 +5079,20 @@ var DEFAULT_RETRY_CONFIG = {
   // 1 second
   maxDelay: 32e3,
   // 32 seconds
-  retryableStatusCodes: [429, 500, 502, 503, 504]
+  retryableStatusCodes: [429, 500, 502, 503, 504],
+  totalTimeout: 3e5,
+  // 5 minutes total timeout
+  maxRetryAfter: 60
+  // Max 60 seconds from Retry-After header
 };
 function isRetryableError(error, retryableStatusCodes) {
   const statusCode = error?.status || error?.statusCode || error?.response?.status;
   return retryableStatusCodes.includes(statusCode);
 }
-function calculateBackoff(attempt, initialDelay, maxDelay, retryAfter) {
-  if (retryAfter) {
-    return Math.min(retryAfter * 1e3, maxDelay);
+function calculateBackoff(attempt, initialDelay, maxDelay, retryAfter, maxRetryAfter = 60) {
+  if (retryAfter !== void 0 && retryAfter > 0) {
+    const cappedRetryAfter = Math.min(retryAfter, maxRetryAfter);
+    return Math.min(cappedRetryAfter * 1e3, maxDelay);
   }
   const exponentialDelay = initialDelay * Math.pow(2, attempt);
   const jitter = Math.random() * 0.3 * exponentialDelay;
@@ -5056,9 +5102,26 @@ function calculateBackoff(attempt, initialDelay, maxDelay, retryAfter) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+var RetryTimeoutError = class extends Error {
+  constructor(message, lastError) {
+    super(message);
+    this.lastError = lastError;
+    this.name = "RetryTimeoutError";
+  }
+};
 async function retryWithBackoff(fn, config = DEFAULT_RETRY_CONFIG) {
   let lastError;
+  const startTime = Date.now();
+  const totalTimeout = config.totalTimeout ?? DEFAULT_RETRY_CONFIG.totalTimeout;
+  const maxRetryAfter = config.maxRetryAfter ?? DEFAULT_RETRY_CONFIG.maxRetryAfter;
   for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    const elapsed = Date.now() - startTime;
+    if (elapsed >= totalTimeout) {
+      throw new RetryTimeoutError(
+        `Retry timeout exceeded after ${elapsed}ms (limit: ${totalTimeout}ms)`,
+        lastError
+      );
+    }
     try {
       return await fn();
     } catch (error) {
@@ -5067,14 +5130,29 @@ async function retryWithBackoff(fn, config = DEFAULT_RETRY_CONFIG) {
         throw error;
       }
       const errorWithHeaders = error;
-      const retryAfter = errorWithHeaders?.response?.headers?.get?.("retry-after") || errorWithHeaders?.response?.headers?.["retry-after"] || errorWithHeaders?.headers?.get?.("retry-after") || errorWithHeaders?.headers?.["retry-after"];
-      const retryAfterSeconds = retryAfter ? parseInt(retryAfter, 10) : void 0;
+      const headers = errorWithHeaders?.response?.headers || errorWithHeaders?.headers;
+      const retryAfter = headers?.get?.("retry-after") || headers?.["retry-after"];
+      let retryAfterSeconds;
+      if (retryAfter) {
+        const parsed = parseInt(String(retryAfter), 10);
+        if (!isNaN(parsed) && parsed > 0 && parsed <= maxRetryAfter) {
+          retryAfterSeconds = parsed;
+        }
+      }
       const delay = calculateBackoff(
         attempt,
         config.initialDelay,
         config.maxDelay,
-        retryAfterSeconds
+        retryAfterSeconds,
+        maxRetryAfter
       );
+      const remainingTimeout = totalTimeout - (Date.now() - startTime);
+      if (delay >= remainingTimeout) {
+        throw new RetryTimeoutError(
+          `Retry would exceed timeout (delay: ${delay}ms, remaining: ${remainingTimeout}ms)`,
+          lastError
+        );
+      }
       await sleep(delay);
     }
   }
@@ -5108,15 +5186,35 @@ async function* paginateAll(fetcher, options = {}) {
     page++;
   }
 }
+var DEFAULT_LIMIT = 1e4;
+var WARNING_THRESHOLD = 1e3;
 async function paginateToArray(fetcher, options = {}) {
+  const safeOptions = {
+    pageSize: options.pageSize || 20,
+    // Security: Apply default limit to prevent unbounded memory usage
+    limit: options.limit ?? DEFAULT_LIMIT
+  };
+  if (!options.limit && typeof process !== "undefined" && process.env?.NODE_ENV !== "test") {
+    console.warn(
+      `[GPT Core SDK] Fetching up to ${DEFAULT_LIMIT} items. For large datasets, consider using paginateAll() with streaming instead.`
+    );
+  }
+  if (safeOptions.limit > WARNING_THRESHOLD) {
+    console.warn(
+      `[GPT Core SDK] Fetching more than ${WARNING_THRESHOLD} items may consume significant memory.`
+    );
+  }
   const results = [];
-  for await (const item of paginateAll(fetcher, options)) {
+  for await (const item of paginateAll(fetcher, safeOptions)) {
     results.push(item);
   }
   return results;
 }
 
 // src/streaming.ts
+var DEFAULT_STREAM_TIMEOUT = 3e5;
+var DEFAULT_MAX_CHUNKS = 1e4;
+var DEFAULT_MAX_BUFFER_SIZE = 10 * 1024 * 1024;
 async function* streamSSE(response, options = {}) {
   if (!response.body) {
     throw new Error("Response body is null");
@@ -5124,8 +5222,23 @@ async function* streamSSE(response, options = {}) {
   const reader = response.body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  const timeout = options.timeout ?? DEFAULT_STREAM_TIMEOUT;
+  const maxChunks = options.maxChunks ?? DEFAULT_MAX_CHUNKS;
+  const maxBufferSize = options.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;
+  const startTime = Date.now();
+  let chunkCount = 0;
+  let bufferSize = 0;
   try {
     while (true) {
+      const elapsed = Date.now() - startTime;
+      if (elapsed > timeout) {
+        reader.cancel();
+        throw new Error(`Stream timeout exceeded after ${elapsed}ms (limit: ${timeout}ms)`);
+      }
+      if (chunkCount >= maxChunks) {
+        reader.cancel();
+        throw new Error(`Maximum chunk limit exceeded (${maxChunks})`);
+      }
       const { done, value } = await reader.read();
       if (done) {
         break;
@@ -5134,6 +5247,11 @@ async function* streamSSE(response, options = {}) {
         reader.cancel();
         throw new Error("Stream aborted");
       }
+      bufferSize += value.length;
+      if (bufferSize > maxBufferSize) {
+        reader.cancel();
+        throw new Error(`Stream buffer size exceeded (${bufferSize} bytes, limit: ${maxBufferSize})`);
+      }
       buffer += decoder.decode(value, { stream: true });
       const lines = buffer.split("\n");
       buffer = lines.pop() || "";
@@ -5143,6 +5261,7 @@ async function* streamSSE(response, options = {}) {
           if (data === "[DONE]" || data.trim() === "") {
             continue;
           }
+          chunkCount++;
           try {
             const parsed = JSON.parse(data);
             yield parsed;
@@ -5406,6 +5525,7 @@ export {
   PresignedUploadSchema,
   RateLimitError,
   RegisterRequestSchema,
+  RetryTimeoutError,
   SearchRequestSchema,
   ServerError,
   ThreadCreateSchema,
@@ -5517,6 +5637,7 @@ export {
   getExtractionResults,
   getExtractionResultsById,
   getExtractionResultsDocumentByDocumentId,
+  getExtractionResultsDocumentByDocumentIdHistory,
   getExtractionResultsWorkspaceByWorkspaceId,
   getExtractionSchemaDiscoveriesById,
   getFieldTemplates,

package/llms.txt

@@ -265,6 +265,7 @@ client.setConfig({
 - `getExtractionResults()` - List results
 - `getExtractionResultsById()` - Get results
 - `getExtractionResultsDocumentByDocumentId()` - Get document
+- `getExtractionResultsDocumentByDocumentIdHistory()` - Get history
 - `getExtractionResultsWorkspaceByWorkspaceId()` - Get workspace
 - `patchExtractionResultsById()` - Update results
 - `patchExtractionResultsByIdRegenerate()` - Update regenerate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpt-core/client",
-  "version": "0.10.12",
+  "version": "0.10.20",
   "description": "TypeScript SDK for GPT Core Client API - Document extraction, AI agents, and workspace management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -52,15 +52,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "generate": "openapi-ts",
-    "typecheck": "tsc --noEmit",
-    "build": "npm run typecheck && tsup src/index.ts --format cjs,esm --dts",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest run --coverage"
-  },
   "dependencies": {
     "eventsource-parser": "^3.0.6",
     "zod": "^3.25.76"
@@ -72,5 +63,14 @@
     "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"
   }
-}
+}