@hydradb/sdk 2.1.0 → 2.1.1

package/dist/api/resources/databases/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace DatabasesClient {
 }
 export declare class DatabasesClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<DatabasesClient.Options>;
-    constructor(options: DatabasesClient.Options);
+    constructor(options?: DatabasesClient.Options);
     /**
      * List all databases for the authenticated user
      *
@@ -50,7 +50,7 @@ export declare class DatabasesClient {
      *
      * @example
      *     await client.databases.delete({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     delete(request: HydraDB.DeleteDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantDeleteResponse>;
@@ -67,7 +67,7 @@ export declare class DatabasesClient {
      *
      * @example
      *     await client.databases.collections({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     collections(request: HydraDB.CollectionsDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsSubTenantIdsResponse>;
@@ -84,7 +84,7 @@ export declare class DatabasesClient {
      *
      * @example
      *     await client.databases.stats({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     stats(request: HydraDB.StatsDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantStatsResponse>;
@@ -101,9 +101,27 @@ export declare class DatabasesClient {
      *
      * @example
      *     await client.databases.status({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     status(request: HydraDB.StatusDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsInfraStatusResponseV2>;
     private __status;
+    /**
+     * Add new metadata schema fields to an existing database. Additive only — existing fields cannot be deleted or retyped.
+     *
+     * @param {HydraDB.TenantsTenantMetadataSchemaUpdateRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.updateMetadataSchema({
+     *         database: "acme_corp"
+     *     })
+     */
+    updateMetadataSchema(request: HydraDB.TenantsTenantMetadataSchemaUpdateRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerMetadataSchemaUpdateResponse>;
+    private __updateMetadataSchema;
 }

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

@@ -44,7 +44,7 @@ const errors = __importStar(require("../../../../errors/index.js"));
 const serializers = __importStar(require("../../../../serialization/index.js"));
 const HydraDB = __importStar(require("../../../index.js"));
 class DatabasesClient {
-    constructor(options) {
+    constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
@@ -215,7 +215,7 @@ class DatabasesClient {
      *
      * @example
      *     await client.databases.delete({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     delete(request, requestOptions) {
@@ -268,13 +268,7 @@ class DatabasesClient {
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
                     throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -305,7 +299,7 @@ class DatabasesClient {
      *
      * @example
      *     await client.databases.collections({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     collections(request, requestOptions) {
@@ -358,13 +352,7 @@ class DatabasesClient {
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
                     throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -395,7 +383,7 @@ class DatabasesClient {
      *
      * @example
      *     await client.databases.stats({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     stats(request, requestOptions) {
@@ -448,13 +436,7 @@ class DatabasesClient {
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 case 500:
                     throw new HydraDB.InternalServerError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -485,7 +467,7 @@ class DatabasesClient {
      *
      * @example
      *     await client.databases.status({
-     *         database: "database"
+     *         database: "acme_corp"
      *     })
      */
     status(request, requestOptions) {
@@ -538,7 +520,93 @@ class DatabasesClient {
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
+                    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);
+                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", "/databases/status");
+    }
+    /**
+     * Add new metadata schema fields to an existing database. Additive only — existing fields cannot be deleted or retyped.
+     *
+     * @param {HydraDB.TenantsTenantMetadataSchemaUpdateRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.updateMetadataSchema({
+     *         database: "acme_corp"
+     *     })
+     */
+    updateMetadataSchema(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateMetadataSchema(request, requestOptions));
+    }
+    async __updateMetadataSchema(request, requestOptions) {
+        const { database, ..._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, `databases/${core.url.encodePathParam(database)}/metadata-schema`),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.TenantsTenantMetadataSchemaUpdateRequest.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.HandlerMetadataSchemaUpdateResponse.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 409:
+                    throw new HydraDB.ConflictError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -561,7 +629,7 @@ class DatabasesClient {
                     });
             }
         }
-        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/databases/status");
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/databases/{database}/metadata-schema");
     }
 }
 exports.DatabasesClient = DatabasesClient;

package/dist/api/resources/databases/client/requests/CollectionsDatabasesRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         database: "database"
+ *         database: "acme_corp"
  *     }
  */
 export interface CollectionsDatabasesRequest {

package/dist/api/resources/databases/client/requests/DeleteDatabasesRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         database: "database"
+ *         database: "acme_corp"
  *     }
  */
 export interface DeleteDatabasesRequest {

package/dist/api/resources/databases/client/requests/StatsDatabasesRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         database: "database"
+ *         database: "acme_corp"
  *     }
  */
 export interface StatsDatabasesRequest {

package/dist/api/resources/databases/client/requests/StatusDatabasesRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         database: "database"
+ *         database: "acme_corp"
  *     }
  */
 export interface StatusDatabasesRequest {

package/dist/api/resources/databases/client/requests/TenantsTenantCreateRequest.d.ts

@@ -10,9 +10,14 @@ export interface TenantsTenantCreateRequest {
      * this binds, so TenantID is always populated.
      */
     database?: string;
+    /** Defines database-level metadata fields for exact-match filtering and semantic/BM25 search. Canonical name; `tenant_metadata_schema` is a deprecated alias. Schema field names are immutable after database creation. */
+    databaseMetadataSchema?: HydraDB.TenantsCustomPropertyDefinition[];
+    /** Override for the embedding vector dimension. Default: 1536. */
     embeddingsDimension?: number;
+    /** Internal flag for embedding-only databases. */
     isEmbeddingsTenant?: boolean;
     /** deprecated: use database */
     tenantId?: string;
+    /** deprecated: use database_metadata_schema */
     tenantMetadataSchema?: HydraDB.TenantsCustomPropertyDefinition[];
 }

package/dist/api/resources/databases/client/requests/TenantsTenantMetadataSchemaUpdateRequest.d.ts

@@ -0,0 +1,13 @@
+import type * as HydraDB from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         database: "acme_corp"
+ *     }
+ */
+export interface TenantsTenantMetadataSchemaUpdateRequest {
+    /** Database identifier */
+    database: string;
+    /** New metadata schema fields to add to the database. Additive only — no deletes, renames, or type changes. */
+    addFields?: HydraDB.TenantsCustomPropertyDefinition[];
+}

package/dist/api/resources/databases/client/requests/TenantsTenantMetadataSchemaUpdateRequest.js

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

package/dist/api/resources/databases/client/requests/index.d.ts

@@ -3,3 +3,4 @@ export type { DeleteDatabasesRequest } from "./DeleteDatabasesRequest.js";
 export type { StatsDatabasesRequest } from "./StatsDatabasesRequest.js";
 export type { StatusDatabasesRequest } from "./StatusDatabasesRequest.js";
 export type { TenantsTenantCreateRequest } from "./TenantsTenantCreateRequest.js";
+export type { TenantsTenantMetadataSchemaUpdateRequest } from "./TenantsTenantMetadataSchemaUpdateRequest.js";

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

@@ -1,5 +1,8 @@
+export * from "./connectors/client/requests/index.js";
+export * as connectors from "./connectors/index.js";
 export * from "./context/client/requests/index.js";
 export * as context from "./context/index.js";
+export * from "./context/types/index.js";
 export * from "./databases/client/requests/index.js";
 export * as databases from "./databases/index.js";
 export * from "./webhooks/client/requests/index.js";

package/dist/api/resources/index.js

@@ -36,9 +36,12 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webhooks = exports.databases = exports.context = void 0;
+exports.webhooks = exports.databases = exports.context = exports.connectors = void 0;
+__exportStar(require("./connectors/client/requests/index.js"), exports);
+exports.connectors = __importStar(require("./connectors/index.js"));
 __exportStar(require("./context/client/requests/index.js"), exports);
 exports.context = __importStar(require("./context/index.js"));
+__exportStar(require("./context/types/index.js"), exports);
 __exportStar(require("./databases/client/requests/index.js"), exports);
 exports.databases = __importStar(require("./databases/index.js"));
 __exportStar(require("./webhooks/client/requests/index.js"), exports);

package/dist/api/resources/webhooks/client/Client.d.ts

@@ -9,8 +9,10 @@ export declare namespace WebhooksClient {
 }
 export declare class WebhooksClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<WebhooksClient.Options>;
-    constructor(options: WebhooksClient.Options);
+    constructor(options?: WebhooksClient.Options);
     /**
+     * Get the registered indexing webhook configuration for this API key.
+     *
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -32,6 +34,8 @@ export declare class WebhooksClient {
     register(request?: HydraDB.WebhooksWebhookRegisterRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksWebhookRegisterResponse>;
     private __register;
     /**
+     * Unregister the indexing webhook for this API key.
+     *
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.NotFoundError}
@@ -42,6 +46,8 @@ export declare class WebhooksClient {
     delete(requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksWebhookDeleteResponse>;
     private __delete;
     /**
+     * List recent webhook delivery attempts with optional cursor-based pagination.
+     *
      * @param {HydraDB.ListDeliveriesWebhooksRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -51,6 +57,8 @@ export declare class WebhooksClient {
     listDeliveries(request?: HydraDB.ListDeliveriesWebhooksRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksDeliveryListResponse>;
     private __listDeliveries;
     /**
+     * Get a single webhook delivery attempt by ID.
+     *
      * @param {HydraDB.GetDeliveryWebhooksRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -58,12 +66,14 @@ export declare class WebhooksClient {
      *
      * @example
      *     await client.webhooks.getDelivery({
-     *         deliveryId: "delivery_id"
+     *         deliveryId: "dlv_9f8e7d6c"
      *     })
      */
     getDelivery(request: HydraDB.GetDeliveryWebhooksRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksDeliveryItem>;
     private __getDelivery;
     /**
+     * Queue a failed or permanently-failed delivery for retry.
+     *
      * @param {HydraDB.RetryDeliveryWebhooksRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -71,12 +81,14 @@ export declare class WebhooksClient {
      *
      * @example
      *     await client.webhooks.retryDelivery({
-     *         deliveryId: "delivery_id"
+     *         deliveryId: "dlv_9f8e7d6c"
      *     })
      */
     retryDelivery(request: HydraDB.RetryDeliveryWebhooksRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksRetryResponse>;
     private __retryDelivery;
     /**
+     * Send a test webhook event to the registered endpoint to verify connectivity.
+     *
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.NotFoundError}

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

@@ -44,10 +44,12 @@ const errors = __importStar(require("../../../../errors/index.js"));
 const serializers = __importStar(require("../../../../serialization/index.js"));
 const HydraDB = __importStar(require("../../../index.js"));
 class WebhooksClient {
-    constructor(options) {
+    constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * Get the registered indexing webhook configuration for this API key.
+     *
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -162,6 +164,8 @@ class WebhooksClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/webhooks/indexing");
     }
     /**
+     * Unregister the indexing webhook for this API key.
+     *
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.NotFoundError}
@@ -203,13 +207,7 @@ class WebhooksClient {
         if (_response.error.reason === "status-code") {
             switch (_response.error.statusCode) {
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -221,6 +219,8 @@ class WebhooksClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/webhooks/indexing");
     }
     /**
+     * List recent webhook delivery attempts with optional cursor-based pagination.
+     *
      * @param {HydraDB.ListDeliveriesWebhooksRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -278,6 +278,8 @@ class WebhooksClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/webhooks/indexing/deliveries");
     }
     /**
+     * Get a single webhook delivery attempt by ID.
+     *
      * @param {HydraDB.GetDeliveryWebhooksRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -285,7 +287,7 @@ class WebhooksClient {
      *
      * @example
      *     await client.webhooks.getDelivery({
-     *         deliveryId: "delivery_id"
+     *         deliveryId: "dlv_9f8e7d6c"
      *     })
      */
     getDelivery(request, requestOptions) {
@@ -323,13 +325,7 @@ class WebhooksClient {
         if (_response.error.reason === "status-code") {
             switch (_response.error.statusCode) {
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -341,6 +337,8 @@ class WebhooksClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/webhooks/indexing/deliveries/{delivery_id}");
     }
     /**
+     * Queue a failed or permanently-failed delivery for retry.
+     *
      * @param {HydraDB.RetryDeliveryWebhooksRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -348,7 +346,7 @@ class WebhooksClient {
      *
      * @example
      *     await client.webhooks.retryDelivery({
-     *         deliveryId: "delivery_id"
+     *         deliveryId: "dlv_9f8e7d6c"
      *     })
      */
     retryDelivery(request, requestOptions) {
@@ -386,13 +384,7 @@ class WebhooksClient {
         if (_response.error.reason === "status-code") {
             switch (_response.error.statusCode) {
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -404,6 +396,8 @@ class WebhooksClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/webhooks/indexing/deliveries/{delivery_id}/retry");
     }
     /**
+     * Send a test webhook event to the registered endpoint to verify connectivity.
+     *
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.NotFoundError}
@@ -445,13 +439,7 @@ class WebhooksClient {
         if (_response.error.reason === "status-code") {
             switch (_response.error.statusCode) {
                 case 404:
-                    throw new HydraDB.NotFoundError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }), _response.rawResponse);
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,

package/dist/api/resources/webhooks/client/requests/GetDeliveryWebhooksRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         deliveryId: "delivery_id"
+ *         deliveryId: "dlv_9f8e7d6c"
  *     }
  */
 export interface GetDeliveryWebhooksRequest {

package/dist/api/resources/webhooks/client/requests/RetryDeliveryWebhooksRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         deliveryId: "delivery_id"
+ *         deliveryId: "dlv_9f8e7d6c"
  *     }
  */
 export interface RetryDeliveryWebhooksRequest {

package/dist/api/resources/webhooks/client/requests/WebhooksWebhookRegisterRequest.d.ts

@@ -3,7 +3,10 @@
  *     {}
  */
 export interface WebhooksWebhookRegisterRequest {
+    /** Event types to subscribe to (e.g. `["indexing.status_changed"]`). */
     eventTypes?: string[];
+    /** Optional secret used to sign webhook payloads for verification. Minimum 32 characters. */
     signingSecret?: string;
+    /** Endpoint URL to deliver webhook events to. */
     url?: string;
 }

package/dist/api/types/ConnectorsConnector.d.ts

@@ -0,0 +1,58 @@
+export interface ConnectorsConnector {
+    /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
+    authType?: string;
+    /** Default collection partition for synced objects. Canonical name; mirrors the deprecated `sub_tenant_id` alias. */
+    collection?: string;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Internal reference to the stored credential record. */
+    credentialRef?: string;
+    /**
+     * Database/Collection are the canonical v2 names for the deprecated
+     * tenant_id/sub_tenant_id wire fields. They mirror the same values so a v2
+     * client sees the canonical names on responses while a legacy client keeps
+     * reading tenant_id/sub_tenant_id. Not persisted (dynamodbav:"-"): the store
+     * builds items from tenant_id/sub_tenant_id and mirrors these on load. They
+     * are populated at every construction point (toConnector, connectorFromItem)
+     * rather than via MarshalJSON so Temporal's JSON data converter round-trips
+     * Connector activity inputs without spuriously populating them.
+     */
+    database?: string;
+    /** Internal deployment context for this connector. */
+    deploymentId?: string;
+    /** RFC3339 timestamp of the most recent sync attempt (successful or not). */
+    lastAttemptedSyncAt?: string;
+    /** Error message from the most recent failed sync, empty string when no error. */
+    lastError?: string;
+    /** RFC3339 timestamp of the last successful sync completion. */
+    lastSuccessfulSyncAt?: string;
+    /** Human-readable label for this connector. */
+    name?: string;
+    /** RFC3339 timestamp when the next scheduled sync will run. */
+    nextSyncAt?: string;
+    /** Organization that owns this resource. */
+    orgId?: 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;
+    /** Lifecycle status of the connector (e.g. `active`, `paused`, `error`). */
+    status?: string;
+    /** Default collection partition for synced objects. Deprecated — use `collection`. */
+    subTenantId?: string;
+    /**
+     * SyncEngine is "classic" (default, empty treated as classic) or "moveit".
+     * See the SyncEngine* constants; the scheduler branches on it.
+     */
+    syncEngine?: string;
+    /** How frequently the scheduler triggers incremental syncs, in seconds. */
+    syncIntervalSeconds?: number;
+    /** Current sync operation state (e.g. `idle`, `running`). */
+    syncStatus?: string;
+    /** Database that receives synced data. Deprecated — use `database`. */
+    tenantId?: string;
+    /** User that created or owns this resource. */
+    userId?: string;
+}