@airweave/sdk 0.7.19 → 0.8.76

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

@@ -59,20 +59,25 @@ class Collections {
         this._options = _options;
     }
     /**
-     * List all collections that belong to your organization with optional search filtering.
+     * Retrieve all collections belonging to your organization.
      *
-     * Collections are always sorted by creation date (newest first).
+     * Collections are containers that group related data from one or more source
+     * connections, enabling unified search across multiple data sources.
+     *
+     * Results are sorted by creation date (newest first) and support pagination
+     * and text search filtering.
      *
      * @param {AirweaveSDK.ListCollectionsGetRequest} request
      * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
      *     await client.collections.list({
-     *         skip: 1,
-     *         limit: 1,
-     *         search: "search"
+     *         skip: 0,
+     *         limit: 100,
+     *         search: "customer"
      *     })
      */
     list(request = {}, requestOptions) {
@@ -80,7 +85,7 @@ class Collections {
     }
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g;
+            var _a, _b, _c;
             const { skip, limit, search } = request;
             const _queryParams = {};
             if (skip != null) {
@@ -92,9 +97,9 @@ class Collections {
             if (search != null) {
                 _queryParams["search"] = search;
             }
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "X-Framework-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.frameworkName, "X-Framework-Version": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.frameworkVersion }, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_g = (_f = (yield core.Supplier.get(this._options.baseUrl))) !== null && _f !== void 0 ? _f : (yield core.Supplier.get(this._options.environment))) !== null && _g !== void 0 ? _g : environments.AirweaveSDKEnvironment.Production, "collections"),
+                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.AirweaveSDKEnvironment.Production, "collections"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -109,6 +114,8 @@ class Collections {
                 switch (_response.error.statusCode) {
                     case 422:
                         throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.AirweaveSDKError({
                             statusCode: _response.error.statusCode,
@@ -135,15 +142,22 @@ class Collections {
         });
     }
     /**
-     * Create a new collection.
+     * Create a new collection in your organization.
+     *
+     * Collections are containers for organizing and searching across data from multiple
+     * sources. After creation, add source connections to begin syncing data.
      *
-     * The newly created collection is initially empty and does not contain any data
-     * until you explicitly add source connections to it.
+     * The collection will be assigned a unique `readable_id` based on the name you provide,
+     * which is used in URLs and API calls. You can optionally configure:
+     *
+     * - **Sync schedule**: How frequently to automatically sync data from all sources
+     * - **Custom readable_id**: Provide your own identifier (must be unique and URL-safe)
      *
      * @param {AirweaveSDK.CollectionCreate} request
      * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
      *     await client.collections.create({
@@ -156,10 +170,10 @@ class Collections {
     }
     __create(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "X-Framework-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.frameworkName, "X-Framework-Version": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.frameworkVersion }, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_g = (_f = (yield core.Supplier.get(this._options.baseUrl))) !== null && _f !== void 0 ? _f : (yield core.Supplier.get(this._options.environment))) !== null && _g !== void 0 ? _g : environments.AirweaveSDKEnvironment.Production, "collections"),
+                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.AirweaveSDKEnvironment.Production, "collections"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -177,6 +191,8 @@ class Collections {
                 switch (_response.error.statusCode) {
                     case 422:
                         throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.AirweaveSDKError({
                             statusCode: _response.error.statusCode,
@@ -203,25 +219,31 @@ class Collections {
         });
     }
     /**
-     * Retrieve a specific collection by its readable ID.
+     * Retrieve details of a specific collection by its readable ID.
+     *
+     * Returns the complete collection configuration including sync settings, status,
+     * and metadata. Use this to check the current state of a collection or to get
+     * configuration details before making updates.
      *
      * @param {string} readableId - The unique readable identifier of the collection (e.g., 'finance-data-ab123')
      * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.collections.get("readable_id")
+     *     await client.collections.get("customer-support-tickets-x7k9m")
      */
     get(readableId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__get(readableId, requestOptions));
     }
     __get(readableId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "X-Framework-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.frameworkName, "X-Framework-Version": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.frameworkVersion }, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_g = (_f = (yield core.Supplier.get(this._options.baseUrl))) !== null && _f !== void 0 ? _f : (yield core.Supplier.get(this._options.environment))) !== null && _g !== void 0 ? _g : environments.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}`),
+                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.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -234,8 +256,12 @@ class Collections {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.AirweaveSDKError({
                             statusCode: _response.error.statusCode,
@@ -262,29 +288,35 @@ class Collections {
         });
     }
     /**
-     * Delete a collection and all associated data.
+     * Permanently delete a collection and all associated data.
      *
-     * Permanently removes a collection from your organization including all synced data
-     * from the destination systems. All source connections within this collection
-     * will also be deleted as part of the cleanup process. This action cannot be undone.
+     * This operation:
+     * - Removes all synced data from the vector database
+     * - Deletes all source connections within the collection
+     * - Cancels any scheduled sync jobs
+     * - Cleans up all related resources
+     *
+     * **Warning**: This action cannot be undone. All data will be permanently deleted.
      *
      * @param {string} readableId - The unique readable identifier of the collection to delete
      * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.collections.delete("readable_id")
+     *     await client.collections.delete("customer-support-tickets-x7k9m")
      */
     delete(readableId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__delete(readableId, requestOptions));
     }
     __delete(readableId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "X-Framework-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.frameworkName, "X-Framework-Version": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.frameworkVersion }, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_g = (_f = (yield core.Supplier.get(this._options.baseUrl))) !== null && _f !== void 0 ? _f : (yield core.Supplier.get(this._options.environment))) !== null && _g !== void 0 ? _g : environments.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}`),
+                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.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -297,8 +329,12 @@ class Collections {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.AirweaveSDKError({
                             statusCode: _response.error.statusCode,
@@ -325,30 +361,111 @@ class Collections {
         });
     }
     /**
-     * Trigger data synchronization for all source connections in the collection.
+     * Update an existing collection's properties.
+     *
+     * You can modify:
+     * - **Name**: The display name shown in the UI
+     * - **Sync configuration**: Schedule settings for automatic data synchronization
+     *
+     * Note that the `readable_id` cannot be changed after creation to maintain stable
+     * API endpoints and preserve existing integrations.
+     *
+     * @param {string} readableId - The unique readable identifier of the collection to update
+     * @param {AirweaveSDK.CollectionUpdate} request
+     * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AirweaveSDK.NotFoundError}
+     * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
+     *
+     * @example
+     *     await client.collections.update("customer-support-tickets-x7k9m", {
+     *         name: "Updated Finance Data"
+     *     })
+     */
+    update(readableId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(readableId, request, requestOptions));
+    }
+    __update(readableId_1) {
+        return __awaiter(this, arguments, void 0, function* (readableId, request = {}, requestOptions) {
+            var _a, _b, _c;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), 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.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AirweaveSDKError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AirweaveSDKError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AirweaveSDKTimeoutError("Timeout exceeded when calling PATCH /collections/{readable_id}.");
+                case "unknown":
+                    throw new errors.AirweaveSDKError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Trigger data synchronization for all source connections in a collection.
      *
-     * The sync jobs run asynchronously in the background, so this endpoint
-     * returns immediately with job details that you can use to track progress. You can
-     * monitor the status of individual data synchronization using the source connection
-     * endpoints.
+     * Starts sync jobs for every source connection in the collection, pulling the latest
+     * data from each connected source. Jobs run asynchronously in the background.
+     *
+     * Returns a list of sync jobs that were created. Use the source connection endpoints
+     * to monitor the progress and status of individual sync jobs.
      *
      * @param {string} readableId - The unique readable identifier of the collection to refresh
      * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.collections.refreshAllSourceConnections("readable_id")
+     *     await client.collections.refreshAllSourceConnections("customer-support-tickets-x7k9m")
      */
     refreshAllSourceConnections(readableId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__refreshAllSourceConnections(readableId, requestOptions));
     }
     __refreshAllSourceConnections(readableId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "X-Framework-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.frameworkName, "X-Framework-Version": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.frameworkVersion }, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_g = (_f = (yield core.Supplier.get(this._options.baseUrl))) !== null && _f !== void 0 ? _f : (yield core.Supplier.get(this._options.environment))) !== null && _g !== void 0 ? _g : environments.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/refresh_all`),
+                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.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/refresh_all`),
                 method: "POST",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -361,8 +478,12 @@ class Collections {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.AirweaveSDKError({
                             statusCode: _response.error.statusCode,
@@ -389,23 +510,29 @@ class Collections {
         });
     }
     /**
-     * Legacy GET search endpoint for backwards compatibility.
+     * **DEPRECATED**: Use POST /collections/{readable_id}/search instead.
      *
-     * DEPRECATED: This endpoint uses the old schema. Please migrate to POST with the new
-     * SearchRequest format for access to all features.
+     * This legacy GET endpoint provides basic search functionality via query parameters.
+     * Migrate to the POST endpoint for access to advanced features like:
+     * - Structured filters
+     * - Query expansion
+     * - Reranking
+     * - Streaming responses
      *
      * @param {string} readableId - The unique readable identifier of the collection to search
      * @param {AirweaveSDK.SearchGetLegacyCollectionsReadableIdSearchGetRequest} request
      * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.collections.searchGetLegacy("readable_id", {
-     *         query: "query",
+     *     await client.collections.searchGetLegacy("customer-support-tickets-x7k9m", {
+     *         query: "How do I reset my password?",
      *         response_type: "raw",
-     *         limit: 1,
-     *         offset: 1,
+     *         limit: 10,
+     *         offset: 0,
      *         recency_bias: 1.1
      *     })
      */
@@ -414,7 +541,7 @@ class Collections {
     }
     __searchGetLegacy(readableId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g;
+            var _a, _b, _c;
             const { query, response_type: responseType, limit, offset, recency_bias: recencyBias } = request;
             const _queryParams = {};
             _queryParams["query"] = query;
@@ -430,9 +557,9 @@ class Collections {
             if (recencyBias != null) {
                 _queryParams["recency_bias"] = recencyBias.toString();
             }
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "X-Framework-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.frameworkName, "X-Framework-Version": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.frameworkVersion }, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_g = (_f = (yield core.Supplier.get(this._options.baseUrl))) !== null && _f !== void 0 ? _f : (yield core.Supplier.get(this._options.environment))) !== null && _g !== void 0 ? _g : environments.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/search`),
+                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.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/search`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -445,8 +572,12 @@ class Collections {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.AirweaveSDKError({
                             statusCode: _response.error.statusCode,
@@ -473,20 +604,35 @@ class Collections {
         });
     }
     /**
-     * Search your collection.
+     * Search your collection using semantic and hybrid search.
+     *
+     * This is the primary search endpoint providing powerful AI-powered search capabilities:
      *
-     * Accepts both new SearchRequest and legacy LegacySearchRequest formats
+     * **Search Strategies:**
+     * - **hybrid** (default): Combines neural (semantic) and keyword (BM25) matching
+     * - **neural**: Pure semantic search using embeddings
+     * - **keyword**: Traditional keyword-based BM25 search
+     *
+     * **Features:**
+     * - **Query expansion**: Generate query variations to improve recall
+     * - **Filter interpretation**: Extract structured filters from natural language
+     * - **Reranking**: LLM-based reranking for improved relevance
+     * - **Answer generation**: AI-generated answers based on search results
+     *
+     * **Note**: Accepts both new SearchRequest and legacy LegacySearchRequest formats
      * for backwards compatibility.
      *
-     * @param {string} readableId - The unique readable identifier of the collection
+     * @param {string} readableId - The unique readable identifier of the collection to search
      * @param {AirweaveSDK.SearchCollectionsReadableIdSearchPostRequest} request
      * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.collections.search("readable_id", {
-     *         query: "query"
+     *     await client.collections.search("customer-support-tickets-x7k9m", {
+     *         query: "How do I reset my password?"
      *     })
      */
     search(readableId, request, requestOptions) {
@@ -494,10 +640,10 @@ class Collections {
     }
     __search(readableId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({ "X-Framework-Name": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkName) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.frameworkName, "X-Framework-Version": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.frameworkVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.frameworkVersion }, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_g = (_f = (yield core.Supplier.get(this._options.baseUrl))) !== null && _f !== void 0 ? _f : (yield core.Supplier.get(this._options.environment))) !== null && _g !== void 0 ? _g : environments.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/search`),
+                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.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/search`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -509,15 +655,16 @@ class Collections {
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return {
-                    data: _response.body,
-                    rawResponse: _response.rawResponse,
-                };
+                return { data: _response.body, rawResponse: _response.rawResponse };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new AirweaveSDK.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AirweaveSDK.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.AirweaveSDKError({
                             statusCode: _response.error.statusCode,

package/dist/cjs/api/resources/collections/client/requests/CollectionCreate.d.ts

@@ -1,6 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as AirweaveSDK from "../../../../index.js";
 /**
  * @example
  *     {
@@ -13,4 +14,6 @@ export interface CollectionCreate {
     name: string;
     /** URL-safe unique identifier used in API endpoints. Must contain only lowercase letters, numbers, and hyphens. If not provided, it will be automatically generated from the collection name with a random suffix for uniqueness (e.g., 'finance-data-ab123'). */
     readable_id?: string;
+    /** Default sync configuration for all syncs in this collection. This provides collection-level defaults that can be overridden at sync or job level. */
+    sync_config?: AirweaveSDK.SyncConfig;
 }

package/dist/cjs/api/resources/collections/client/requests/CollectionUpdate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AirweaveSDK from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         name: "Updated Finance Data"
+ *     }
+ */
+export interface CollectionUpdate {
+    /** Updated display name for the collection. Must be between 4 and 64 characters. */
+    name?: string;
+    /** Default sync configuration for all syncs in this collection. This provides collection-level defaults that can be overridden at sync or job level. */
+    sync_config?: AirweaveSDK.SyncConfig;
+}

package/dist/cjs/api/resources/collections/client/requests/ListCollectionsGetRequest.d.ts

@@ -4,9 +4,9 @@
 /**
  * @example
  *     {
- *         skip: 1,
- *         limit: 1,
- *         search: "search"
+ *         skip: 0,
+ *         limit: 100,
+ *         search: "customer"
  *     }
  */
 export interface ListCollectionsGetRequest {
@@ -14,6 +14,6 @@ export interface ListCollectionsGetRequest {
     skip?: number;
     /** Maximum number of collections to return (1-1000) */
     limit?: number;
-    /** Search term to filter by name or readable_id */
+    /** Search term to filter collections by name or readable_id */
     search?: string;
 }

package/dist/cjs/api/resources/collections/client/requests/SearchGetLegacyCollectionsReadableIdSearchGetRequest.d.ts

@@ -5,10 +5,10 @@ import * as AirweaveSDK from "../../../../index.js";
 /**
  * @example
  *     {
- *         query: "query",
+ *         query: "How do I reset my password?",
  *         response_type: "raw",
- *         limit: 1,
- *         offset: 1,
+ *         limit: 10,
+ *         offset: 0,
  *         recency_bias: 1.1
  *     }
  */
@@ -21,6 +21,6 @@ export interface SearchGetLegacyCollectionsReadableIdSearchGetRequest {
     limit?: number;
     /** Number of results to skip for pagination */
     offset?: number;
-    /** How much to weigh recency vs similarity (0..1) */
+    /** How much to weigh recency vs similarity (0=similarity only, 1=recency only) */
     recency_bias?: number;
 }

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

@@ -1,3 +1,4 @@
 export { type ListCollectionsGetRequest } from "./ListCollectionsGetRequest.js";
 export { type CollectionCreate } from "./CollectionCreate.js";
+export { type CollectionUpdate } from "./CollectionUpdate.js";
 export { type SearchGetLegacyCollectionsReadableIdSearchGetRequest } from "./SearchGetLegacyCollectionsReadableIdSearchGetRequest.js";

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

@@ -1,2 +1 @@
 export * from "./SearchCollectionsReadableIdSearchPostRequest.js";
-export * from "./SearchCollectionsReadableIdSearchPostResponse.js";

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

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./SearchCollectionsReadableIdSearchPostRequest.js"), exports);
-__exportStar(require("./SearchCollectionsReadableIdSearchPostResponse.js"), exports);

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

@@ -2,5 +2,7 @@ export * as collections from "./collections/index.js";
 export * from "./collections/types/index.js";
 export * as sources from "./sources/index.js";
 export * as sourceConnections from "./sourceConnections/index.js";
+export * as webhooks from "./webhooks/index.js";
 export * from "./collections/client/requests/index.js";
 export * from "./sourceConnections/client/requests/index.js";
+export * from "./webhooks/client/requests/index.js";

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

@@ -36,10 +36,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sourceConnections = exports.sources = exports.collections = void 0;
+exports.webhooks = exports.sourceConnections = exports.sources = exports.collections = void 0;
 exports.collections = __importStar(require("./collections/index.js"));
 __exportStar(require("./collections/types/index.js"), exports);
 exports.sources = __importStar(require("./sources/index.js"));
 exports.sourceConnections = __importStar(require("./sourceConnections/index.js"));
+exports.webhooks = __importStar(require("./webhooks/index.js"));
 __exportStar(require("./collections/client/requests/index.js"), exports);
 __exportStar(require("./sourceConnections/client/requests/index.js"), exports);
+__exportStar(require("./webhooks/client/requests/index.js"), exports);