@hydradb/sdk 2.1.0 → 2.1.1

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

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/api/resources/connectors/client/index.js

@@ -0,0 +1,17 @@
+"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("./requests/index.js"), exports);

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/DeleteConnectorsRequest.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/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/DeleteResourceConnectorsRequest.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/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/DiscoverConnectorsRequest.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/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/GetConnectorsRequest.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/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/HandlerConfigureReq.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/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/HandlerConnectorCreateReq.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/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/HandlerDiscoverPreviewReq.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/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/HandlerResourceCreateReq.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/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/ListConnectorsRequest.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/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/ListResourcesConnectorsRequest.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/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/PatchConnectorsIdCredentialsRequest.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/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/SyncConnectorsRequest.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/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/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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/connectors/exports.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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 });
+exports.ConnectorsClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "ConnectorsClient", { enumerable: true, get: function () { return Client_js_1.ConnectorsClient; } });
+__exportStar(require("./client/index.js"), exports);

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

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

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

@@ -0,0 +1,17 @@
+"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("./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.
      *
@@ -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,43 +85,49 @@ 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>;
     private __relations;
     /**
-     * Merge/upsert tenant_metadata and additional_metadata for one source. sub_tenant_id is required.
+     * Return the processing status for one or more source IDs.
      *
-     * @param {HydraDB.HandlerContextMetadataUpdateRequest} request
+     * @param {HydraDB.StatusContextRequest} 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({
-     *         sourceId: "HydraDoc1234"
+     *     await client.context.status({
+     *         id: "HydraDoc1234",
+     *         database: "acme_corp",
+     *         collection: "team_docs",
+     *         tenantId: "tenant_1234",
+     *         subTenantId: "sub_tenant_4567"
      *     })
      */
-    updateSourceMetadata(request: HydraDB.HandlerContextMetadataUpdateRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeGithubComHydradbHydradbApplicationInternalServiceMetadataEditResult>;
-    private __updateSourceMetadata;
+    status(request: HydraDB.StatusContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2BatchProcessingStatus>;
+    private __status;
     /**
-     * Return the processing status for one or more source IDs.
+     * Merge/upsert database_metadata and additional_metadata for one source. collection is required.
      *
-     * @param {HydraDB.StatusContextRequest} request
+     * @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.status({
-     *         tenantId: "tenant_1234",
-     *         subTenantId: "sub_tenant_4567"
+     *     await client.context.updateSourceMetadata({
+     *         id: "HydraDoc1234"
      *     })
      */
-    status(request: HydraDB.StatusContextRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeIngestionV2BatchProcessingStatus>;
-    private __status;
+    updateSourceMetadata(request: HydraDB.HandlerContextMetadataUpdateRequest, requestOptions?: ContextClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeGithubComHydradbHydradbApplicationInternalServiceMetadataEditResult>;
+    private __updateSourceMetadata;
 }