@hydradb/sdk 2.1.1 → 2.1.3

package/dist/api/resources/connectors/client/Client.js

@@ -48,7 +48,7 @@ class ConnectorsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * List a provider's resources directly from supplied credentials, before creating a connector.
+     * List a provider's resources directly from supplied credentials, before creating a connector. Passing cursor or limit opts into pagination (currently Notion only): the response then adds next_cursor and has_more, a page may hold fewer than limit resources, and clients must continue while has_more is true. Without either param the full resource list is returned.
      *
      * @param {HydraDB.HandlerDiscoverPreviewReq} request
      * @param {ConnectorsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -68,6 +68,11 @@ class ConnectorsClient {
         return core.HttpResponsePromise.fromPromise(this.__discoverPreview(request, requestOptions));
     }
     async __discoverPreview(request, requestOptions) {
+        const { cursor, limit, ..._body } = request;
+        const _queryParams = {
+            cursor,
+            limit,
+        };
         const _authRequest = await this._options.authProvider.getAuthRequest();
         const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
         const _response = await core.fetcher({
@@ -77,9 +82,13 @@ class ConnectorsClient {
             method: "POST",
             headers: _headers,
             contentType: "application/json",
-            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
             requestType: "json",
-            body: serializers.HandlerDiscoverPreviewReq.jsonOrThrow(request, {
+            body: serializers.HandlerDiscoverPreviewReq.jsonOrThrow(_body, {
                 unrecognizedObjectKeys: "strip",
                 omitUndefined: true,
             }),
@@ -91,7 +100,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.discoverPreview.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerDiscoverResponseBody.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -171,7 +180,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.list.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerConnectorListResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -184,13 +193,7 @@ class ConnectorsClient {
         if (_response.error.reason === "status-code") {
             switch (_response.error.statusCode) {
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -243,7 +246,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.ConnectorsConnector.parseOrThrow(_response.body, {
+                data: serializers.HandlerConnectorCreateResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -264,13 +267,7 @@ class ConnectorsClient {
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 case 503:
                     throw new HydraDB.ServiceUnavailableError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -325,7 +322,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.ConnectorsConnector.parseOrThrow(_response.body, {
+                data: serializers.HandlerConnectorApiView.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -340,13 +337,7 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -393,7 +384,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.delete.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerConnectorDeleteResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -408,13 +399,84 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/connectors/{id}");
+    }
+    /**
+     * Update a connector's mutable settings. `sync_interval_seconds` sets the cadence at which the scheduler starts incremental syncs: the allowed range is provider-aware and returned in the response; values outside it are rejected rather than clamped; 0 resets to the provider default; changing it re-anchors the next sync so a shorter cadence takes effect immediately. `credentials` reconnects the connector in place: send the provider's full credential set (what create accepts); supplied keys replace their stored values, other stored keys survive, the bundle is re-validated against the provider's credential schema, and a pending needs-reauth flag is cleared — the connector keeps its id, resources, and sync cursors.
+     *
+     * @param {HydraDB.HandlerConnectorUpdateReq} request
+     * @param {ConnectorsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.connectors.update({
+     *         id: "HydraDoc1234"
+     *     })
+     */
+    update(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(request, requestOptions));
+    }
+    async __update(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.Default, `connectors/${core.url.encodePathParam(id)}`),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.HandlerConnectorUpdateReq.jsonOrThrow(_body, {
+                unrecognizedObjectKeys: "strip",
+                omitUndefined: true,
+            }),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.HandlerConnectorUpdateResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new HydraDB.BadRequestError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -423,7 +485,7 @@ class ConnectorsClient {
                     });
             }
         }
-        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/connectors/{id}");
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/connectors/{id}");
     }
     /**
      * Save the selected resources for a connector and trigger initial sync/backfill.
@@ -451,9 +513,7 @@ class ConnectorsClient {
      *                 },
      *                 name: "general",
      *                 resourceId: "C0123456789",
-     *                 resourceType: "channel",
-     *                 subTenantId: "sub_tenant_4567",
-     *                 tenantId: "tenant_1234"
+     *                 resourceType: "channel"
      *             }]
      *     })
      */
@@ -485,7 +545,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.configure.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerConfigureResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -508,13 +568,7 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -526,7 +580,7 @@ class ConnectorsClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/connectors/{id}/configure");
     }
     /**
-     * Internal-service endpoint (X-Cortex-Secret) used by the MOVEIT refresh loop to persist a rotated refresh_token for OAuth-bundle connectors. Providers that rotate the refresh token on each exchange invalidate the previously stored one, so the new token must be written back or the next sync fails with invalid_grant. Only refresh_token is merged onto the current stored credential bundle and re-encrypted under the connector's identity context; credentials are never returned.
+     * Internal endpoint. It is not callable with a customer API key and always returns 403 for external callers. Persists a rotated refresh_token for OAuth-bundle connectors: providers that rotate the refresh token on each exchange invalidate the previously stored one, so the new token must be written back or the next sync fails with invalid_grant. Only refresh_token is merged onto the current stored credential bundle and re-encrypted under the connector's identity context; credentials are never returned. It has no automated caller and is disabled by default: until an operator enables it, every call returns 500.
      *
      * @param {HydraDB.PatchConnectorsIdCredentialsRequest} request
      * @param {ConnectorsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -538,17 +592,17 @@ class ConnectorsClient {
      * @throws {@link HydraDB.ServiceUnavailableError}
      *
      * @example
-     *     await client.connectors.rotateAConnectorsStoredOAuthRefreshToken({
+     *     await client.connectors.rotateAConnectorsStoredOAuthRefreshTokenInternalUseOnly({
      *         id: "HydraDoc1234",
      *         body: {
      *             "key": "value"
      *         }
      *     })
      */
-    rotateAConnectorsStoredOAuthRefreshToken(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__rotateAConnectorsStoredOAuthRefreshToken(request, requestOptions));
+    rotateAConnectorsStoredOAuthRefreshTokenInternalUseOnly(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__rotateAConnectorsStoredOAuthRefreshTokenInternalUseOnly(request, requestOptions));
     }
-    async __rotateAConnectorsStoredOAuthRefreshToken(request, requestOptions) {
+    async __rotateAConnectorsStoredOAuthRefreshTokenInternalUseOnly(request, requestOptions) {
         const { id, body: _body } = request;
         const _headers = (0, headers_js_1.mergeHeaders)(this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
         const _response = await core.fetcher({
@@ -560,10 +614,7 @@ class ConnectorsClient {
             contentType: "application/json",
             queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
             requestType: "json",
-            body: serializers.connectors.rotateAConnectorsStoredOAuthRefreshToken.Request.jsonOrThrow(_body, {
-                unrecognizedObjectKeys: "strip",
-                omitUndefined: true,
-            }),
+            body: serializers.connectors.rotateAConnectorsStoredOAuthRefreshTokenInternalUseOnly.Request.jsonOrThrow(_body, { unrecognizedObjectKeys: "strip", omitUndefined: true }),
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -572,7 +623,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.rotateAConnectorsStoredOAuthRefreshToken.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerCredentialsUpdateResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -603,13 +654,7 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 case 503:
                     throw new HydraDB.ServiceUnavailableError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -629,7 +674,7 @@ class ConnectorsClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/connectors/{id}/credentials");
     }
     /**
-     * List a connected provider's resources using the connector's stored credentials.
+     * List a connected provider's resources using the connector's stored credentials. Passing cursor or limit opts into pagination (currently Notion only): the response then adds next_cursor and has_more, a page may hold fewer than limit resources, and clients must continue while has_more is true. Without either param the full resource list is returned.
      *
      * @param {HydraDB.DiscoverConnectorsRequest} request
      * @param {ConnectorsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -648,7 +693,11 @@ class ConnectorsClient {
         return core.HttpResponsePromise.fromPromise(this.__discover(request, requestOptions));
     }
     async __discover(request, requestOptions) {
-        const { id } = request;
+        const { id, cursor, limit } = request;
+        const _queryParams = {
+            cursor,
+            limit,
+        };
         const _authRequest = await this._options.authProvider.getAuthRequest();
         const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
         const _response = await core.fetcher({
@@ -657,7 +706,11 @@ class ConnectorsClient {
                 environments.HydraDBEnvironment.Default, `connectors/${core.url.encodePathParam(id)}/discover`),
             method: "GET",
             headers: _headers,
-            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -666,7 +719,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.discover.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerDiscoverResponseBody.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -689,13 +742,7 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 case 502:
                     throw new HydraDB.BadGatewayError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -750,7 +797,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.listResources.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerConnectorResourcesResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -765,13 +812,7 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -849,13 +890,7 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -904,7 +939,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.deleteResource.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerResourceDeleteResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -927,13 +962,7 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -944,6 +973,68 @@ class ConnectorsClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/connectors/{id}/resources/{resource_id}");
     }
+    /**
+     * Report whether a connector is working, in one call: a rollup status (healthy, degraded, failed, checking) plus per-resource detail. `degraded` means the connector is syncing but at least one configured resource is failing — the state that is otherwise invisible, because a connector whose resources partly fail still reports an idle sync status and no error.
+     *
+     * @param {HydraDB.StatusConnectorsRequest} request
+     * @param {ConnectorsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.connectors.status({
+     *         id: "HydraDoc1234"
+     *     })
+     */
+    status(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__status(request, requestOptions));
+    }
+    async __status(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "API-Version": requestOptions?.apiVersion ?? this._options?.apiVersion ?? "2" }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HydraDBEnvironment.Default, `connectors/${core.url.encodePathParam(id)}/status`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.HandlerConnectorStatusResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/connectors/{id}/status");
+    }
     /**
      * Start a manual sync workflow for a connector.
      *
@@ -982,7 +1073,7 @@ class ConnectorsClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.connectors.sync.Response.parseOrThrow(_response.body, {
+                data: serializers.HandlerConnectorSyncResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -997,21 +1088,9 @@ class ConnectorsClient {
                 case 404:
                     throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 409:
-                    throw new HydraDB.ConflictError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.ConflictError(_response.error.body, _response.rawResponse);
                 case 500:
-                    throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
                 case 503:
                     throw new HydraDB.ServiceUnavailableError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",

package/dist/api/resources/connectors/client/requests/DiscoverConnectorsRequest.d.ts

@@ -7,4 +7,8 @@
 export interface DiscoverConnectorsRequest {
     /** Connector ID */
     id: string;
+    /** Opaque pagination cursor from a previous response's next_cursor */
+    cursor?: string;
+    /** Max resources per page, 1-100 (values above 100 are clamped) */
+    limit?: number;
 }

package/dist/api/resources/connectors/client/requests/HandlerConfigureReq.d.ts

@@ -16,9 +16,7 @@ import type * as HydraDB from "../../../../index.js";
  *                 },
  *                 name: "general",
  *                 resourceId: "C0123456789",
- *                 resourceType: "channel",
- *                 subTenantId: "sub_tenant_4567",
- *                 tenantId: "tenant_1234"
+ *                 resourceType: "channel"
  *             }]
  *     }
  */
@@ -31,4 +29,12 @@ export interface HandlerConfigureReq {
     lookbackDays?: number;
     /** Resources to activate for this connector. Each item corresponds to one entry from the Discover endpoint. */
     resources: HydraDB.HandlerResourceMapping[];
+    /**
+     * TableConfigs carries per-table replication settings for MOVEIT
+     * connectors whose tap reads a `table_configs` credential input (bigquery).
+     * Configure merges them into the stored credential bundle before the first
+     * sync, so the mode chosen at selection time governs every sync from the
+     * start. Optional; rejected for non-MOVEIT engines.
+     */
+    tableConfigs?: HydraDB.HandlerTableConfigEntry[];
 }

package/dist/api/resources/connectors/client/requests/HandlerConnectorCreateReq.d.ts

@@ -20,21 +20,15 @@ export interface HandlerConnectorCreateReq {
      * here would force the generated SDK to demand the deprecated field.
      */
     database?: string;
-    /** Internal deployment context for this connector. */
-    deploymentId?: string;
     /** Human-readable label for this connector. */
     name?: string;
-    /** Subscription plan this connector runs under. */
-    plan?: string;
     /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
     provider: string;
     /** Identifier for the external account (e.g. Slack workspace ID, GitHub org name). Must be distinct across connectors for the same provider. */
     providerAccountScope?: string;
     /** deprecated: use collection */
     subTenantId?: string;
-    /** SyncEngine selects the sync pipeline: "classic" (default) or "moveit". */
-    syncEngine?: string;
-    /** How frequently the scheduler triggers incremental syncs, in seconds. */
+    /** How frequently the scheduler triggers incremental syncs, in seconds. Bounded per provider; send 0 or omit to use the provider default. Change it later with PATCH /connectors/{id}. */
     syncIntervalSeconds?: number;
     /** deprecated: use database */
     tenantId?: string;

package/dist/api/resources/connectors/client/requests/HandlerConnectorUpdateReq.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234"
+ *     }
+ */
+export interface HandlerConnectorUpdateReq {
+    /** Connector ID */
+    id: string;
+    /** Provider-specific credentials (typically `{"api_token": "..."}` or `{"access_token": "..."}`). */
+    credentials?: Record<string, unknown>;
+    /** How frequently the scheduler triggers incremental syncs, in seconds. Bounded per provider; send 0 or omit to use the provider default. Change it later with PATCH /connectors/{id}. */
+    syncIntervalSeconds?: number;
+}

package/dist/api/resources/connectors/client/requests/HandlerDiscoverPreviewReq.d.ts

@@ -8,6 +8,10 @@
  *     }
  */
 export interface HandlerDiscoverPreviewReq {
+    /** Opaque pagination cursor from a previous response's next_cursor */
+    cursor?: string;
+    /** Max resources per page, 1-100 (values above 100 are clamped) */
+    limit?: number;
     /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
     authType?: string;
     /** Provider-specific credentials (typically `{"api_token": "..."}` or `{"access_token": "..."}`). */

package/dist/api/resources/connectors/client/requests/HandlerResourceCreateReq.d.ts

@@ -8,7 +8,7 @@
 export interface HandlerResourceCreateReq {
     /** Connector ID */
     id: string;
-    /** Key-value pairs merged into document metadata on every synced object from this resource. */
+    /** Key-value pairs merged into document metadata on every synced object from this resource. Capped at 1 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes — keys, quotes, commas and braces count toward the budget. The cap is applied when synced objects are ingested, not to this request. */
     additionalMetadata?: Record<string, unknown>;
     collectionOverride?: string;
     databaseOverride?: string;
@@ -16,7 +16,7 @@ export interface HandlerResourceCreateReq {
     displayName?: string;
     /** Provider-specific filters applied during sync (e.g. `{"lookback_days": 30}`). */
     filters?: Record<string, unknown>;
-    /** Key-value pairs merged into tenant metadata on every synced object from this resource. */
+    /** Key-value pairs merged into tenant metadata on every synced object from this resource. Capped at 16 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes — keys, quotes, commas and braces count toward the budget. The cap is applied when synced objects are ingested, not to this request. */
     metadata?: Record<string, unknown>;
     /** Additional provider-supplied metadata for this resource. */
     providerMetadata?: Record<string, unknown>;

package/dist/api/resources/connectors/client/requests/StatusConnectorsRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234"
+ *     }
+ */
+export interface StatusConnectorsRequest {
+    /** Connector ID */
+    id: string;
+}