@gpt-core/client 0.7.21 → 0.7.23

package/dist/index.js

@@ -45,6 +45,9 @@ __export(index_exports, {
   ThreadCreateSchema: () => ThreadCreateSchema,
   TimeoutError: () => TimeoutError,
   ValidationError: () => ValidationError,
+  WebhookConfigCreateSchema: () => WebhookConfigCreateSchema,
+  WebhookConfigUpdateSchema: () => WebhookConfigUpdateSchema,
+  WebhookError: () => WebhookError,
   WorkspaceCreateSchema: () => WorkspaceCreateSchema,
   calculateBackoff: () => calculateBackoff,
   client: () => client,
@@ -315,6 +318,7 @@ __export(index_exports, {
   sleep: () => sleep,
   streamMessage: () => streamMessage,
   streamSSE: () => streamSSE,
+  webhooks: () => webhooks,
   withRetry: () => withRetry
 });
 module.exports = __toCommonJS(index_exports);
@@ -3909,6 +3913,28 @@ var PresignedUploadSchema = import_zod.z.object({
 var PresignedDownloadSchema = import_zod.z.object({
   file_id: import_zod.z.string().uuid()
 });
+var WebhookConfigCreateSchema = import_zod.z.object({
+  name: import_zod.z.string().min(1).max(255),
+  url: import_zod.z.string().url(),
+  events: import_zod.z.array(import_zod.z.string()).optional(),
+  enabled: import_zod.z.boolean().optional().default(true),
+  secret: import_zod.z.string().optional(),
+  // Tenant-level webhook: set tenant_id to scope to a specific tenant
+  tenant_id: import_zod.z.string().uuid().optional(),
+  // ISV filter: specific tenant UUIDs to receive events from (null = all)
+  tenant_ids: import_zod.z.array(import_zod.z.string().uuid()).optional(),
+  // Tenant filter: specific workspace UUIDs to receive events from (null = all)
+  workspace_ids: import_zod.z.array(import_zod.z.string().uuid()).optional()
+});
+var WebhookConfigUpdateSchema = import_zod.z.object({
+  name: import_zod.z.string().min(1).max(255).optional(),
+  url: import_zod.z.string().url().optional(),
+  events: import_zod.z.array(import_zod.z.string()).optional(),
+  enabled: import_zod.z.boolean().optional(),
+  secret: import_zod.z.string().optional(),
+  tenant_ids: import_zod.z.array(import_zod.z.string().uuid()).optional(),
+  workspace_ids: import_zod.z.array(import_zod.z.string().uuid()).optional()
+});
 
 // src/utils/retry.ts
 var DEFAULT_RETRY_CONFIG = {
@@ -4060,10 +4086,207 @@ async function collectStreamedMessage(stream) {
   return fullMessage;
 }
 
+// src/webhooks.ts
+var WebhookError = class extends Error {
+  constructor(message, status, errors) {
+    super(message);
+    this.status = status;
+    this.errors = errors;
+    this.name = "WebhookError";
+  }
+};
+function unwrap(data) {
+  if (data && typeof data === "object" && "attributes" in data) {
+    const obj = data;
+    return { id: obj.id, ...obj.attributes };
+  }
+  return data;
+}
+function handleError(error) {
+  if (error && typeof error === "object") {
+    const err = error;
+    throw new WebhookError(
+      err.detail || "Webhook operation failed",
+      err.status,
+      err.errors
+    );
+  }
+  throw new WebhookError("Unknown error");
+}
+function processResult(result) {
+  const r = result;
+  if (r.error) handleError(r.error);
+  return r.data?.data;
+}
+function processArrayResult(result) {
+  const r = result;
+  if (r.error) handleError(r.error);
+  return (r.data?.data || []).map((d) => unwrap(d));
+}
+var webhooks = {
+  /**
+   * List all webhook configurations accessible to the current user.
+   *
+   * For tenant users, this returns webhooks scoped to their tenant.
+   * For ISV/app owners, this returns application-level webhooks.
+   */
+  async list(options) {
+    const result = await getWebhookConfigs({
+      headers: { "x-application-key": "" },
+      query: options?.filter
+    });
+    return processArrayResult(result);
+  },
+  /**
+   * Get a single webhook configuration by ID.
+   */
+  async get(id) {
+    const result = await getWebhookConfigsById({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Create a new webhook configuration.
+   *
+   * For tenant-level webhooks, include `tenant_id` in the attributes.
+   * The tenant_id is typically obtained from the user's profile.
+   *
+   * @example
+   * ```typescript
+   * // Tenant-level webhook (receives only this tenant's events)
+   * const webhook = await webhooks.create({
+   *   name: 'My Webhook',
+   *   url: 'https://example.com/webhook',
+   *   events: ['extraction.completed', 'document.processed'],
+   *   tenant_id: userProfile.tenant_id,
+   * });
+   *
+   * // With workspace filtering (only events from specific workspaces)
+   * const webhook = await webhooks.create({
+   *   name: 'Workspace Webhook',
+   *   url: 'https://example.com/webhook',
+   *   tenant_id: userProfile.tenant_id,
+   *   workspace_ids: ['workspace-uuid-1', 'workspace-uuid-2'],
+   * });
+   * ```
+   */
+  async create(attributes) {
+    const validated = WebhookConfigCreateSchema.parse(attributes);
+    const result = await postWebhookConfigs({
+      headers: { "x-application-key": "" },
+      body: {
+        data: {
+          type: "webhook_config",
+          attributes: validated
+        }
+      }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Update an existing webhook configuration.
+   */
+  async update(id, attributes) {
+    const validated = WebhookConfigUpdateSchema.parse(attributes);
+    const result = await patchWebhookConfigsById({
+      headers: { "x-application-key": "" },
+      path: { id },
+      body: {
+        data: {
+          type: "webhook_config",
+          id,
+          attributes: validated
+        }
+      }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Delete a webhook configuration.
+   */
+  async delete(id) {
+    const result = await deleteWebhookConfigsById({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    const r = result;
+    if (r.error) handleError(r.error);
+  },
+  /**
+   * Send a test webhook to verify the endpoint is reachable.
+   *
+   * This enqueues a test webhook delivery with a sample payload.
+   * Check the deliveries list to see the result.
+   */
+  async test(id) {
+    const result = await postWebhookConfigsByIdTest({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Rotate the webhook secret.
+   *
+   * This generates a new secret for the webhook. The old secret
+   * becomes invalid immediately. Make sure to update your endpoint
+   * with the new secret.
+   */
+  async rotateSecret(id) {
+    const result = await patchWebhookConfigsByIdRotateSecret({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Webhook delivery management
+   */
+  deliveries: {
+    /**
+     * List webhook deliveries.
+     *
+     * Deliveries are sorted by newest first by default.
+     */
+    async list(options) {
+      const result = await getWebhookDeliveries({
+        headers: { "x-application-key": "" },
+        query: options?.filter
+      });
+      return processArrayResult(result);
+    },
+    /**
+     * Get a single webhook delivery by ID.
+     */
+    async get(id) {
+      const result = await getWebhookDeliveriesById({
+        headers: { "x-application-key": "" },
+        path: { id }
+      });
+      return unwrap(processResult(result));
+    },
+    /**
+     * Retry a failed webhook delivery.
+     *
+     * This re-enqueues the delivery for another attempt.
+     */
+    async retry(id) {
+      const result = await postWebhookDeliveriesByIdRetry({
+        headers: { "x-application-key": "" },
+        path: { id }
+      });
+      return unwrap(processResult(result));
+    }
+  }
+};
+
 // src/index.ts
 var gptCore = {
   ...sdk_gen_exports,
-  client
+  client,
+  webhooks
 };
 var index_default = gptCore;
 // Annotate the CommonJS export names for ESM import in node:
@@ -4093,6 +4316,9 @@ var index_default = gptCore;
   ThreadCreateSchema,
   TimeoutError,
   ValidationError,
+  WebhookConfigCreateSchema,
+  WebhookConfigUpdateSchema,
+  WebhookError,
   WorkspaceCreateSchema,
   calculateBackoff,
   client,
@@ -4362,5 +4588,6 @@ var index_default = gptCore;
   sleep,
   streamMessage,
   streamSSE,
+  webhooks,
   withRetry
 });

package/dist/index.mjs

@@ -3594,6 +3594,28 @@ var PresignedUploadSchema = z.object({
 var PresignedDownloadSchema = z.object({
   file_id: z.string().uuid()
 });
+var WebhookConfigCreateSchema = z.object({
+  name: z.string().min(1).max(255),
+  url: z.string().url(),
+  events: z.array(z.string()).optional(),
+  enabled: z.boolean().optional().default(true),
+  secret: z.string().optional(),
+  // Tenant-level webhook: set tenant_id to scope to a specific tenant
+  tenant_id: z.string().uuid().optional(),
+  // ISV filter: specific tenant UUIDs to receive events from (null = all)
+  tenant_ids: z.array(z.string().uuid()).optional(),
+  // Tenant filter: specific workspace UUIDs to receive events from (null = all)
+  workspace_ids: z.array(z.string().uuid()).optional()
+});
+var WebhookConfigUpdateSchema = z.object({
+  name: z.string().min(1).max(255).optional(),
+  url: z.string().url().optional(),
+  events: z.array(z.string()).optional(),
+  enabled: z.boolean().optional(),
+  secret: z.string().optional(),
+  tenant_ids: z.array(z.string().uuid()).optional(),
+  workspace_ids: z.array(z.string().uuid()).optional()
+});
 
 // src/utils/retry.ts
 var DEFAULT_RETRY_CONFIG = {
@@ -3745,10 +3767,207 @@ async function collectStreamedMessage(stream) {
   return fullMessage;
 }
 
+// src/webhooks.ts
+var WebhookError = class extends Error {
+  constructor(message, status, errors) {
+    super(message);
+    this.status = status;
+    this.errors = errors;
+    this.name = "WebhookError";
+  }
+};
+function unwrap(data) {
+  if (data && typeof data === "object" && "attributes" in data) {
+    const obj = data;
+    return { id: obj.id, ...obj.attributes };
+  }
+  return data;
+}
+function handleError(error) {
+  if (error && typeof error === "object") {
+    const err = error;
+    throw new WebhookError(
+      err.detail || "Webhook operation failed",
+      err.status,
+      err.errors
+    );
+  }
+  throw new WebhookError("Unknown error");
+}
+function processResult(result) {
+  const r = result;
+  if (r.error) handleError(r.error);
+  return r.data?.data;
+}
+function processArrayResult(result) {
+  const r = result;
+  if (r.error) handleError(r.error);
+  return (r.data?.data || []).map((d) => unwrap(d));
+}
+var webhooks = {
+  /**
+   * List all webhook configurations accessible to the current user.
+   *
+   * For tenant users, this returns webhooks scoped to their tenant.
+   * For ISV/app owners, this returns application-level webhooks.
+   */
+  async list(options) {
+    const result = await getWebhookConfigs({
+      headers: { "x-application-key": "" },
+      query: options?.filter
+    });
+    return processArrayResult(result);
+  },
+  /**
+   * Get a single webhook configuration by ID.
+   */
+  async get(id) {
+    const result = await getWebhookConfigsById({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Create a new webhook configuration.
+   *
+   * For tenant-level webhooks, include `tenant_id` in the attributes.
+   * The tenant_id is typically obtained from the user's profile.
+   *
+   * @example
+   * ```typescript
+   * // Tenant-level webhook (receives only this tenant's events)
+   * const webhook = await webhooks.create({
+   *   name: 'My Webhook',
+   *   url: 'https://example.com/webhook',
+   *   events: ['extraction.completed', 'document.processed'],
+   *   tenant_id: userProfile.tenant_id,
+   * });
+   *
+   * // With workspace filtering (only events from specific workspaces)
+   * const webhook = await webhooks.create({
+   *   name: 'Workspace Webhook',
+   *   url: 'https://example.com/webhook',
+   *   tenant_id: userProfile.tenant_id,
+   *   workspace_ids: ['workspace-uuid-1', 'workspace-uuid-2'],
+   * });
+   * ```
+   */
+  async create(attributes) {
+    const validated = WebhookConfigCreateSchema.parse(attributes);
+    const result = await postWebhookConfigs({
+      headers: { "x-application-key": "" },
+      body: {
+        data: {
+          type: "webhook_config",
+          attributes: validated
+        }
+      }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Update an existing webhook configuration.
+   */
+  async update(id, attributes) {
+    const validated = WebhookConfigUpdateSchema.parse(attributes);
+    const result = await patchWebhookConfigsById({
+      headers: { "x-application-key": "" },
+      path: { id },
+      body: {
+        data: {
+          type: "webhook_config",
+          id,
+          attributes: validated
+        }
+      }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Delete a webhook configuration.
+   */
+  async delete(id) {
+    const result = await deleteWebhookConfigsById({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    const r = result;
+    if (r.error) handleError(r.error);
+  },
+  /**
+   * Send a test webhook to verify the endpoint is reachable.
+   *
+   * This enqueues a test webhook delivery with a sample payload.
+   * Check the deliveries list to see the result.
+   */
+  async test(id) {
+    const result = await postWebhookConfigsByIdTest({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Rotate the webhook secret.
+   *
+   * This generates a new secret for the webhook. The old secret
+   * becomes invalid immediately. Make sure to update your endpoint
+   * with the new secret.
+   */
+  async rotateSecret(id) {
+    const result = await patchWebhookConfigsByIdRotateSecret({
+      headers: { "x-application-key": "" },
+      path: { id }
+    });
+    return unwrap(processResult(result));
+  },
+  /**
+   * Webhook delivery management
+   */
+  deliveries: {
+    /**
+     * List webhook deliveries.
+     *
+     * Deliveries are sorted by newest first by default.
+     */
+    async list(options) {
+      const result = await getWebhookDeliveries({
+        headers: { "x-application-key": "" },
+        query: options?.filter
+      });
+      return processArrayResult(result);
+    },
+    /**
+     * Get a single webhook delivery by ID.
+     */
+    async get(id) {
+      const result = await getWebhookDeliveriesById({
+        headers: { "x-application-key": "" },
+        path: { id }
+      });
+      return unwrap(processResult(result));
+    },
+    /**
+     * Retry a failed webhook delivery.
+     *
+     * This re-enqueues the delivery for another attempt.
+     */
+    async retry(id) {
+      const result = await postWebhookDeliveriesByIdRetry({
+        headers: { "x-application-key": "" },
+        path: { id }
+      });
+      return unwrap(processResult(result));
+    }
+  }
+};
+
 // src/index.ts
 var gptCore = {
   ...sdk_gen_exports,
-  client
+  client,
+  webhooks
 };
 var index_default = gptCore;
 export {
@@ -3777,6 +3996,9 @@ export {
   ThreadCreateSchema,
   TimeoutError,
   ValidationError,
+  WebhookConfigCreateSchema,
+  WebhookConfigUpdateSchema,
+  WebhookError,
   WorkspaceCreateSchema,
   calculateBackoff,
   client,
@@ -4047,5 +4269,6 @@ export {
   sleep,
   streamMessage,
   streamSSE,
+  webhooks,
   withRetry
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpt-core/client",
-  "version": "0.7.21",
+  "version": "0.7.23",
   "description": "TypeScript SDK for GPT Core Client API - Document extraction, AI agents, and workspace management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -43,6 +43,14 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "generate": "openapi-ts",
+    "build": "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"
@@ -54,13 +62,5 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.15"
-  },
-  "scripts": {
-    "generate": "openapi-ts",
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest run --coverage"
   }
-}
+}