@hydradb/sdk 2.1.3 → 2.1.5

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

@@ -1,7 +1,10 @@
+export type { ChunksContextRequest } from "./ChunksContextRequest.js";
 export type { HandlerContextMetadataUpdateRequest } from "./HandlerContextMetadataUpdateRequest.js";
 export type { IngestContextRequest } from "./IngestContextRequest.js";
 export type { InspectContextRequest } from "./InspectContextRequest.js";
 export type { ListV2ListContentRequest } from "./ListV2ListContentRequest.js";
+export type { ProfileContextRequest } from "./ProfileContextRequest.js";
 export type { RelationsContextRequest } from "./RelationsContextRequest.js";
 export type { SourcesV2SourceDeleteRequest } from "./SourcesV2SourceDeleteRequest.js";
 export type { StatusContextRequest } from "./StatusContextRequest.js";
+export type { SubgraphContextRequest } from "./SubgraphContextRequest.js";

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

@@ -0,0 +1,7 @@
+export declare const ChunksContextRequestType: {
+    readonly Knowledge: "knowledge";
+    readonly Memory: "memory";
+    readonly Unified: "unified";
+    readonly All: "all";
+};
+export type ChunksContextRequestType = (typeof ChunksContextRequestType)[keyof typeof ChunksContextRequestType];

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

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChunksContextRequestType = void 0;
+exports.ChunksContextRequestType = {
+    Knowledge: "knowledge",
+    Memory: "memory",
+    Unified: "unified",
+    All: "all",
+};

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

@@ -1,5 +1,6 @@
 export declare const IngestContextRequestType: {
     readonly Knowledge: "knowledge";
     readonly Memory: "memory";
+    readonly Unified: "unified";
 };
 export type IngestContextRequestType = (typeof IngestContextRequestType)[keyof typeof IngestContextRequestType];

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

@@ -5,4 +5,5 @@ exports.IngestContextRequestType = void 0;
 exports.IngestContextRequestType = {
     Knowledge: "knowledge",
     Memory: "memory",
+    Unified: "unified",
 };

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

@@ -1,6 +1,12 @@
-/** Bucket to list: `knowledge` (default) or `memory`. */
+/**
+ * Type names the corpus. Split database: knowledge (default) or memory.
+ * Unified database: unified (default), every item in one page;
+ * knowledge/memory are rejected there.
+ */
 export declare const ListV2ListContentRequestType: {
     readonly Knowledge: "knowledge";
     readonly Memory: "memory";
+    readonly Unified: "unified";
+    readonly All: "all";
 };
 export type ListV2ListContentRequestType = (typeof ListV2ListContentRequestType)[keyof typeof ListV2ListContentRequestType];

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

@@ -2,8 +2,14 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListV2ListContentRequestType = void 0;
-/** Bucket to list: `knowledge` (default) or `memory`. */
+/**
+ * Type names the corpus. Split database: knowledge (default) or memory.
+ * Unified database: unified (default), every item in one page;
+ * knowledge/memory are rejected there.
+ */
 exports.ListV2ListContentRequestType = {
     Knowledge: "knowledge",
     Memory: "memory",
+    Unified: "unified",
+    All: "all",
 };

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

@@ -0,0 +1,5 @@
+export declare const ProfileContextRequestType: {
+    readonly Knowledge: "knowledge";
+    readonly Memory: "memory";
+};
+export type ProfileContextRequestType = (typeof ProfileContextRequestType)[keyof typeof ProfileContextRequestType];

package/dist/api/resources/context/types/ProfileContextRequestType.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.ProfileContextRequestType = void 0;
+exports.ProfileContextRequestType = {
+    Knowledge: "knowledge",
+    Memory: "memory",
+};

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

@@ -1,5 +1,7 @@
 export declare const RelationsContextRequestType: {
     readonly Knowledge: "knowledge";
     readonly Memory: "memory";
+    readonly Unified: "unified";
+    readonly All: "all";
 };
 export type RelationsContextRequestType = (typeof RelationsContextRequestType)[keyof typeof RelationsContextRequestType];

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

@@ -5,4 +5,6 @@ exports.RelationsContextRequestType = void 0;
 exports.RelationsContextRequestType = {
     Knowledge: "knowledge",
     Memory: "memory",
+    Unified: "unified",
+    All: "all",
 };

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

@@ -1,6 +1,11 @@
-/** Bucket to delete from: `knowledge` (default) or `memory`. */
+/**
+ * Type names the corpus. Split database: knowledge (default) or memory.
+ * Unified database: unified (default); knowledge/memory are rejected there.
+ */
 export declare const SourcesV2SourceDeleteRequestType: {
     readonly Knowledge: "knowledge";
     readonly Memory: "memory";
+    readonly Unified: "unified";
+    readonly All: "all";
 };
 export type SourcesV2SourceDeleteRequestType = (typeof SourcesV2SourceDeleteRequestType)[keyof typeof SourcesV2SourceDeleteRequestType];

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

@@ -2,8 +2,13 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SourcesV2SourceDeleteRequestType = void 0;
-/** Bucket to delete from: `knowledge` (default) or `memory`. */
+/**
+ * Type names the corpus. Split database: knowledge (default) or memory.
+ * Unified database: unified (default); knowledge/memory are rejected there.
+ */
 exports.SourcesV2SourceDeleteRequestType = {
     Knowledge: "knowledge",
     Memory: "memory",
+    Unified: "unified",
+    All: "all",
 };

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

@@ -0,0 +1,7 @@
+export declare const SubgraphContextRequestType: {
+    readonly Knowledge: "knowledge";
+    readonly Memory: "memory";
+    readonly Unified: "unified";
+    readonly All: "all";
+};
+export type SubgraphContextRequestType = (typeof SubgraphContextRequestType)[keyof typeof SubgraphContextRequestType];

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

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubgraphContextRequestType = void 0;
+exports.SubgraphContextRequestType = {
+    Knowledge: "knowledge",
+    Memory: "memory",
+    Unified: "unified",
+    All: "all",
+};

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

@@ -1,5 +1,8 @@
+export * from "./ChunksContextRequestType.js";
 export * from "./DeleteContextRequestXHydraDbDeleteStatus.js";
 export * from "./IngestContextRequestType.js";
 export * from "./ListV2ListContentRequestType.js";
+export * from "./ProfileContextRequestType.js";
 export * from "./RelationsContextRequestType.js";
 export * from "./SourcesV2SourceDeleteRequestType.js";
+export * from "./SubgraphContextRequestType.js";

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

@@ -14,8 +14,11 @@ 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("./ChunksContextRequestType.js"), exports);
 __exportStar(require("./DeleteContextRequestXHydraDbDeleteStatus.js"), exports);
 __exportStar(require("./IngestContextRequestType.js"), exports);
 __exportStar(require("./ListV2ListContentRequestType.js"), exports);
+__exportStar(require("./ProfileContextRequestType.js"), exports);
 __exportStar(require("./RelationsContextRequestType.js"), exports);
 __exportStar(require("./SourcesV2SourceDeleteRequestType.js"), exports);
+__exportStar(require("./SubgraphContextRequestType.js"), exports);

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

@@ -72,6 +72,24 @@ export declare class DatabasesClient {
      */
     collections(request: HydraDB.CollectionsDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsSubTenantIdsResponse>;
     private __collections;
+    /**
+     * Permanently remove one collection and all of its data from a database. The database itself is left intact.
+     *
+     * @param {HydraDB.DeleteCollectionDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.deleteCollection({
+     *         database: "acme_corp",
+     *         collection: "team_docs"
+     *     })
+     */
+    deleteCollection(request: HydraDB.DeleteCollectionDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsSubTenantDeleteResponse>;
+    private __deleteCollection;
     /**
      * Get collection statistics for a database
      *
@@ -106,6 +124,59 @@ export declare class DatabasesClient {
      */
     status(request: HydraDB.StatusDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsInfraStatusResponseV2>;
     private __status;
+    /**
+     * Rename a database in place. The internal identity (and therefore all indexed data, graphs and documents) is unchanged — only the caller-facing name moves, atomically. Connectors syncing into the database are repointed at the new name. The old name stops resolving immediately, so callers must switch to the new name in the same rollout.
+     *
+     * @param {HydraDB.TenantsTenantRenameRequest} 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.rename({
+     *         database: "acme_corp",
+     *         newName: "new_name"
+     *     })
+     */
+    rename(request: HydraDB.TenantsTenantRenameRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantRenameResponse>;
+    private __rename;
+    /**
+     * Read the custom ingestion instructions configured for a database and for its collections.
+     *
+     * @param {HydraDB.GetInstructionsDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.getInstructions({
+     *         database: "acme_corp"
+     *     })
+     */
+    getInstructions(request: HydraDB.GetInstructionsDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerInstructionsResponse>;
+    private __getInstructions;
+    /**
+     * Set or clear the custom ingestion instructions for a database and its collections. Database instructions apply to every document; a collection's instructions apply on top of them. Both stack with any connector- or resource-level instructions rather than replacing them. Applies from the next ingestion; already-indexed data is not reprocessed.
+     *
+     * @param {HydraDB.HandlerInstructionsUpdateReq} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.updateInstructions({
+     *         database: "acme_corp"
+     *     })
+     */
+    updateInstructions(request: HydraDB.HandlerInstructionsUpdateReq, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerInstructionsResponse>;
+    private __updateInstructions;
     /**
      * 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.
      *

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

@@ -341,6 +341,86 @@ class DatabasesClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/databases/collections");
     }
+    /**
+     * Permanently remove one collection and all of its data from a database. The database itself is left intact.
+     *
+     * @param {HydraDB.DeleteCollectionDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.deleteCollection({
+     *         database: "acme_corp",
+     *         collection: "team_docs"
+     *     })
+     */
+    deleteCollection(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteCollection(request, requestOptions));
+    }
+    async __deleteCollection(request, requestOptions) {
+        const { database, collection } = request;
+        const _queryParams = {
+            database,
+            collection,
+        };
+        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/collections"),
+            method: "DELETE",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.HandlerEnvelopeTenantsSubTenantDeleteResponse.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,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/databases/collections");
+    }
     /**
      * Get collection statistics for a database
      *
@@ -497,6 +577,235 @@ class DatabasesClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/databases/status");
     }
+    /**
+     * Rename a database in place. The internal identity (and therefore all indexed data, graphs and documents) is unchanged — only the caller-facing name moves, atomically. Connectors syncing into the database are repointed at the new name. The old name stops resolving immediately, so callers must switch to the new name in the same rollout.
+     *
+     * @param {HydraDB.TenantsTenantRenameRequest} 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.rename({
+     *         database: "acme_corp",
+     *         newName: "new_name"
+     *     })
+     */
+    rename(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__rename(request, requestOptions));
+    }
+    async __rename(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)}`),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.TenantsTenantRenameRequest.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.HandlerEnvelopeTenantsTenantRenameResponse.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(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new HydraDB.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.HydraDBError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/databases/{database}");
+    }
+    /**
+     * Read the custom ingestion instructions configured for a database and for its collections.
+     *
+     * @param {HydraDB.GetInstructionsDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.getInstructions({
+     *         database: "acme_corp"
+     *     })
+     */
+    getInstructions(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getInstructions(request, requestOptions));
+    }
+    async __getInstructions(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)}/instructions`),
+            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.HandlerInstructionsResponse.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,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/databases/{database}/instructions");
+    }
+    /**
+     * Set or clear the custom ingestion instructions for a database and its collections. Database instructions apply to every document; a collection's instructions apply on top of them. Both stack with any connector- or resource-level instructions rather than replacing them. Applies from the next ingestion; already-indexed data is not reprocessed.
+     *
+     * @param {HydraDB.HandlerInstructionsUpdateReq} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.updateInstructions({
+     *         database: "acme_corp"
+     *     })
+     */
+    updateInstructions(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateInstructions(request, requestOptions));
+    }
+    async __updateInstructions(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)}/instructions`),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.HandlerInstructionsUpdateReq.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.HandlerInstructionsResponse.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,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/databases/{database}/instructions");
+    }
     /**
      * 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.
      *

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

@@ -0,0 +1,13 @@
+/**
+ * @example
+ *     {
+ *         database: "acme_corp",
+ *         collection: "team_docs"
+ *     }
+ */
+export interface DeleteCollectionDatabasesRequest {
+    /** Database identifier */
+    database: string;
+    /** Collection identifier */
+    collection: string;
+}

package/dist/api/resources/databases/client/requests/DeleteCollectionDatabasesRequest.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/GetInstructionsDatabasesRequest.d.ts

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

package/dist/api/resources/databases/client/requests/GetInstructionsDatabasesRequest.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/HandlerInstructionsUpdateReq.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @example
+ *     {
+ *         database: "acme_corp"
+ *     }
+ */
+export interface HandlerInstructionsUpdateReq {
+    /** Database identifier */
+    database: string;
+    /**
+     * Collections merges per-collection instructions into the stored set: a
+     * collection present with a value is set, a collection present with "" or
+     * null is cleared, and a collection absent from the map is left untouched.
+     * Merge rather than replace so two people editing different collections
+     * cannot silently delete each other's work.
+     */
+    collections?: Record<string, string | null>;
+    /** CustomInstructions sets the database-wide instructions. Send "" to clear. */
+    customInstructions?: string | null;
+}