@hydradb/sdk 2.1.1 → 2.1.3

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

@@ -4,9 +4,11 @@ export type { DiscoverConnectorsRequest } from "./DiscoverConnectorsRequest.js";
 export type { GetConnectorsRequest } from "./GetConnectorsRequest.js";
 export type { HandlerConfigureReq } from "./HandlerConfigureReq.js";
 export type { HandlerConnectorCreateReq } from "./HandlerConnectorCreateReq.js";
+export type { HandlerConnectorUpdateReq } from "./HandlerConnectorUpdateReq.js";
 export type { HandlerDiscoverPreviewReq } from "./HandlerDiscoverPreviewReq.js";
 export type { HandlerResourceCreateReq } from "./HandlerResourceCreateReq.js";
 export type { ListConnectorsRequest } from "./ListConnectorsRequest.js";
 export type { ListResourcesConnectorsRequest } from "./ListResourcesConnectorsRequest.js";
 export type { PatchConnectorsIdCredentialsRequest } from "./PatchConnectorsIdCredentialsRequest.js";
+export type { StatusConnectorsRequest } from "./StatusConnectorsRequest.js";
 export type { SyncConnectorsRequest } from "./SyncConnectorsRequest.js";

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

@@ -13,10 +13,27 @@ export declare class ContextClient {
     /**
      * Delete one or more knowledge sources or memories by ID.
      *
+     * By default this endpoint answers 200 for every outcome, including a delete
+     * that removed nothing — check `data.deleted_count` and `data.results` rather
+     * than the status code.
+     *
+     * Send `X-HydraDB-Delete-Status: strict` to opt in to honest status codes: a
+     * delete that did not happen then answers 404/409/500 and never 200. This is
+     * the recommended mode for new integrations. On those failures the response
+     * `data` still carries the same `results` / `deleted_count` payload a 200
+     * carries, so per-id outcomes stay readable either way.
+     *
+     * The default is expected to become strict in a future release, at which
+     * point `X-HydraDB-Delete-Status: legacy` keeps the unconditional 200 for a
+     * caller that is not ready.
+     *
      * @param {HydraDB.SourcesV2SourceDeleteRequest} request
      * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
      *
      * @example
      *     await client.context.delete()
@@ -31,6 +48,7 @@ export declare class ContextClient {
      *
      * @throws {@link HydraDB.BadRequestError}
      * @throws {@link HydraDB.ContentTooLargeError}
+     * @throws {@link HydraDB.UnsupportedMediaTypeError}
      * @throws {@link HydraDB.UnprocessableEntityError}
      *
      * @example
@@ -39,7 +57,7 @@ export declare class ContextClient {
      *         database: "database"
      *     })
      */
-    ingest(request: HydraDB.IngestContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2SourceUploadResponse>;
+    ingest(request: HydraDB.IngestContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2IngestResponse>;
     private __ingest;
     /**
      * Fetch a previously ingested source's content, inferred content, and a downloadable URL.
@@ -73,7 +91,7 @@ export declare class ContextClient {
      * @example
      *     await client.context.list()
      */
-    list(request?: HydraDB.ListV2ListContentRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeListV2SourceListResponse>;
+    list(request?: HydraDB.ListV2ListContentRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeListV2ListResponse>;
     private __list;
     /**
      * Return knowledge-graph relations for a tenant or a single source.

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

@@ -50,10 +50,27 @@ class ContextClient {
     /**
      * Delete one or more knowledge sources or memories by ID.
      *
+     * By default this endpoint answers 200 for every outcome, including a delete
+     * that removed nothing — check `data.deleted_count` and `data.results` rather
+     * than the status code.
+     *
+     * Send `X-HydraDB-Delete-Status: strict` to opt in to honest status codes: a
+     * delete that did not happen then answers 404/409/500 and never 200. This is
+     * the recommended mode for new integrations. On those failures the response
+     * `data` still carries the same `results` / `deleted_count` payload a 200
+     * carries, so per-id outcomes stay readable either way.
+     *
+     * The default is expected to become strict in a future release, at which
+     * point `X-HydraDB-Delete-Status: legacy` keeps the unconditional 200 for a
+     * caller that is not ready.
+     *
      * @param {HydraDB.SourcesV2SourceDeleteRequest} request
      * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
      *
      * @example
      *     await client.context.delete()
@@ -62,8 +79,12 @@ class ContextClient {
         return core.HttpResponsePromise.fromPromise(this.__delete(request, requestOptions));
     }
     async __delete(request = {}, requestOptions) {
+        const { hydraDbDeleteStatus, ..._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 _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+            "X-HydraDB-Delete-Status": hydraDbDeleteStatus,
+            "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)) ??
@@ -73,7 +94,7 @@ class ContextClient {
             contentType: "application/json",
             queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
             requestType: "json",
-            body: serializers.SourcesV2SourceDeleteRequest.jsonOrThrow(request, {
+            body: serializers.SourcesV2SourceDeleteRequest.jsonOrThrow(_body, {
                 unrecognizedObjectKeys: "strip",
                 omitUndefined: true,
             }),
@@ -105,6 +126,12 @@ class ContextClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new HydraDB.ConflictError(_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,
@@ -123,6 +150,7 @@ class ContextClient {
      *
      * @throws {@link HydraDB.BadRequestError}
      * @throws {@link HydraDB.ContentTooLargeError}
+     * @throws {@link HydraDB.UnsupportedMediaTypeError}
      * @throws {@link HydraDB.UnprocessableEntityError}
      *
      * @example
@@ -194,7 +222,7 @@ class ContextClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.HandlerEnvelopeIngestionV2SourceUploadResponse.parseOrThrow(_response.body, {
+                data: serializers.HandlerEnvelopeIngestionV2IngestResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -222,6 +250,14 @@ class ContextClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 415:
+                    throw new HydraDB.UnsupportedMediaTypeError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
                 case 422:
                     throw new HydraDB.UnprocessableEntityError(serializers.HandlerErrorResponse.parseOrThrow(_response.error.body, {
                         unrecognizedObjectKeys: "passthrough",
@@ -364,7 +400,7 @@ class ContextClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.HandlerEnvelopeListV2SourceListResponse.parseOrThrow(_response.body, {
+                data: serializers.HandlerEnvelopeListV2ListResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -629,13 +665,7 @@ class ContextClient {
                 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,

package/dist/api/resources/context/client/requests/HandlerContextMetadataUpdateRequest.d.ts

@@ -7,7 +7,7 @@
 export interface HandlerContextMetadataUpdateRequest {
     /** Source ID */
     id: string;
-    /** Free-form key-value pairs to merge into the source's `additional_metadata`. */
+    /** Free-form key-value pairs to merge into the source's `additional_metadata`. The only accepted spelling for document metadata on this endpoint. 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. Over-cap returns 400 with the actual byte count. */
     additionalMetadata?: Record<string, unknown>;
     /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
     collection?: string;
@@ -17,14 +17,14 @@ export interface HandlerContextMetadataUpdateRequest {
      * the request body before binding, so the handler reads TenantID/SubTenantID.
      */
     database?: string;
-    /** Schema-backed metadata fields to merge into the source's `metadata` (database metadata). Canonical name; `tenant_metadata` is a deprecated alias. */
+    /** Schema-backed metadata fields to merge into the source's `metadata` (database metadata). Canonical name; `tenant_metadata` is a deprecated alias. 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. Over-cap returns 400 with the actual byte count. */
     databaseMetadata?: Record<string, unknown>;
-    /** Deprecated alias for `additional_metadata`. */
+    /** Not accepted on this endpoint. Sending any non-null value returns 400 (`document_metadata is not accepted; use additional_metadata`), regardless of size. Use `additional_metadata` instead. Accepted as an alias on /context/ingest only. */
     documentMetadata?: Record<string, unknown>;
     /** deprecated: use collection */
     subTenantId?: string;
     /** deprecated: use database */
     tenantId?: string;
-    /** deprecated: use database_metadata */
+    /** Deprecated alias for `database_metadata`, still accepted here; `database_metadata` wins when both are sent. 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. Over-cap returns 400 with the actual byte count. */
     tenantMetadata?: Record<string, unknown>;
 }

package/dist/api/resources/context/client/requests/IngestContextRequest.d.ts

@@ -7,12 +7,15 @@ import type * as HydraDB from "../../../../index.js";
  *     }
  */
 export interface IngestContextRequest {
+    /** App-knowledge items as a JSON array (type=knowledge). Per item, `metadata` is capped at 16 KiB and `additional_metadata` at 1 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes (keys and punctuation count). The deprecated `tenant_metadata` / `document_metadata` spellings are accepted here and held to the same caps. Over-cap returns 400 with the actual byte count. */
     appKnowledge?: string;
     collection?: string;
     database: string;
+    /** Per-document metadata as a JSON array (type=knowledge). Per item, `metadata` is capped at 16 KiB and `additional_metadata` at 1 KiB. Both caps are measured on the compact JSON encoding of the whole map in UTF-8 bytes, so keys, quotes, commas and braces count toward the budget. Over-cap returns 400 with the actual byte count. */
     documentMetadata?: string;
     documents?: core.file.Uploadable | undefined;
     graphPayload?: string;
+    /** Memory items as a JSON array (type=memory). Per item, `metadata` is capped at 16 KiB and `additional_metadata` at 1 KiB, measured on the compact JSON encoding of the whole map in UTF-8 bytes (keys and punctuation count). Over-cap returns 400 with the actual byte count. */
     memories?: string;
     subTenantId?: string;
     tenantId?: string;

package/dist/api/resources/context/client/requests/ListV2ListContentRequest.d.ts

@@ -13,6 +13,14 @@ export interface ListV2ListContentRequest {
      */
     database?: string;
     filters?: HydraDB.ListContentFilter;
+    /**
+     * GroupThreads (type=knowledge only) folds each ticket's/thread root's
+     * discussion (comment and message app sources carrying an app_parent_id)
+     * under the parent row as `comments`, newest first, instead of listing them
+     * as separate top-level rows. Off by default: the flat shape is the
+     * existing contract.
+     */
+    groupThreads?: boolean;
     /** When provided, only items with these IDs are returned. Pagination and filters still apply. */
     ids?: string[];
     /** Field projection — only the listed fields plus id, database, collection are returned. Only applies to type=knowledge. */

package/dist/api/resources/context/client/requests/SourcesV2SourceDeleteRequest.d.ts

@@ -4,6 +4,8 @@ import type * as HydraDB from "../../../../index.js";
  *     {}
  */
 export interface SourcesV2SourceDeleteRequest {
+    /** Selects the status behaviour for this request. `strict` opts in to honest 404/409/500 codes when the delete did not happen; `legacy` forces the unconditional 200. Omitted, the server default applies — currently `legacy`. */
+    hydraDbDeleteStatus?: HydraDB.DeleteContextRequestXHydraDbDeleteStatus;
     /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
     collection?: string;
     /**

package/dist/api/resources/context/types/DeleteContextRequestXHydraDbDeleteStatus.d.ts

@@ -0,0 +1,5 @@
+export declare const DeleteContextRequestXHydraDbDeleteStatus: {
+    readonly Strict: "strict";
+    readonly Legacy: "legacy";
+};
+export type DeleteContextRequestXHydraDbDeleteStatus = (typeof DeleteContextRequestXHydraDbDeleteStatus)[keyof typeof DeleteContextRequestXHydraDbDeleteStatus];

package/dist/api/resources/context/types/DeleteContextRequestXHydraDbDeleteStatus.js

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

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

@@ -1,3 +1,4 @@
+export * from "./DeleteContextRequestXHydraDbDeleteStatus.js";
 export * from "./IngestContextRequestType.js";
 export * from "./ListV2ListContentRequestType.js";
 export * from "./RelationsContextRequestType.js";

package/dist/api/resources/context/types/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./DeleteContextRequestXHydraDbDeleteStatus.js"), exports);
 __exportStar(require("./IngestContextRequestType.js"), exports);
 __exportStar(require("./ListV2ListContentRequestType.js"), exports);
 __exportStar(require("./RelationsContextRequestType.js"), exports);

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

@@ -106,6 +106,23 @@ export declare class DatabasesClient {
      */
     status(request: HydraDB.StatusDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsInfraStatusResponseV2>;
     private __status;
+    /**
+     * Read the database's declared metadata schema fields. Returns the same field shape accepted by database creation and by Update Metadata Schema, so the response round-trips into add_fields.
+     *
+     * @param {HydraDB.GetMetadataSchemaDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.getMetadataSchema({
+     *         database: "acme_corp"
+     *     })
+     */
+    getMetadataSchema(request: HydraDB.GetMetadataSchemaDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantMetadataSchemaResponse>;
+    private __getMetadataSchema;
     /**
      * Add new metadata schema fields to an existing database. Additive only — existing fields cannot be deleted or retyped.
      *

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

@@ -91,13 +91,7 @@ class DatabasesClient {
         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,
@@ -178,21 +172,9 @@ class DatabasesClient {
                         breadcrumbsPrefix: ["response"],
                     }), _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);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -270,13 +252,7 @@ class DatabasesClient {
                 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,
@@ -354,13 +330,7 @@ class DatabasesClient {
                 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,
@@ -438,13 +408,7 @@ class DatabasesClient {
                 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,
@@ -522,13 +486,78 @@ class DatabasesClient {
                 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, "GET", "/databases/status");
+    }
+    /**
+     * Read the database's declared metadata schema fields. Returns the same field shape accepted by database creation and by Update Metadata Schema, so the response round-trips into add_fields.
+     *
+     * @param {HydraDB.GetMetadataSchemaDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.getMetadataSchema({
+     *         database: "acme_corp"
+     *     })
+     */
+    getMetadataSchema(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getMetadataSchema(request, requestOptions));
+    }
+    async __getMetadataSchema(request, requestOptions) {
+        const { database } = 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: "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.HandlerEnvelopeTenantsTenantMetadataSchemaResponse.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,
@@ -537,7 +566,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, "GET", "/databases/{database}/metadata-schema");
     }
     /**
      * Add new metadata schema fields to an existing database. Additive only — existing fields cannot be deleted or retyped.
@@ -606,21 +635,9 @@ class DatabasesClient {
                 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);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,

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

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         database: "acme_corp"
+ *     }
+ */
+export interface GetMetadataSchemaDatabasesRequest {
+    /** Database identifier */
+    database: string;
+}

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

@@ -1,5 +1,6 @@
 export type { CollectionsDatabasesRequest } from "./CollectionsDatabasesRequest.js";
 export type { DeleteDatabasesRequest } from "./DeleteDatabasesRequest.js";
+export type { GetMetadataSchemaDatabasesRequest } from "./GetMetadataSchemaDatabasesRequest.js";
 export type { StatsDatabasesRequest } from "./StatsDatabasesRequest.js";
 export type { StatusDatabasesRequest } from "./StatusDatabasesRequest.js";
 export type { TenantsTenantCreateRequest } from "./TenantsTenantCreateRequest.js";

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

@@ -0,0 +1,32 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as HydraDB from "../../../index.js";
+export declare namespace FeedbackClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class FeedbackClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<FeedbackClient.Options>;
+    constructor(options?: FeedbackClient.Options);
+    /**
+     * Record feedback about a query that already ran, correlated by the `request_id` returned in that query's `response.meta.request_id`. Accepts a free-text comment plus an optional positive/negative/neutral rating, and is intended for both end users and agents (`source`). Feeds internal retrieval-quality validation; it does not change the result of the original query.
+     *
+     * @param {HydraDB.FeedbackSubmitRequest} request
+     * @param {FeedbackClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.feedback.submit({
+     *         feedback: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    submit(request: HydraDB.FeedbackSubmitRequest, requestOptions?: FeedbackClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeFeedbackSubmitResponse>;
+    private __submit;
+}