@hydradb/sdk 2.0.1 → 2.1.1

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

@@ -1,18 +1,21 @@
 import type * as core from "../../../../../core/index.js";
+import type * as HydraDB from "../../../../index.js";
 /**
  * @example
  *     {
- *         tenantId: "tenant_id"
+ *         database: "database"
  *     }
  */
 export interface IngestContextRequest {
     appKnowledge?: string;
+    collection?: string;
+    database: string;
     documentMetadata?: string;
     documents?: core.file.Uploadable | undefined;
     graphPayload?: string;
     memories?: string;
     subTenantId?: string;
-    tenantId: string;
-    type?: string;
+    tenantId?: string;
+    type?: HydraDB.IngestContextRequestType;
     upsert?: string;
 }

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

@@ -1,17 +1,24 @@
 /**
  * @example
  *     {
- *         id: "id",
+ *         id: "HydraDoc1234",
+ *         database: "acme_corp",
+ *         collection: "team_docs",
  *         tenantId: "tenant_1234",
- *         subTenantId: "sub_tenant_4567"
+ *         subTenantId: "sub_tenant_4567",
+ *         mode: "thinking"
  *     }
  */
 export interface InspectContextRequest {
     /** Source ID */
     id: string;
-    /** Tenant ID */
-    tenantId: string;
-    /** Sub-tenant ID */
+    /** Database (canonical name for the tenant scope) */
+    database: string;
+    /** Collection (canonical name for the sub-tenant scope) */
+    collection?: string;
+    /** Deprecated alias for database */
+    tenantId?: string;
+    /** Deprecated alias for collection */
     subTenantId?: string;
     /** Presigned URL expiry in seconds */
     expirySeconds?: number;

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

@@ -4,12 +4,27 @@ import type * as HydraDB from "../../../../index.js";
  *     {}
  */
 export interface ListV2ListContentRequest {
+    /** 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 (reconciled here in UnmarshalJSON and centrally by
+     * the TenantAliases middleware).
+     */
+    database?: string;
     filters?: HydraDB.ListContentFilter;
+    /** 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. */
     includeFields?: string[];
+    /** Current page number (1-indexed). */
     page?: number;
+    /** Number of items per page. */
     pageSize?: number;
+    /** deprecated: use collection */
     subTenantId?: string;
+    /** deprecated: use database */
     tenantId?: string;
-    type?: string;
+    /** Bucket to list: `knowledge` (default) or `memory`. */
+    type?: HydraDB.ListV2ListContentRequestType;
 }

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

@@ -1,19 +1,27 @@
+import type * as HydraDB from "../../../../index.js";
 /**
  * @example
  *     {
+ *         database: "acme_corp",
+ *         collection: "team_docs",
  *         tenantId: "tenant_1234",
- *         subTenantId: "sub_tenant_4567"
+ *         subTenantId: "sub_tenant_4567",
+ *         id: "HydraDoc1234"
  *     }
  */
 export interface RelationsContextRequest {
-    /** Tenant ID */
-    tenantId: string;
-    /** Sub-tenant ID */
+    /** Database (canonical name for the tenant scope) */
+    database: string;
+    /** Collection (canonical name for the sub-tenant scope) */
+    collection?: string;
+    /** Deprecated alias for database */
+    tenantId?: string;
+    /** Deprecated alias for collection */
     subTenantId?: string;
-    /** Source ID (omit for tenant-wide relations) */
+    /** Source ID (omit for database-wide relations) */
     id?: string;
     /** Corpus type: 'knowledge' or 'memory' */
-    type?: string;
+    type?: HydraDB.RelationsContextRequestType;
     /** Max relations to return */
     limit?: number;
     /** Pagination cursor */

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

@@ -1,10 +1,23 @@
+import type * as HydraDB from "../../../../index.js";
 /**
  * @example
  *     {}
  */
 export interface SourcesV2SourceDeleteRequest {
+    /** 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, reconciled by the TenantAliases middleware before
+     * binding so TenantID is always populated.
+     */
+    database?: string;
+    /** IDs of the sources or memories to delete. */
     ids?: string[];
+    /** deprecated: use collection */
     subTenantId?: string;
+    /** deprecated: use database */
     tenantId?: string;
-    type?: string;
+    /** Bucket to delete from: `knowledge` (default) or `memory`. */
+    type?: HydraDB.SourcesV2SourceDeleteRequestType;
 }

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

@@ -1,6 +1,9 @@
 /**
  * @example
  *     {
+ *         id: "HydraDoc1234",
+ *         database: "acme_corp",
+ *         collection: "team_docs",
  *         tenantId: "tenant_1234",
  *         subTenantId: "sub_tenant_4567"
  *     }
@@ -10,8 +13,12 @@ export interface StatusContextRequest {
     id?: string;
     /** One or more source IDs */
     ids?: string | string[];
-    /** Tenant ID */
-    tenantId: string;
-    /** Sub-tenant ID */
+    /** Database (canonical name for the tenant scope) */
+    database: string;
+    /** Collection (canonical name for the sub-tenant scope) */
+    collection?: string;
+    /** Deprecated alias for database */
+    tenantId?: string;
+    /** Deprecated alias for collection */
     subTenantId?: string;
 }

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

@@ -1,3 +1,4 @@
+export type { HandlerContextMetadataUpdateRequest } from "./HandlerContextMetadataUpdateRequest.js";
 export type { IngestContextRequest } from "./IngestContextRequest.js";
 export type { InspectContextRequest } from "./InspectContextRequest.js";
 export type { ListV2ListContentRequest } from "./ListV2ListContentRequest.js";

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

@@ -1 +1,2 @@
 export * from "./client/index.js";
+export * from "./types/index.js";

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

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

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

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

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

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

@@ -0,0 +1,6 @@
+/** Bucket to list: `knowledge` (default) or `memory`. */
+export declare const ListV2ListContentRequestType: {
+    readonly Knowledge: "knowledge";
+    readonly Memory: "memory";
+};
+export type ListV2ListContentRequestType = (typeof ListV2ListContentRequestType)[keyof typeof ListV2ListContentRequestType];

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

@@ -0,0 +1,9 @@
+"use strict";
+// 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`. */
+exports.ListV2ListContentRequestType = {
+    Knowledge: "knowledge",
+    Memory: "memory",
+};

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

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

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

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

@@ -0,0 +1,6 @@
+/** Bucket to delete from: `knowledge` (default) or `memory`. */
+export declare const SourcesV2SourceDeleteRequestType: {
+    readonly Knowledge: "knowledge";
+    readonly Memory: "memory";
+};
+export type SourcesV2SourceDeleteRequestType = (typeof SourcesV2SourceDeleteRequestType)[keyof typeof SourcesV2SourceDeleteRequestType];

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

@@ -0,0 +1,9 @@
+"use strict";
+// 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`. */
+exports.SourcesV2SourceDeleteRequestType = {
+    Knowledge: "knowledge",
+    Memory: "memory",
+};

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

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

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

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./IngestContextRequestType.js"), exports);
+__exportStar(require("./ListV2ListContentRequestType.js"), exports);
+__exportStar(require("./RelationsContextRequestType.js"), exports);
+__exportStar(require("./SourcesV2SourceDeleteRequestType.js"), exports);

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

@@ -0,0 +1,127 @@
+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 DatabasesClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class DatabasesClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<DatabasesClient.Options>;
+    constructor(options?: DatabasesClient.Options);
+    /**
+     * List all databases for the authenticated user
+     *
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.list()
+     */
+    list(requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantIdsResponse>;
+    private __list;
+    /**
+     * Create a new database with optional custom metadata schema
+     *
+     * @param {HydraDB.TenantsTenantCreateRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.ForbiddenError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.create()
+     */
+    create(request?: HydraDB.TenantsTenantCreateRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantCreateAcceptedResponse>;
+    private __create;
+    /**
+     * Delete a database and all associated data
+     *
+     * @param {HydraDB.DeleteDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.delete({
+     *         database: "acme_corp"
+     *     })
+     */
+    delete(request: HydraDB.DeleteDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantDeleteResponse>;
+    private __delete;
+    /**
+     * List all collections for a given database
+     *
+     * @param {HydraDB.CollectionsDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.collections({
+     *         database: "acme_corp"
+     *     })
+     */
+    collections(request: HydraDB.CollectionsDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsSubTenantIdsResponse>;
+    private __collections;
+    /**
+     * Get collection statistics for a database
+     *
+     * @param {HydraDB.StatsDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.stats({
+     *         database: "acme_corp"
+     *     })
+     */
+    stats(request: HydraDB.StatsDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsTenantStatsResponse>;
+    private __stats;
+    /**
+     * Check the infrastructure provisioning status for a database
+     *
+     * @param {HydraDB.StatusDatabasesRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.status({
+     *         database: "acme_corp"
+     *     })
+     */
+    status(request: HydraDB.StatusDatabasesRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeTenantsInfraStatusResponseV2>;
+    private __status;
+    /**
+     * Add new metadata schema fields to an existing database. Additive only — existing fields cannot be deleted or retyped.
+     *
+     * @param {HydraDB.TenantsTenantMetadataSchemaUpdateRequest} request
+     * @param {DatabasesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.BadRequestError}
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.ConflictError}
+     * @throws {@link HydraDB.InternalServerError}
+     *
+     * @example
+     *     await client.databases.updateMetadataSchema({
+     *         database: "acme_corp"
+     *     })
+     */
+    updateMetadataSchema(request: HydraDB.TenantsTenantMetadataSchemaUpdateRequest, requestOptions?: DatabasesClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerMetadataSchemaUpdateResponse>;
+    private __updateMetadataSchema;
+}