newscatcher-catchall-sdk 1.5.1 → 3.0.0

package/dist/cjs/api/resources/index.d.ts

@@ -9,3 +9,8 @@ export * from "./meta/types/index.js";
 export * from "./monitors/client/requests/index.js";
 export * as monitors from "./monitors/index.js";
 export * from "./monitors/types/index.js";
+export * from "./projects/client/requests/index.js";
+export * as projects from "./projects/index.js";
+export * from "./webhooks/client/requests/index.js";
+export * as webhooks from "./webhooks/index.js";
+export * from "./webhooks/types/index.js";

package/dist/cjs/api/resources/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.monitors = exports.meta = exports.jobs = exports.entities = exports.datasets = void 0;
+exports.webhooks = exports.projects = exports.monitors = exports.meta = exports.jobs = exports.entities = exports.datasets = void 0;
 __exportStar(require("./datasets/client/requests/index.js"), exports);
 exports.datasets = __importStar(require("./datasets/index.js"));
 __exportStar(require("./entities/client/requests/index.js"), exports);
@@ -48,3 +48,8 @@ __exportStar(require("./meta/types/index.js"), exports);
 __exportStar(require("./monitors/client/requests/index.js"), exports);
 exports.monitors = __importStar(require("./monitors/index.js"));
 __exportStar(require("./monitors/types/index.js"), exports);
+__exportStar(require("./projects/client/requests/index.js"), exports);
+exports.projects = __importStar(require("./projects/index.js"));
+__exportStar(require("./webhooks/client/requests/index.js"), exports);
+exports.webhooks = __importStar(require("./webhooks/index.js"));
+__exportStar(require("./webhooks/types/index.js"), exports);

package/dist/cjs/api/resources/jobs/client/Client.d.ts

@@ -22,10 +22,30 @@ export declare class JobsClient {
      * @throws {@link CatchAllApi.ForbiddenError}
      *
      * @example
-     *     await client.jobs.getUserJobs()
+     *     await client.jobs.getUserJobs({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
      */
     getUserJobs(request?: CatchAllApi.GetUserJobsRequest, requestOptions?: JobsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ListUserJobsResponseDto>;
     private __getUserJobs;
+    /**
+     * Checks whether a query is well-formed and likely to produce good results before submitting a job.
+     *
+     * Returns a quality assessment with a status level, identified issues, and actionable suggestions.
+     *
+     * @param {CatchAllApi.ValidateQueryRequestDto} request
+     * @param {JobsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.jobs.validateQuery({
+     *         query: "Series B funding rounds for SaaS startups"
+     *     })
+     */
+    validateQuery(request: CatchAllApi.ValidateQueryRequestDto, requestOptions?: JobsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ValidateQueryResponseDto>;
+    private __validateQuery;
     /**
      * Get suggested validators, enrichments, and date ranges for a query.
      *
@@ -116,11 +136,9 @@ export declare class JobsClient {
     continueJob(request: CatchAllApi.ContinueRequestDto, requestOptions?: JobsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ContinueResponseDto>;
     private __continueJob;
     /**
-     * Soft-deletes a job. The job is flagged as deleted and no longer
-     * appears in list results. The underlying data is retained.
+     * Soft-deletes a job. The job is flagged as deleted and no longer appears in list results. The underlying data is retained.
      *
-     * Only the job owner can delete a job. Returns `404` if the job is not
-     * found or does not belong to the authenticated user.
+     * Only the job owner can delete a job. Returns `404` if the job is not found or does not belong to the authenticated user.
      *
      * Deleting an already-deleted job returns `200`.
      *

package/dist/cjs/api/resources/jobs/client/Client.js

@@ -67,7 +67,9 @@ class JobsClient {
      * @throws {@link CatchAllApi.ForbiddenError}
      *
      * @example
-     *     await client.jobs.getUserJobs()
+     *     await client.jobs.getUserJobs({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
      */
     getUserJobs(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getUserJobs(request, requestOptions));
@@ -75,12 +77,13 @@ class JobsClient {
     __getUserJobs() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { page, page_size: pageSize, search, ownership } = request;
+            const { page, page_size: pageSize, search, ownership, project_id: projectId } = request;
             const _queryParams = {
                 page,
                 page_size: pageSize,
                 search,
                 ownership: ownership != null ? ownership : undefined,
+                project_id: projectId,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
@@ -117,6 +120,64 @@ class JobsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/catchAll/jobs/user");
         });
     }
+    /**
+     * Checks whether a query is well-formed and likely to produce good results before submitting a job.
+     *
+     * Returns a quality assessment with a status level, identified issues, and actionable suggestions.
+     *
+     * @param {CatchAllApi.ValidateQueryRequestDto} request
+     * @param {JobsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.jobs.validateQuery({
+     *         query: "Series B funding rounds for SaaS startups"
+     *     })
+     */
+    validateQuery(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__validateQuery(request, requestOptions));
+    }
+    __validateQuery(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CatchAllApiEnvironment.Default, "catchAll/validate"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new CatchAllApi.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new CatchAllApi.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.CatchAllApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/catchAll/validate");
+        });
+    }
     /**
      * Get suggested validators, enrichments, and date ranges for a query.
      *
@@ -415,11 +476,9 @@ class JobsClient {
         });
     }
     /**
-     * Soft-deletes a job. The job is flagged as deleted and no longer
-     * appears in list results. The underlying data is retained.
+     * Soft-deletes a job. The job is flagged as deleted and no longer appears in list results. The underlying data is retained.
      *
-     * Only the job owner can delete a job. Returns `404` if the job is not
-     * found or does not belong to the authenticated user.
+     * Only the job owner can delete a job. Returns `404` if the job is not found or does not belong to the authenticated user.
      *
      * Deleting an already-deleted job returns `200`.
      *

package/dist/cjs/api/resources/jobs/client/requests/GetUserJobsRequest.d.ts

@@ -1,7 +1,9 @@
 import type * as CatchAllApi from "../../../../index.js";
 /**
  * @example
- *     {}
+ *     {
+ *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+ *     }
  */
 export interface GetUserJobsRequest {
     /** Page number to retrieve. */
@@ -10,6 +12,7 @@ export interface GetUserJobsRequest {
     page_size?: number;
     /** Filter results by text (case-insensitive substring match). */
     search?: string;
-    /** Filter results by ownership. Defaults to `all`. */
     ownership?: CatchAllApi.OwnershipFilter;
+    /** Filter results to resources belonging to this project. */
+    project_id?: string;
 }

package/dist/cjs/api/resources/jobs/client/requests/SubmitRequestDto.d.ts

@@ -36,11 +36,21 @@ export interface SubmitRequestDto {
      */
     mode?: SubmitRequestDto.Mode;
     /**
-     * Dataset IDs to connect to this job. When provided, activates Company Watchlist mode — the job returns only events relevant to companies in the connected datasets with each record including a `connected_entities` array scored per company.
+     * Dataset IDs to connect to the job. When provided, this enables Company Watchlist mode — the job returns only events relevant to companies in the connected datasets. To set the minimum relevance threshold, use `ed_score_min`.
      *
      * The dataset must have `latest_status: ready` before the job is submitted. Submitting with a non-existent or inaccessible dataset ID returns `400`.
      */
     connected_dataset_ids?: string[];
+    /**
+     * The minimum relevance score a connected entity must reach for its record to be included in results.
+     *
+     * Only valid when `connected_dataset_ids` is set; otherwise ignored. Records where no connected entity meets the threshold are excluded entirely.
+     */
+    ed_score_min?: number;
+    /** Project to assign this job to. The job appears in the project's resource list immediately after submission. */
+    project_id?: string;
+    /** IDs of webhooks to notify when the job completes. Maximum 5 per job. */
+    webhook_ids?: string[];
 }
 export declare namespace SubmitRequestDto {
     /**

package/dist/cjs/api/resources/jobs/client/requests/ValidateQueryRequestDto.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         query: "Series B funding rounds for SaaS startups"
+ *     }
+ */
+export interface ValidateQueryRequestDto {
+    /** Plain text query to validate. */
+    query: string;
+}

package/dist/cjs/api/resources/jobs/client/requests/ValidateQueryRequestDto.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/jobs/client/requests/index.d.ts

@@ -5,3 +5,4 @@ export type { GetJobStatusRequest } from "./GetJobStatusRequest.js";
 export type { GetUserJobsRequest } from "./GetUserJobsRequest.js";
 export type { InitializeRequestDto } from "./InitializeRequestDto.js";
 export { SubmitRequestDto } from "./SubmitRequestDto.js";
+export type { ValidateQueryRequestDto } from "./ValidateQueryRequestDto.js";

package/dist/cjs/api/resources/monitors/client/Client.d.ts

@@ -23,7 +23,9 @@ export declare class MonitorsClient {
      * @throws {@link CatchAllApi.UnprocessableEntityError}
      *
      * @example
-     *     await client.monitors.listMonitors()
+     *     await client.monitors.listMonitors({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
      */
     listMonitors(request?: CatchAllApi.ListMonitorsRequest, requestOptions?: MonitorsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ListMonitorsResponseDto>;
     private __listMonitors;
@@ -38,14 +40,9 @@ export declare class MonitorsClient {
      * @example
      *     await client.monitors.createMonitor({
      *         reference_job_id: "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
-     *         schedule: "every day at 12 PM UTC",
-     *         webhook: {
-     *             url: "https://your-endpoint.com/webhook",
-     *             method: "POST",
-     *             headers: {
-     *                 "Authorization": "Bearer your_token_here"
-     *             }
-     *         },
+     *         schedule: "every day at 12 PM",
+     *         timezone: "UTC",
+     *         webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
      *         limit: 10,
      *         backfill: true
      *     })
@@ -171,13 +168,7 @@ export declare class MonitorsClient {
      * @example
      *     await client.monitors.updateMonitor({
      *         monitor_id: "monitor_id",
-     *         webhook: {
-     *             url: "https://new-endpoint.com/webhook",
-     *             method: "POST",
-     *             headers: {
-     *                 "Authorization": "Bearer new_token_xyz"
-     *             }
-     *         }
+     *         webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
      *     })
      */
     updateMonitor(request: CatchAllApi.UpdateMonitorRequestDto, requestOptions?: MonitorsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.UpdateMonitorResponseDto>;

package/dist/cjs/api/resources/monitors/client/Client.js

@@ -79,7 +79,9 @@ class MonitorsClient {
      * @throws {@link CatchAllApi.UnprocessableEntityError}
      *
      * @example
-     *     await client.monitors.listMonitors()
+     *     await client.monitors.listMonitors({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
      */
     listMonitors(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__listMonitors(request, requestOptions));
@@ -87,12 +89,13 @@ class MonitorsClient {
     __listMonitors() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { page, page_size: pageSize, search, ownership } = request;
+            const { page, page_size: pageSize, search, ownership, project_id: projectId } = request;
             const _queryParams = {
                 page,
                 page_size: pageSize,
                 search,
                 ownership: ownership != null ? ownership : undefined,
+                project_id: projectId,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
@@ -142,14 +145,9 @@ class MonitorsClient {
      * @example
      *     await client.monitors.createMonitor({
      *         reference_job_id: "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
-     *         schedule: "every day at 12 PM UTC",
-     *         webhook: {
-     *             url: "https://your-endpoint.com/webhook",
-     *             method: "POST",
-     *             headers: {
-     *                 "Authorization": "Bearer your_token_here"
-     *             }
-     *         },
+     *         schedule: "every day at 12 PM",
+     *         timezone: "UTC",
+     *         webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
      *         limit: 10,
      *         backfill: true
      *     })
@@ -558,13 +556,7 @@ class MonitorsClient {
      * @example
      *     await client.monitors.updateMonitor({
      *         monitor_id: "monitor_id",
-     *         webhook: {
-     *             url: "https://new-endpoint.com/webhook",
-     *             method: "POST",
-     *             headers: {
-     *                 "Authorization": "Bearer new_token_xyz"
-     *             }
-     *         }
+     *         webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
      *     })
      */
     updateMonitor(request, requestOptions) {

package/dist/cjs/api/resources/monitors/client/requests/CreateMonitorRequestDto.d.ts

@@ -1,16 +1,10 @@
-import type * as CatchAllApi from "../../../../index.js";
 /**
  * @example
  *     {
  *         reference_job_id: "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
- *         schedule: "every day at 12 PM UTC",
- *         webhook: {
- *             url: "https://your-endpoint.com/webhook",
- *             method: "POST",
- *             headers: {
- *                 "Authorization": "Bearer your_token_here"
- *             }
- *         },
+ *         schedule: "every day at 12 PM",
+ *         timezone: "UTC",
+ *         webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
  *         limit: 10,
  *         backfill: true
  *     }
@@ -22,14 +16,21 @@ export interface CreateMonitorRequestDto {
      * If [`backfill`](https://www.newscatcherapi.com/docs/web-search-api/api-reference/monitors/create-monitor#body-backfill) is true, the job's `end_date` must be within the last 7 days.
      */
     reference_job_id: string;
+    /** Monitor schedule in plain text format. Minimum frequency depends on your plan. */
+    schedule: string;
     /**
-     * Monitor schedule in plain text format (e.g. 'every day at 12 PM UTC', 'every 48 hours').
+     * The IANA timezone identifier used as the fallback when the `schedule` string does not include an explicit timezone.
      *
-     * Minimum frequency depends on your plan.
+     * If the schedule includes a timezone abbreviation (for example, `"every day at 9am EST"`), the parsed timezone takes priority and this value is ignored.
      */
-    schedule: string;
-    /** Optional webhook to receive notifications when jobs complete. */
-    webhook?: CatchAllApi.WebhookDto;
+    timezone?: string;
+    /**
+     * IDs of centralized webhooks to notify on each run completion.
+     * Passing IDs here is equivalent to calling
+     * `POST /catchAll/webhooks/{webhook_id}/resources` for each ID after creation.
+     * Maximum 5 per monitor.
+     */
+    webhook_ids?: string[];
     /** Maximum number of records per monitor run. If not provided, defaults to the plan limit. */
     limit?: number;
     /**
@@ -38,4 +39,6 @@ export interface CreateMonitorRequestDto {
      * If false, no gap filling occurs and the first run uses the current cron window only — the reference job's age does not matter.
      */
     backfill?: boolean;
+    /** Project to assign this monitor to. The monitor appears in the project's resource list after creation. */
+    project_id?: string;
 }

package/dist/cjs/api/resources/monitors/client/requests/ListMonitorsRequest.d.ts

@@ -1,7 +1,9 @@
 import type * as CatchAllApi from "../../../../index.js";
 /**
  * @example
- *     {}
+ *     {
+ *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+ *     }
  */
 export interface ListMonitorsRequest {
     /** Page number to retrieve. */
@@ -10,6 +12,7 @@ export interface ListMonitorsRequest {
     page_size?: number;
     /** Filter results by text (case-insensitive substring match). */
     search?: string;
-    /** Filter results by ownership. Defaults to `all`. */
     ownership?: CatchAllApi.OwnershipFilter;
+    /** Filter results to resources belonging to this project. */
+    project_id?: string;
 }

package/dist/cjs/api/resources/monitors/client/requests/UpdateMonitorRequestDto.d.ts

@@ -1,22 +1,19 @@
-import type * as CatchAllApi from "../../../../index.js";
 /**
  * @example
  *     {
  *         monitor_id: "monitor_id",
- *         webhook: {
- *             url: "https://new-endpoint.com/webhook",
- *             method: "POST",
- *             headers: {
- *                 "Authorization": "Bearer new_token_xyz"
- *             }
- *         }
+ *         webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
  *     }
  */
 export interface UpdateMonitorRequestDto {
     /** Monitor identifier. */
     monitor_id: string;
-    /** Updated webhook configuration. */
-    webhook?: CatchAllApi.WebhookDto;
+    /**
+     * Updated list of centralized webhook IDs for this monitor.
+     *
+     * Replaces all existing webhook assignments. Pass an empty array `[]` to clear all assignments. Omit to leave existing assignments unchanged.
+     */
+    webhook_ids?: string[];
     /** Updated maximum number of records per monitor run. */
     limit?: number;
 }

package/dist/cjs/api/resources/monitors/types/DisableMonitorResponse.d.ts

@@ -1,5 +1,5 @@
 export interface DisableMonitorResponse {
-    /** Whether the operation succeeded. */
+    /** True if the operation succeeded; false otherwise. */
     success: boolean;
     /** Human-readable success message. */
     message: string;

package/dist/cjs/api/resources/monitors/types/EnableMonitorResponse.d.ts

@@ -1,5 +1,5 @@
 export interface EnableMonitorResponse {
-    /** Whether the operation succeeded. */
+    /** True if the operation succeeded; false otherwise. */
     success: boolean;
     /** Human-readable success message. */
     message: string;

package/dist/cjs/api/resources/projects/client/Client.d.ts

@@ -0,0 +1,178 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as CatchAllApi from "../../../index.js";
+export declare namespace ProjectsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Operations to create, organize, and manage projects.
+ *
+ * A project is a named container for jobs, monitors, and datasets. Group
+ * related resources by use case, team, or client, and share them with
+ * teammates. Resources can be assigned at creation time or post-hoc.
+ */
+export declare class ProjectsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<ProjectsClient.Options>;
+    constructor(options?: ProjectsClient.Options);
+    /**
+     * Returns all projects visible to the authenticated user.
+     *
+     * @param {CatchAllApi.ListProjectsRequest} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.projects.listProjects({
+     *         search: "M&A"
+     *     })
+     */
+    listProjects(request?: CatchAllApi.ListProjectsRequest, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ProjectListResponseDto>;
+    private __listProjects;
+    /**
+     * Creates a new project.
+     *
+     * @param {CatchAllApi.CreateProjectRequestDto} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.projects.createProject({
+     *         name: "AI M&A Tracking",
+     *         description: "Tracks AI-related M&A activity for our investment team."
+     *     })
+     */
+    createProject(request: CatchAllApi.CreateProjectRequestDto, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.CreateProjectResponseDto>;
+    private __createProject;
+    /**
+     * Returns a single project by ID.
+     *
+     * @param {CatchAllApi.GetProjectRequest} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.NotFoundError}
+     *
+     * @example
+     *     await client.projects.getProject({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
+     */
+    getProject(request: CatchAllApi.GetProjectRequest, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ProjectResponseDto>;
+    private __getProject;
+    /**
+     * Deletes a project. By default, assigned resources are unassigned but not deleted.
+     *
+     * @param {CatchAllApi.DeleteProjectRequest} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.NotFoundError}
+     *
+     * @example
+     *     await client.projects.deleteProject({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
+     */
+    deleteProject(request: CatchAllApi.DeleteProjectRequest, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __deleteProject;
+    /**
+     * Updates the name or description of an existing project.
+     *
+     * @param {CatchAllApi.UpdateProjectRequestDto} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.NotFoundError}
+     * @throws {@link CatchAllApi.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.projects.updateProject({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04",
+     *         name: "AI M&A Tracking (Q2 2026)"
+     *     })
+     */
+    updateProject(request: CatchAllApi.UpdateProjectRequestDto, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.UpdateProjectResponseDto>;
+    private __updateProject;
+    /**
+     * Returns resource counts for a project, grouped by type and status.
+     *
+     * For `jobs` and `monitors`, counts are broken down by status (for example, `completed`, `failed`). For `datasets` and `monitor_groups`, only a `total` count is returned.
+     *
+     * @param {CatchAllApi.GetProjectOverviewRequest} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.NotFoundError}
+     *
+     * @example
+     *     await client.projects.getProjectOverview({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
+     */
+    getProjectOverview(request: CatchAllApi.GetProjectOverviewRequest, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ProjectOverviewResponseDto>;
+    private __getProjectOverview;
+    /**
+     * Returns all resources assigned to a project, with optional filtering by type.
+     *
+     * @param {CatchAllApi.ListProjectResourcesRequest} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.NotFoundError}
+     * @throws {@link CatchAllApi.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.projects.listProjectResources({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+     *     })
+     */
+    listProjectResources(request: CatchAllApi.ListProjectResourcesRequest, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.ProjectResourceListResponseDto>;
+    private __listProjectResources;
+    /**
+     * Assigns one or more existing resources to a project in a single request.
+     *
+     * @param {CatchAllApi.AddResourceRequestDto} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.BadRequestError}
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.NotFoundError}
+     *
+     * @example
+     *     await client.projects.addResourceToProject({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04",
+     *         resources: [{
+     *                 resource_type: "job",
+     *                 resource_id: "48421e16-1f50-4048-b62c-d3bc0789d30d"
+     *             }]
+     *     })
+     */
+    addResourceToProject(request: CatchAllApi.AddResourceRequestDto, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.AddResourceResponseDto>;
+    private __addResourceToProject;
+    /**
+     * Removes a resource from a project. The resource itself is not
+     * deleted — it becomes unassigned and continues to exist.
+     *
+     * @param {CatchAllApi.RemoveResourceFromProjectRequest} request
+     * @param {ProjectsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link CatchAllApi.ForbiddenError}
+     * @throws {@link CatchAllApi.NotFoundError}
+     *
+     * @example
+     *     await client.projects.removeResourceFromProject({
+     *         project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04",
+     *         resource_type: "job",
+     *         resource_id: "48421e16-1f50-4048-b62c-d3bc0789d30d"
+     *     })
+     */
+    removeResourceFromProject(request: CatchAllApi.RemoveResourceFromProjectRequest, requestOptions?: ProjectsClient.RequestOptions): core.HttpResponsePromise<CatchAllApi.RemoveResourceResponseDto>;
+    private __removeResourceFromProject;
+}