@airweave/sdk 0.7.20 → 0.8.77

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

@@ -59,18 +59,25 @@ class SourceConnections {
         this._options = _options;
     }
     /**
-     * List source connections with minimal fields for performance.
+     * Retrieve all source connections for your organization.
+     *
+     * Returns a lightweight list of source connections with essential fields for
+     * display and navigation. Use the collection filter to see connections within
+     * a specific collection.
+     *
+     * For full connection details including sync history, use the GET /{id} endpoint.
      *
      * @param {AirweaveSDK.ListSourceConnectionsGetRequest} request
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
      *     await client.sourceConnections.list({
      *         collection: "collection",
-     *         skip: 1,
-     *         limit: 1
+     *         skip: 0,
+     *         limit: 100
      *     })
      */
     list(request = {}, requestOptions) {
@@ -78,7 +85,7 @@ class SourceConnections {
     }
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g;
+            var _a, _b, _c;
             const { collection, skip, limit } = request;
             const _queryParams = {};
             if (collection != null) {
@@ -90,9 +97,9 @@ class SourceConnections {
             if (limit != null) {
                 _queryParams["limit"] = limit.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, "source-connections"),
+                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, "source-connections"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -110,6 +117,8 @@ class SourceConnections {
                 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,
@@ -136,30 +145,27 @@ class SourceConnections {
         });
     }
     /**
-     * Create a new source connection.
+     * Create a new source connection to sync data from an external source.
      *
-     * The authentication configuration determines the flow:
-     * - DirectAuthentication: Immediate creation with provided credentials
-     * - OAuthBrowserAuthentication: Returns shell with authentication URL
-     * - OAuthTokenAuthentication: Immediate creation with provided token
-     * - AuthProviderAuthentication: Using external auth provider
+     * The authentication method determines the creation flow:
      *
-     * BYOC (Bring Your Own Client) is detected when client_id and client_secret
-     * are provided in OAuthBrowserAuthentication.
+     * - **Direct**: Provide credentials (API key, token) directly. Connection is created immediately.
+     * - **OAuth Browser**: Returns a connection with an `auth_url` to redirect users for authentication.
+     * - **OAuth Token**: Provide an existing OAuth token. Connection is created immediately.
+     * - **Auth Provider**: Use a pre-configured auth provider (e.g., Composio, Pipedream).
      *
-     * sync_immediately defaults:
-     * - True for: direct, oauth_token, auth_provider
-     * - False for: oauth_browser, oauth_byoc (these sync after authentication)
+     * After successful authentication, data sync can begin automatically or on-demand.
      *
      * @param {AirweaveSDK.SourceConnectionCreate} request
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
      *     await client.sourceConnections.create({
-     *         short_name: "short_name",
-     *         readable_collection_id: "readable_collection_id"
+     *         short_name: "github",
+     *         readable_collection_id: "customer-support-tickets-x7k9m"
      *     })
      */
     create(request, requestOptions) {
@@ -167,10 +173,10 @@ class SourceConnections {
     }
     __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, "source-connections"),
+                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, "source-connections"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -188,6 +194,8 @@ class SourceConnections {
                 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,
@@ -214,25 +222,33 @@ class SourceConnections {
         });
     }
     /**
-     * Get a source connection with optional depth expansion.
+     * Retrieve details of a specific source connection.
+     *
+     * Returns complete information about the connection including:
+     * - Configuration settings
+     * - Authentication status
+     * - Sync schedule and history
+     * - Entity statistics
      *
-     * @param {string} sourceConnectionId
+     * @param {string} sourceConnectionId - Unique identifier of the source connection (UUID)
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.sourceConnections.get("source_connection_id")
+     *     await client.sourceConnections.get("550e8400-e29b-41d4-a716-446655440000")
      */
     get(sourceConnectionId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__get(sourceConnectionId, requestOptions));
     }
     __get(sourceConnectionId, 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, `source-connections/${encodeURIComponent(sourceConnectionId)}`),
+                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, `source-connections/${encodeURIComponent(sourceConnectionId)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -245,8 +261,12 @@ class SourceConnections {
             }
             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,
@@ -273,25 +293,34 @@ class SourceConnections {
         });
     }
     /**
-     * Delete a source connection and all related data.
+     * Permanently delete a source connection and all its synced data.
+     *
+     * This operation:
+     * - Removes all entities synced from this source from the vector database
+     * - Cancels any scheduled or running sync jobs
+     * - Deletes the connection configuration and credentials
+     *
+     * **Warning**: This action cannot be undone. All synced data will be permanently deleted.
      *
-     * @param {string} sourceConnectionId
+     * @param {string} sourceConnectionId - Unique identifier of the source connection to delete (UUID)
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.sourceConnections.delete("source_connection_id")
+     *     await client.sourceConnections.delete("550e8400-e29b-41d4-a716-446655440000")
      */
     delete(sourceConnectionId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__delete(sourceConnectionId, requestOptions));
     }
     __delete(sourceConnectionId, 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, `source-connections/${encodeURIComponent(sourceConnectionId)}`),
+                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, `source-connections/${encodeURIComponent(sourceConnectionId)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -304,8 +333,12 @@ class SourceConnections {
             }
             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,
@@ -332,32 +365,36 @@ class SourceConnections {
         });
     }
     /**
-     * Update a source connection.
+     * Update an existing source connection's configuration.
      *
-     * Updateable fields:
-     * - name, description
-     * - config_fields
-     * - cron_schedule
-     * - auth_fields (direct auth only)
+     * You can modify:
+     * - **Name and description**: Display information
+     * - **Configuration**: Source-specific settings (e.g., repository name, filters)
+     * - **Schedule**: Cron expression for automatic syncs
+     * - **Authentication**: Update credentials (direct auth only)
      *
-     * @param {string} sourceConnectionId
+     * Only include the fields you want to change; omitted fields retain their current values.
+     *
+     * @param {string} sourceConnectionId - Unique identifier of the source connection to update (UUID)
      * @param {AirweaveSDK.SourceConnectionUpdate} request
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.sourceConnections.update("source_connection_id")
+     *     await client.sourceConnections.update("550e8400-e29b-41d4-a716-446655440000")
      */
     update(sourceConnectionId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__update(sourceConnectionId, request, requestOptions));
     }
     __update(sourceConnectionId_1) {
         return __awaiter(this, arguments, void 0, function* (sourceConnectionId, request = {}, requestOptions) {
-            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, `source-connections/${encodeURIComponent(sourceConnectionId)}`),
+                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, `source-connections/${encodeURIComponent(sourceConnectionId)}`),
                 method: "PATCH",
                 headers: _headers,
                 contentType: "application/json",
@@ -373,8 +410,12 @@ class SourceConnections {
             }
             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,
@@ -401,28 +442,27 @@ class SourceConnections {
         });
     }
     /**
-     * Trigger a sync run for a source connection.
+     * Trigger a data synchronization job for a source connection.
      *
-     * Runs are always executed through Temporal workflow engine.
+     * Starts an asynchronous sync job that pulls the latest data from the connected
+     * source. The job runs in the background and you can monitor its progress using
+     * the jobs endpoint.
      *
-     * Args:
-     *     db: Database session
-     *     source_connection_id: ID of the source connection to run
-     *     ctx: API context with organization and user information
-     *     guard_rail: Guard rail service for usage limits
-     *     force_full_sync: If True, forces a full sync with orphaned entity cleanup
-     *                     for continuous syncs. Raises 400 error if used on
-     *                     non-continuous syncs (which are always full syncs).
+     * For continuous sync connections, this performs an incremental sync by default.
+     * Use `force_full_sync=true` to perform a complete re-sync of all data.
      *
-     * @param {string} sourceConnectionId
+     * @param {string} sourceConnectionId - Unique identifier of the source connection to sync (UUID)
      * @param {AirweaveSDK.RunSourceConnectionsSourceConnectionIdRunPostRequest} request
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
+     * @throws {@link AirweaveSDK.ConflictError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.sourceConnections.run("source_connection_id", {
-     *         force_full_sync: true
+     *     await client.sourceConnections.run("550e8400-e29b-41d4-a716-446655440000", {
+     *         force_full_sync: false
      *     })
      */
     run(sourceConnectionId, request = {}, requestOptions) {
@@ -430,15 +470,15 @@ class SourceConnections {
     }
     __run(sourceConnectionId_1) {
         return __awaiter(this, arguments, void 0, function* (sourceConnectionId, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g;
+            var _a, _b, _c;
             const { force_full_sync: forceFullSync } = request;
             const _queryParams = {};
             if (forceFullSync != null) {
                 _queryParams["force_full_sync"] = forceFullSync.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, `source-connections/${encodeURIComponent(sourceConnectionId)}/run`),
+                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, `source-connections/${encodeURIComponent(sourceConnectionId)}/run`),
                 method: "POST",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -451,8 +491,14 @@ class SourceConnections {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AirweaveSDK.ConflictError(_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,
@@ -479,17 +525,30 @@ class SourceConnections {
         });
     }
     /**
-     * Get sync jobs for a source connection.
+     * Retrieve the sync job history for a source connection.
+     *
+     * Returns a list of sync jobs ordered by creation time (newest first). Each job
+     * includes status, timing information, and entity counts.
      *
-     * @param {string} sourceConnectionId
+     * Job statuses:
+     * - **PENDING**: Job is queued and waiting to start
+     * - **RUNNING**: Sync is actively pulling and processing data
+     * - **COMPLETED**: Sync finished successfully
+     * - **FAILED**: Sync encountered an error
+     * - **CANCELLED**: Sync was manually cancelled
+     * - **CANCELLING**: Cancellation has been requested
+     *
+     * @param {string} sourceConnectionId - Unique identifier of the source connection (UUID)
      * @param {AirweaveSDK.GetSourceConnectionJobsSourceConnectionsSourceConnectionIdJobsGetRequest} request
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.sourceConnections.getSourceConnectionJobs("source_connection_id", {
-     *         limit: 1
+     *     await client.sourceConnections.getSourceConnectionJobs("550e8400-e29b-41d4-a716-446655440000", {
+     *         limit: 100
      *     })
      */
     getSourceConnectionJobs(sourceConnectionId, request = {}, requestOptions) {
@@ -497,15 +556,15 @@ class SourceConnections {
     }
     __getSourceConnectionJobs(sourceConnectionId_1) {
         return __awaiter(this, arguments, void 0, function* (sourceConnectionId, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g;
+            var _a, _b, _c;
             const { limit } = request;
             const _queryParams = {};
             if (limit != null) {
                 _queryParams["limit"] = limit.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, `source-connections/${encodeURIComponent(sourceConnectionId)}/jobs`),
+                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, `source-connections/${encodeURIComponent(sourceConnectionId)}/jobs`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -518,8 +577,12 @@ class SourceConnections {
             }
             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,
@@ -546,30 +609,35 @@ class SourceConnections {
         });
     }
     /**
-     * Cancel a running sync job for a source connection.
+     * Request cancellation of a running sync job.
+     *
+     * The job will be marked as CANCELLING and the sync workflow will stop at the
+     * next checkpoint. Already-processed entities are retained.
      *
-     * This endpoint requests cancellation and marks the job as CANCELLING.
-     * The workflow updates the final status to CANCELLED when it processes
-     * the cancellation request.
+     * **Note**: Cancellation is asynchronous. The job status will change to CANCELLED
+     * once the workflow has fully stopped.
      *
-     * @param {string} sourceConnectionId
-     * @param {string} jobId
+     * @param {string} sourceConnectionId - Unique identifier of the source connection (UUID)
+     * @param {string} jobId - Unique identifier of the sync job to cancel (UUID)
      * @param {SourceConnections.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AirweaveSDK.NotFoundError}
+     * @throws {@link AirweaveSDK.ConflictError}
      * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     * @throws {@link AirweaveSDK.TooManyRequestsError}
      *
      * @example
-     *     await client.sourceConnections.cancelJob("source_connection_id", "job_id")
+     *     await client.sourceConnections.cancelJob("550e8400-e29b-41d4-a716-446655440000", "660e8400-e29b-41d4-a716-446655440001")
      */
     cancelJob(sourceConnectionId, jobId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__cancelJob(sourceConnectionId, jobId, requestOptions));
     }
     __cancelJob(sourceConnectionId, jobId, 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, `source-connections/${encodeURIComponent(sourceConnectionId)}/jobs/${encodeURIComponent(jobId)}/cancel`),
+                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, `source-connections/${encodeURIComponent(sourceConnectionId)}/jobs/${encodeURIComponent(jobId)}/cancel`),
                 method: "POST",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -582,8 +650,14 @@ class SourceConnections {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AirweaveSDK.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AirweaveSDK.ConflictError(_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/sourceConnections/client/requests/GetSourceConnectionJobsSourceConnectionsSourceConnectionIdJobsGetRequest.d.ts

@@ -4,9 +4,10 @@
 /**
  * @example
  *     {
- *         limit: 1
+ *         limit: 100
  *     }
  */
 export interface GetSourceConnectionJobsSourceConnectionsSourceConnectionIdJobsGetRequest {
+    /** Maximum number of jobs to return (1-1000) */
     limit?: number;
 }

package/dist/cjs/api/resources/sourceConnections/client/requests/ListSourceConnectionsGetRequest.d.ts

@@ -5,13 +5,15 @@
  * @example
  *     {
  *         collection: "collection",
- *         skip: 1,
- *         limit: 1
+ *         skip: 0,
+ *         limit: 100
  *     }
  */
 export interface ListSourceConnectionsGetRequest {
     /** Filter by collection readable ID */
     collection?: string;
+    /** Number of connections to skip for pagination */
     skip?: number;
+    /** Maximum number of connections to return (1-1000) */
     limit?: number;
 }

package/dist/cjs/api/resources/sourceConnections/client/requests/RunSourceConnectionsSourceConnectionIdRunPostRequest.d.ts

@@ -4,10 +4,10 @@
 /**
  * @example
  *     {
- *         force_full_sync: true
+ *         force_full_sync: false
  *     }
  */
 export interface RunSourceConnectionsSourceConnectionIdRunPostRequest {
-    /** Force a full sync ignoring cursor data instead of waiting for the daily cleanup schedule. Only allowed for continuous syncs. */
+    /** Force a full sync ignoring cursor data. Only applies to continuous sync connections. Non-continuous connections always perform full syncs. */
     force_full_sync?: boolean;
 }

package/dist/cjs/api/resources/sourceConnections/client/requests/SourceConnectionCreate.d.ts

@@ -5,32 +5,33 @@ import * as AirweaveSDK from "../../../../index.js";
 /**
  * @example
  *     {
- *         short_name: "short_name",
- *         readable_collection_id: "readable_collection_id"
+ *         short_name: "github",
+ *         readable_collection_id: "customer-support-tickets-x7k9m"
  *     }
  */
 export interface SourceConnectionCreate {
-    /** Connection name (defaults to '{Source Name} Connection') */
+    /** Display name for the connection. If not provided, defaults to '{Source Name} Connection'. */
     name?: string;
-    /** Source identifier (e.g., 'slack', 'github') */
+    /** Source type identifier (e.g., 'slack', 'github', 'notion') */
     short_name: string;
-    /** Collection readable ID */
+    /** The readable ID of the collection to add this connection to */
     readable_collection_id: string;
-    /** Connection description */
+    /** Optional description of what this connection is used for */
     description?: string;
-    /** Source-specific configuration */
+    /** Source-specific configuration (e.g., repository name, filters) */
     config?: Record<string, unknown>;
+    /** Optional sync schedule configuration */
     schedule?: AirweaveSDK.ScheduleConfig;
     /** Run initial sync after creation. Defaults to True for direct/token/auth_provider, False for OAuth browser/BYOC flows (which sync after authentication) */
     sync_immediately?: boolean;
-    /** Authentication config (defaults to OAuth browser flow for OAuth sources) */
+    /** Authentication configuration. Type is auto-detected from provided fields. */
     authentication?: SourceConnectionCreate.Authentication;
     /** URL to redirect to after OAuth flow completes (only used for OAuth flows) */
     redirect_url?: string;
 }
 export declare namespace SourceConnectionCreate {
     /**
-     * Authentication config (defaults to OAuth browser flow for OAuth sources)
+     * Updated authentication credentials (direct auth only)
      */
     type Authentication = AirweaveSDK.DirectAuthentication | AirweaveSDK.OAuthTokenAuthentication | AirweaveSDK.OAuthBrowserAuthentication | AirweaveSDK.AuthProviderAuthentication;
 }

package/dist/cjs/api/resources/sourceConnections/client/requests/SourceConnectionUpdate.d.ts

@@ -7,17 +7,20 @@ import * as AirweaveSDK from "../../../../index.js";
  *     {}
  */
 export interface SourceConnectionUpdate {
+    /** Updated display name for the connection */
     name?: string;
+    /** Updated description */
     description?: string;
-    /** Source-specific configuration */
+    /** Updated source-specific configuration */
     config?: Record<string, unknown>;
+    /** Updated sync schedule configuration */
     schedule?: AirweaveSDK.ScheduleConfig;
-    /** Authentication config (defaults to OAuth browser flow for OAuth sources) */
+    /** Updated authentication credentials (direct auth only) */
     authentication?: SourceConnectionUpdate.Authentication;
 }
 export declare namespace SourceConnectionUpdate {
     /**
-     * Authentication config (defaults to OAuth browser flow for OAuth sources)
+     * Updated authentication credentials (direct auth only)
      */
     type Authentication = AirweaveSDK.DirectAuthentication | AirweaveSDK.OAuthTokenAuthentication | AirweaveSDK.OAuthBrowserAuthentication | AirweaveSDK.AuthProviderAuthentication;
 }