@hydradb/sdk 2.0.1 → 2.1.1

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234",
+ *         resourceId: "C0123456789"
+ *     }
+ */
+export interface DeleteResourceConnectorsRequest {
+    /** Connector ID */
+    id: string;
+    /** Resource ID */
+    resourceId: string;
+}

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

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

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

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

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

@@ -0,0 +1,34 @@
+import type * as HydraDB from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234",
+ *         resources: [{
+ *                 additionalMetadata: {
+ *                     "author": "ada",
+ *                     "doc_version": 3
+ *                 },
+ *                 collection: "team_docs",
+ *                 database: "acme_corp",
+ *                 metadata: {
+ *                     "department": "finance",
+ *                     "priority": 7
+ *                 },
+ *                 name: "general",
+ *                 resourceId: "C0123456789",
+ *                 resourceType: "channel",
+ *                 subTenantId: "sub_tenant_4567",
+ *                 tenantId: "tenant_1234"
+ *             }]
+ *     }
+ */
+export interface HandlerConfigureReq {
+    /** Connector ID */
+    id: string;
+    /** Internal interval for async backfill paging. */
+    backfillChunkIntervalSeconds?: number;
+    /** How far back the first sync fetches historical data. Only applies to the initial sync — subsequent syncs are incremental from the last cursor. */
+    lookbackDays?: number;
+    /** Resources to activate for this connector. Each item corresponds to one entry from the Discover endpoint. */
+    resources: HydraDB.HandlerResourceMapping[];
+}

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

@@ -0,0 +1,41 @@
+/**
+ * @example
+ *     {
+ *         provider: "slack"
+ *     }
+ */
+export interface HandlerConnectorCreateReq {
+    /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
+    authType?: string;
+    /** Default collection partition for synced objects. Deprecated alias: `sub_tenant_id`. */
+    collection?: string;
+    /** Provider-specific credentials (typically `{"api_token": "..."}` or `{"access_token": "..."}`). */
+    credentials?: Record<string, unknown>;
+    /**
+     * Database/Collection are the canonical v2 names; TenantID/SubTenantID are
+     * their deprecated aliases, reconciled by the TenantAliases middleware before
+     * binding so TenantID is always populated. Neither is marked binding:required
+     * (mirroring TenantCreateRequest): a caller may send either spelling, and the
+     * tenant scope is validated downstream by resolveTenant. Requiring tenant_id
+     * 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. */
+    syncIntervalSeconds?: number;
+    /** deprecated: use database */
+    tenantId?: string;
+}

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

@@ -0,0 +1,17 @@
+/**
+ * @example
+ *     {
+ *         credentials: {
+ *             "api_token": "xoxb-..."
+ *         },
+ *         provider: "slack"
+ *     }
+ */
+export interface HandlerDiscoverPreviewReq {
+    /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
+    authType?: string;
+    /** Provider-specific credentials (typically `{"api_token": "..."}` or `{"access_token": "..."}`). */
+    credentials: Record<string, unknown>;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider: string;
+}

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

@@ -0,0 +1,34 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234",
+ *         resourceId: "C0123456789"
+ *     }
+ */
+export interface HandlerResourceCreateReq {
+    /** Connector ID */
+    id: string;
+    /** Key-value pairs merged into document metadata on every synced object from this resource. */
+    additionalMetadata?: Record<string, unknown>;
+    collectionOverride?: string;
+    databaseOverride?: string;
+    /** Human-readable name for this resource. */
+    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. */
+    metadata?: Record<string, unknown>;
+    /** Additional provider-supplied metadata for this resource. */
+    providerMetadata?: Record<string, unknown>;
+    /** Resource identifier from the Discover endpoint. */
+    resourceId: string;
+    /** Type of resource within the provider (e.g. `channel`, `repo`, `linear_team`). */
+    resourceType?: string;
+    /** deprecated: use collection_override */
+    subTenantIdOverride?: string;
+    /**
+     * DatabaseOverride/CollectionOverride are the canonical v2 names;
+     * TenantIDOverride/SubTenantIDOverride are their deprecated aliases.
+     */
+    tenantIdOverride?: string;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         provider: "slack"
+ *     }
+ */
+export interface ListConnectorsRequest {
+    /** Filter by provider */
+    provider?: string;
+}

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234",
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface PatchConnectorsIdCredentialsRequest {
+    /** Connector ID */
+    id: string;
+    body: Record<string, unknown>;
+}

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

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

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

@@ -0,0 +1,12 @@
+export type { DeleteConnectorsRequest } from "./DeleteConnectorsRequest.js";
+export type { DeleteResourceConnectorsRequest } from "./DeleteResourceConnectorsRequest.js";
+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 { 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 { SyncConnectorsRequest } from "./SyncConnectorsRequest.js";

package/dist/api/resources/connectors/exports.d.ts

@@ -0,0 +1,2 @@
+export { ConnectorsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/api/resources/{embeddings → connectors}/exports.js

@@ -15,7 +15,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 });
-exports.EmbeddingsClient = void 0;
+exports.ConnectorsClient = void 0;
 var Client_js_1 = require("./client/Client.js");
-Object.defineProperty(exports, "EmbeddingsClient", { enumerable: true, get: function () { return Client_js_1.EmbeddingsClient; } });
+Object.defineProperty(exports, "ConnectorsClient", { enumerable: true, get: function () { return Client_js_1.ConnectorsClient; } });
 __exportStar(require("./client/index.js"), exports);

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

@@ -9,7 +9,7 @@ export declare namespace ContextClient {
 }
 export declare class ContextClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ContextClient.Options>;
-    constructor(options: ContextClient.Options);
+    constructor(options?: ContextClient.Options);
     /**
      * Delete one or more knowledge sources or memories by ID.
      *
@@ -21,7 +21,7 @@ export declare class ContextClient {
      * @example
      *     await client.context.delete()
      */
-    delete(request?: HydraDB.SourcesV2SourceDeleteRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeSourcesSourceDeleteResponse>;
+    delete(request?: HydraDB.SourcesV2SourceDeleteRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeSourcesMemoryDeleteResponse>;
     private __delete;
     /**
      * Ingest knowledge documents or memories for a tenant.
@@ -30,12 +30,13 @@ export declare class ContextClient {
      * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.ContentTooLargeError}
      * @throws {@link HydraDB.UnprocessableEntityError}
      *
      * @example
      *     import { createReadStream } from "fs";
      *     await client.context.ingest({
-     *         tenantId: "tenant_id"
+     *         database: "database"
      *     })
      */
     ingest(request: HydraDB.IngestContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2SourceUploadResponse>;
@@ -51,9 +52,12 @@ export declare class ContextClient {
      *
      * @example
      *     await client.context.inspect({
-     *         id: "id",
+     *         id: "HydraDoc1234",
+     *         database: "acme_corp",
+     *         collection: "team_docs",
      *         tenantId: "tenant_1234",
-     *         subTenantId: "sub_tenant_4567"
+     *         subTenantId: "sub_tenant_4567",
+     *         mode: "thinking"
      *     })
      */
     inspect(request: HydraDB.InspectContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeFetchV2SourceFetchResponse>;
@@ -81,8 +85,11 @@ export declare class ContextClient {
      *
      * @example
      *     await client.context.relations({
+     *         database: "acme_corp",
+     *         collection: "team_docs",
      *         tenantId: "tenant_1234",
-     *         subTenantId: "sub_tenant_4567"
+     *         subTenantId: "sub_tenant_4567",
+     *         id: "HydraDoc1234"
      *     })
      */
     relations(request: HydraDB.RelationsContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeGraphGraphRelationsResponse>;
@@ -97,10 +104,30 @@ export declare class ContextClient {
      *
      * @example
      *     await client.context.status({
+     *         id: "HydraDoc1234",
+     *         database: "acme_corp",
+     *         collection: "team_docs",
      *         tenantId: "tenant_1234",
      *         subTenantId: "sub_tenant_4567"
      *     })
      */
     status(request: HydraDB.StatusContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2BatchProcessingStatus>;
     private __status;
+    /**
+     * Merge/upsert database_metadata and additional_metadata for one source. collection is required.
+     *
+     * @param {HydraDB.HandlerContextMetadataUpdateRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.context.updateSourceMetadata({
+     *         id: "HydraDoc1234"
+     *     })
+     */
+    updateSourceMetadata(request: HydraDB.HandlerContextMetadataUpdateRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeGithubComHydradbHydradbApplicationInternalServiceMetadataEditResult>;
+    private __updateSourceMetadata;
 }

package/dist/api/resources/context/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 ContextClient {
-    constructor(options) {
+    constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
@@ -85,7 +85,7 @@ class ContextClient {
         });
         if (_response.ok) {
             return {
-                data: serializers.HandlerEnvelopeSourcesSourceDeleteResponse.parseOrThrow(_response.body, {
+                data: serializers.HandlerEnvelopeSourcesMemoryDeleteResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -122,12 +122,13 @@ class ContextClient {
      * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.ContentTooLargeError}
      * @throws {@link HydraDB.UnprocessableEntityError}
      *
      * @example
      *     import { createReadStream } from "fs";
      *     await client.context.ingest({
-     *         tenantId: "tenant_id"
+     *         database: "database"
      *     })
      */
     ingest(request, requestOptions) {
@@ -138,6 +139,10 @@ class ContextClient {
         if (request.appKnowledge != null) {
             _body.append("app_knowledge", request.appKnowledge);
         }
+        if (request.collection != null) {
+            _body.append("collection", request.collection);
+        }
+        _body.append("database", request.database);
         if (request.documentMetadata != null) {
             _body.append("document_metadata", request.documentMetadata);
         }
@@ -153,9 +158,14 @@ class ContextClient {
         if (request.subTenantId != null) {
             _body.append("sub_tenant_id", request.subTenantId);
         }
-        _body.append("tenant_id", request.tenantId);
+        if (request.tenantId != null) {
+            _body.append("tenant_id", request.tenantId);
+        }
         if (request.type != null) {
-            _body.append("type", request.type);
+            _body.append("type", serializers.IngestContextRequestType.jsonOrThrow(request.type, {
+                unrecognizedObjectKeys: "strip",
+                omitUndefined: true,
+            }));
         }
         if (request.upsert != null) {
             _body.append("upsert", request.upsert);
@@ -204,6 +214,14 @@ class ContextClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 413:
+                    throw new HydraDB.ContentTooLargeError(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",
@@ -233,18 +251,23 @@ class ContextClient {
      *
      * @example
      *     await client.context.inspect({
-     *         id: "id",
+     *         id: "HydraDoc1234",
+     *         database: "acme_corp",
+     *         collection: "team_docs",
      *         tenantId: "tenant_1234",
-     *         subTenantId: "sub_tenant_4567"
+     *         subTenantId: "sub_tenant_4567",
+     *         mode: "thinking"
      *     })
      */
     inspect(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__inspect(request, requestOptions));
     }
     async __inspect(request, requestOptions) {
-        const { id, tenantId, subTenantId, expirySeconds, mode } = request;
+        const { id, database, collection, tenantId, subTenantId, expirySeconds, mode } = request;
         const _queryParams = {
             id,
+            database,
+            collection,
             tenant_id: tenantId,
             sub_tenant_id: subTenantId,
             expiry_seconds: expirySeconds,
@@ -292,13 +315,7 @@ class ContextClient {
                         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);
                 default:
                     throw new errors.HydraDBError({
                         statusCode: _response.error.statusCode,
@@ -387,20 +404,30 @@ class ContextClient {
      *
      * @example
      *     await client.context.relations({
+     *         database: "acme_corp",
+     *         collection: "team_docs",
      *         tenantId: "tenant_1234",
-     *         subTenantId: "sub_tenant_4567"
+     *         subTenantId: "sub_tenant_4567",
+     *         id: "HydraDoc1234"
      *     })
      */
     relations(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__relations(request, requestOptions));
     }
     async __relations(request, requestOptions) {
-        const { tenantId, subTenantId, id, type: type_, limit, cursor } = request;
+        const { database, collection, tenantId, subTenantId, id, type: type_, limit, cursor } = request;
         const _queryParams = {
+            database,
+            collection,
             tenant_id: tenantId,
             sub_tenant_id: subTenantId,
             id,
-            type: type_,
+            type: type_ != null
+                ? serializers.RelationsContextRequestType.jsonOrThrow(type_, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                })
+                : undefined,
             limit,
             cursor,
         };
@@ -465,6 +492,9 @@ class ContextClient {
      *
      * @example
      *     await client.context.status({
+     *         id: "HydraDoc1234",
+     *         database: "acme_corp",
+     *         collection: "team_docs",
      *         tenantId: "tenant_1234",
      *         subTenantId: "sub_tenant_4567"
      *     })
@@ -473,10 +503,12 @@ class ContextClient {
         return core.HttpResponsePromise.fromPromise(this.__status(request, requestOptions));
     }
     async __status(request, requestOptions) {
-        const { id, ids, tenantId, subTenantId } = request;
+        const { id, ids, database, collection, tenantId, subTenantId } = request;
         const _queryParams = {
             id,
             ids,
+            database,
+            collection,
             tenant_id: tenantId,
             sub_tenant_id: subTenantId,
         };
@@ -531,5 +563,88 @@ class ContextClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/context/status");
     }
+    /**
+     * Merge/upsert database_metadata and additional_metadata for one source. collection is required.
+     *
+     * @param {HydraDB.HandlerContextMetadataUpdateRequest} request
+     * @param {ContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.context.updateSourceMetadata({
+     *         id: "HydraDoc1234"
+     *     })
+     */
+    updateSourceMetadata(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateSourceMetadata(request, requestOptions));
+    }
+    async __updateSourceMetadata(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, `context/${core.url.encodePathParam(id)}/metadata`),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.HandlerContextMetadataUpdateRequest.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.HandlerEnvelopeGithubComHydradbHydradbApplicationInternalServiceMetadataEditResult.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(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, "PATCH", "/context/{id}/metadata");
+    }
 }
 exports.ContextClient = ContextClient;

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

@@ -0,0 +1,30 @@
+/**
+ * @example
+ *     {
+ *         id: "HydraDoc1234"
+ *     }
+ */
+export interface HandlerContextMetadataUpdateRequest {
+    /** Source ID */
+    id: string;
+    /** Free-form key-value pairs to merge into the source's `additional_metadata`. */
+    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;
+    /**
+     * Database/Collection are the canonical v2 names; TenantID/SubTenantID are
+     * their deprecated aliases. The TenantAliases middleware reconciles them in
+     * 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. */
+    databaseMetadata?: Record<string, unknown>;
+    /** Deprecated alias for `additional_metadata`. */
+    documentMetadata?: Record<string, unknown>;
+    /** deprecated: use collection */
+    subTenantId?: string;
+    /** deprecated: use database */
+    tenantId?: string;
+    /** deprecated: use database_metadata */
+    tenantMetadata?: Record<string, unknown>;
+}