@hydradb/sdk 2.1.2 → 2.1.3

package/dist/api/resources/feedback/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/index.d.ts

@@ -5,5 +5,6 @@ export * as context from "./context/index.js";
 export * from "./context/types/index.js";
 export * from "./databases/client/requests/index.js";
 export * as databases from "./databases/index.js";
+export * as feedback from "./feedback/index.js";
 export * from "./webhooks/client/requests/index.js";
 export * as webhooks from "./webhooks/index.js";

package/dist/api/resources/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webhooks = exports.databases = exports.context = exports.connectors = void 0;
+exports.webhooks = exports.feedback = exports.databases = exports.context = exports.connectors = void 0;
 __exportStar(require("./connectors/client/requests/index.js"), exports);
 exports.connectors = __importStar(require("./connectors/index.js"));
 __exportStar(require("./context/client/requests/index.js"), exports);
@@ -44,5 +44,6 @@ exports.context = __importStar(require("./context/index.js"));
 __exportStar(require("./context/types/index.js"), exports);
 __exportStar(require("./databases/client/requests/index.js"), exports);
 exports.databases = __importStar(require("./databases/index.js"));
+exports.feedback = __importStar(require("./feedback/index.js"));
 __exportStar(require("./webhooks/client/requests/index.js"), exports);
 exports.webhooks = __importStar(require("./webhooks/index.js"));

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

@@ -21,7 +21,7 @@ export declare class WebhooksClient {
     get(requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksWebhookGetResponse>;
     private __get;
     /**
-     * Register the indexing webhook for this API key's org.
+     * Register the indexing webhook for this API key's org. Set `generate_signing_secret` to register and enable signing in one request; the secret is returned once on the response. Omitting `signing_secret` preserves any secret already configured - to disable signing, call DELETE /webhooks/indexing/signing-secret.
      *
      * @param {HydraDB.WebhooksWebhookRegisterRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -86,6 +86,32 @@ export declare class WebhooksClient {
      */
     retryDelivery(request: HydraDB.RetryDeliveryWebhooksRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksRetryResponse>;
     private __retryDelivery;
+    /**
+     * Generates a signing secret, or stores one you supply. The plaintext is returned exactly once and cannot be retrieved afterwards. Takes effect immediately, so rotate only once your receiver accepts the new secret.
+     *
+     * @param {HydraDB.WebhooksSigningSecretRequest} request
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.webhooks.setSigningSecret()
+     */
+    setSigningSecret(request?: HydraDB.WebhooksSigningSecretRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksSigningSecretResponse>;
+    private __setSigningSecret;
+    /**
+     * Removes the stored signing secret. Deliveries stop carrying the X-HydraDB-Signature header. This is the only way to disable signing - editing a registration never clears the secret.
+     *
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     *
+     * @example
+     *     await client.webhooks.clearSigningSecret()
+     */
+    clearSigningSecret(requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<HydraDB.HandlerEnvelopeWebhooksWebhookRegisterResponse>;
+    private __clearSigningSecret;
     /**
      * Send a test webhook event to the registered endpoint to verify connectivity.
      *

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

@@ -96,7 +96,7 @@ class WebhooksClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/webhooks/indexing");
     }
     /**
-     * Register the indexing webhook for this API key's org.
+     * Register the indexing webhook for this API key's org. Set `generate_signing_secret` to register and enable signing in one request; the secret is returned once on the response. Omitting `signing_secret` preserves any secret already configured - to disable signing, call DELETE /webhooks/indexing/signing-secret.
      *
      * @param {HydraDB.WebhooksWebhookRegisterRequest} request
      * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -395,6 +395,132 @@ class WebhooksClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/webhooks/indexing/deliveries/{delivery_id}/retry");
     }
+    /**
+     * Generates a signing secret, or stores one you supply. The plaintext is returned exactly once and cannot be retrieved afterwards. Takes effect immediately, so rotate only once your receiver accepts the new secret.
+     *
+     * @param {HydraDB.WebhooksSigningSecretRequest} request
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     * @throws {@link HydraDB.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.webhooks.setSigningSecret()
+     */
+    setSigningSecret(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__setSigningSecret(request, requestOptions));
+    }
+    async __setSigningSecret(request = {}, requestOptions) {
+        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, "webhooks/indexing/signing-secret"),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: serializers.WebhooksSigningSecretRequest.jsonOrThrow(request, {
+                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.HandlerEnvelopeWebhooksSigningSecretResponse.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 404:
+                    throw new HydraDB.NotFoundError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new HydraDB.UnprocessableEntityError(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, "POST", "/webhooks/indexing/signing-secret");
+    }
+    /**
+     * Removes the stored signing secret. Deliveries stop carrying the X-HydraDB-Signature header. This is the only way to disable signing - editing a registration never clears the secret.
+     *
+     * @param {WebhooksClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link HydraDB.NotFoundError}
+     *
+     * @example
+     *     await client.webhooks.clearSigningSecret()
+     */
+    clearSigningSecret(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__clearSigningSecret(requestOptions));
+    }
+    async __clearSigningSecret(requestOptions) {
+        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, "webhooks/indexing/signing-secret"),
+            method: "DELETE",
+            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.HandlerEnvelopeWebhooksWebhookRegisterResponse.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 404:
+                    throw new HydraDB.NotFoundError(_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", "/webhooks/indexing/signing-secret");
+    }
     /**
      * Send a test webhook event to the registered endpoint to verify connectivity.
      *

package/dist/api/resources/webhooks/client/requests/WebhooksSigningSecretRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @example
+ *     {}
+ */
+export interface WebhooksSigningSecretRequest {
+    /** Secret used to sign webhook payloads. Deliveries carry `X-HydraDB-Signature: sha256=<hex>`, the HMAC-SHA256 of the raw request body keyed by this secret. Minimum 16 characters when you supply your own; omit it and one is generated for you. On registration, omitting this field preserves any existing secret - to disable signing, call DELETE /webhooks/indexing/signing-secret. */
+    signingSecret?: string;
+}

package/dist/api/resources/webhooks/client/requests/WebhooksWebhookRegisterRequest.d.ts

@@ -5,7 +5,9 @@
 export interface WebhooksWebhookRegisterRequest {
     /** Event types to subscribe to (e.g. `["indexing.status_changed"]`). */
     eventTypes?: string[];
-    /** Optional secret used to sign webhook payloads for verification. Minimum 32 characters. */
+    /** Generate a signing secret as part of this request, so registering and enabling signing are one atomic operation. The secret is returned once on the response and cannot be retrieved later. Mutually exclusive with `signing_secret`. */
+    generateSigningSecret?: boolean;
+    /** Secret used to sign webhook payloads. Deliveries carry `X-HydraDB-Signature: sha256=<hex>`, the HMAC-SHA256 of the raw request body keyed by this secret. Minimum 16 characters when you supply your own; omit it and one is generated for you. On registration, omitting this field preserves any existing secret - to disable signing, call DELETE /webhooks/indexing/signing-secret. */
     signingSecret?: string;
     /** Endpoint URL to deliver webhook events to. */
     url?: string;

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

@@ -1,4 +1,5 @@
 export type { GetDeliveryWebhooksRequest } from "./GetDeliveryWebhooksRequest.js";
 export type { ListDeliveriesWebhooksRequest } from "./ListDeliveriesWebhooksRequest.js";
 export type { RetryDeliveryWebhooksRequest } from "./RetryDeliveryWebhooksRequest.js";
+export type { WebhooksSigningSecretRequest } from "./WebhooksSigningSecretRequest.js";
 export type { WebhooksWebhookRegisterRequest } from "./WebhooksWebhookRegisterRequest.js";

package/dist/api/types/FeedbackGroundTruth.d.ts

@@ -0,0 +1,12 @@
+export interface FeedbackGroundTruth {
+    /**
+     * Answer is the response the caller expected — the text a correct system
+     * would have produced from the retrieved context.
+     */
+    answer?: string;
+    /**
+     * SourceIDs are the ingested source IDs that actually contain the answer,
+     * as returned in query results and accepted by /context endpoints.
+     */
+    sourceIds?: string[];
+}

package/dist/api/types/FeedbackRating.d.ts

@@ -0,0 +1,6 @@
+export declare const FeedbackRating: {
+    readonly Positive: "positive";
+    readonly Negative: "negative";
+    readonly Neutral: "neutral";
+};
+export type FeedbackRating = (typeof FeedbackRating)[keyof typeof FeedbackRating];

package/dist/api/types/FeedbackRating.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.FeedbackRating = void 0;
+exports.FeedbackRating = {
+    Positive: "positive",
+    Negative: "negative",
+    Neutral: "neutral",
+};

package/dist/api/types/FeedbackSource.d.ts

@@ -0,0 +1,5 @@
+export declare const FeedbackSource: {
+    readonly User: "user";
+    readonly Agent: "agent";
+};
+export type FeedbackSource = (typeof FeedbackSource)[keyof typeof FeedbackSource];

package/dist/api/types/FeedbackSource.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.FeedbackSource = void 0;
+exports.FeedbackSource = {
+    User: "user",
+    Agent: "agent",
+};

package/dist/api/types/FeedbackSubmitRequest.d.ts

@@ -0,0 +1,2 @@
+import type * as HydraDB from "../index.js";
+export type FeedbackSubmitRequest = HydraDB.FeedbackSubmitRequestFeedback | HydraDB.FeedbackSubmitRequestGroundTruth;

package/dist/api/types/FeedbackSubmitRequestFeedback.d.ts

@@ -0,0 +1,3 @@
+export interface FeedbackSubmitRequestFeedback {
+    feedback?: unknown;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruth.d.ts

@@ -0,0 +1,4 @@
+import type * as HydraDB from "../index.js";
+export interface FeedbackSubmitRequestGroundTruth {
+    groundTruth: HydraDB.FeedbackSubmitRequestGroundTruthGroundTruth;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruth.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/types/FeedbackSubmitRequestGroundTruthGroundTruth.d.ts

@@ -0,0 +1,2 @@
+import type * as HydraDB from "../index.js";
+export type FeedbackSubmitRequestGroundTruthGroundTruth = HydraDB.FeedbackSubmitRequestGroundTruthGroundTruthAnswer | HydraDB.FeedbackSubmitRequestGroundTruthGroundTruthSourceIds;

package/dist/api/types/FeedbackSubmitRequestGroundTruthGroundTruth.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/types/FeedbackSubmitRequestGroundTruthGroundTruthAnswer.d.ts

@@ -0,0 +1,3 @@
+export interface FeedbackSubmitRequestGroundTruthGroundTruthAnswer {
+    answer?: unknown;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruthGroundTruthAnswer.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/types/FeedbackSubmitRequestGroundTruthGroundTruthSourceIds.d.ts

@@ -0,0 +1,3 @@
+export interface FeedbackSubmitRequestGroundTruthGroundTruthSourceIds {
+    sourceIds?: unknown;
+}

package/dist/api/types/FeedbackSubmitRequestGroundTruthGroundTruthSourceIds.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/types/FeedbackSubmitResponse.d.ts

@@ -0,0 +1,12 @@
+export interface FeedbackSubmitResponse {
+    /** RFC3339 timestamp when the feedback was recorded. */
+    createdAt?: string;
+    /** Unique identifier assigned to this feedback submission. */
+    feedbackId?: string;
+    /** Human-readable result message. */
+    message?: string;
+    /** Whether the feedback was durably stored. */
+    recorded?: boolean;
+    /** The query request ID this feedback was recorded against. */
+    requestId?: string;
+}

package/dist/api/types/FeedbackSubmitResponse.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/types/FetchV2SourceFetchResponse.d.ts

@@ -17,6 +17,12 @@ export interface FetchV2SourceFetchResponse {
     presignedUrl?: string;
     /** File size in bytes. */
     sizeBytes?: number;
-    /** Whether the request succeeded. */
+    /**
+     * Deprecated for API clients: to decide whether the request succeeded,
+     * check the HTTP status code — 2xx is success — or equivalently the
+     * envelope's top-level `success`. This nested copy always carries the same
+     * value as that flag and never carries independent information. Still
+     * emitted unchanged for existing clients (PRO-1208).
+     */
     success?: boolean;
 }

package/dist/api/types/GithubComHydradbHydradbApplicationInternalServiceMetadataEditResult.d.ts

@@ -5,6 +5,10 @@ export interface GithubComHydradbHydradbApplicationInternalServiceMetadataEditRe
     chunkRowsMatched?: number;
     /** Number of MongoDB chunk rows modified by the source update. */
     chunkRowsModified?: number;
+    /** Collection that contained the source. Canonical name; mirrors the deprecated `sub_tenant_id` alias. */
+    collection?: string;
+    /** Owning database. Canonical name; mirrors the deprecated `tenant_id` alias. */
+    database?: string;
     /** Database metadata keys included in the update request. Canonical name; `tenant_metadata_keys` is a deprecated alias. */
     databaseMetadataKeys?: string[];
     /** Unique identifier for this resource. */
@@ -18,9 +22,9 @@ export interface GithubComHydradbHydradbApplicationInternalServiceMetadataEditRe
     milvusSyncRequired?: boolean;
     /** deprecated: use vector_synced */
     milvusSynced?: boolean;
-    /** Collection that contained the source. */
+    /** deprecated: use collection */
     subTenantId?: string;
-    /** Owning database. */
+    /** deprecated: use database */
     tenantId?: string;
     /** deprecated: use database_metadata_keys */
     tenantMetadataKeys?: string[];

package/dist/api/types/GraphGraphRelationsResponse.d.ts

@@ -8,6 +8,12 @@ export interface GraphGraphRelationsResponse {
     nextCursor?: number;
     /** Array of triplet groups with evidence for each relationship. */
     relations?: HydraDB.GraphTripletWithEvidence[];
-    /** Whether the request succeeded. */
+    /**
+     * Deprecated for API clients: to decide whether the request succeeded,
+     * check the HTTP status code — 2xx is success — or equivalently the
+     * envelope's top-level `success`. This nested copy always carries the same
+     * value and never carries independent information. Still emitted unchanged
+     * for existing clients (PRO-1208).
+     */
     success?: boolean;
 }

package/dist/api/types/HandlerCatalogConnector.d.ts

@@ -0,0 +1,11 @@
+export interface HandlerCatalogConnector {
+    category?: string;
+    isAlpha?: boolean;
+    isBeta?: boolean;
+    moveitSupport?: boolean;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+    /** Rank is the dashboard display order (lower first); null means unranked. */
+    rank?: number;
+    supported?: boolean;
+}

package/dist/api/types/HandlerCatalogConnector.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/types/HandlerConfigureResponse.d.ts

@@ -0,0 +1,24 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerConfigureResponse {
+    backfill?: boolean;
+    configured?: number;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /**
+     * FirstSyncAt/Message state the timing expectation: whether the first
+     * sync is already running (configure triggers one) or when the scheduled
+     * one runs, so clients stop inventing their own copy (PRO-1565).
+     */
+    firstSyncAt?: string;
+    /** Human-readable result message. */
+    message?: string;
+    meta?: HydraDB.HandlerConfigureResponseMeta;
+    /**
+     * Warnings names resources that were saved but produced nothing when
+     * probed. They are valid — the user may know a table is empty and expect it
+     * to fill — so they are not rejected, but they are the case that is
+     * otherwise indistinguishable from success at every layer, so they are
+     * never saved silently either.
+     */
+    warnings?: string[];
+}

package/dist/api/types/HandlerConfigureResponse.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/types/HandlerConfigureResponseMeta.d.ts

@@ -0,0 +1,4 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerConfigureResponseMeta {
+    deprecation?: HydraDB.HandlerDeprecationNotice[];
+}

package/dist/api/types/HandlerConfigureResponseMeta.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/types/HandlerConnectorApiView.d.ts

@@ -0,0 +1,124 @@
+export interface HandlerConnectorApiView {
+    /**
+     * ActiveResourceCount mirrors the number of non-disabled resource rows so
+     * list responses can distinguish "no resources configured yet"
+     * (pending_setup) without a per-connector resources query.
+     */
+    activeResourceCount?: number;
+    /** Authentication method for the provider connection (e.g. `api_token`, `oauth`). */
+    authType?: string;
+    /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
+    collection?: string;
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /**
+     * Database/Collection are the canonical v2 names for the deprecated
+     * tenant_id/sub_tenant_id wire fields. They mirror the same values so a v2
+     * client sees the canonical names on responses while a legacy client keeps
+     * reading tenant_id/sub_tenant_id. Not persisted (dynamodbav:"-"): the store
+     * builds items from tenant_id/sub_tenant_id and mirrors these on load. They
+     * are populated at every construction point (toConnector, connectorFromItem)
+     * rather than via MarshalJSON so Temporal's JSON data converter round-trips
+     * Connector activity inputs without spuriously populating them.
+     */
+    database?: string;
+    /**
+     * DocumentsDispatched is the running total of objects handed to ingestion
+     * across all completed cycles. It is dispatch *activity*, not an indexed
+     * count: upserts count every time they change, deletes are never
+     * subtracted, and an activity retry can double-count. Suitable as an
+     * is-data-moving signal, never as "N documents indexed".
+     */
+    documentsDispatched?: number;
+    /**
+     * FirstDataDispatchedAt is set once, by the first completed cycle that
+     * dispatched more than zero objects. Its presence is what proves the
+     * pipeline end to end; after it is set, an empty cycle is "nothing changed
+     * at the source", not "still ingesting".
+     */
+    firstDataDispatchedAt?: string;
+    /** RFC3339 timestamp of the most recent sync attempt (successful or not). */
+    lastAttemptedSyncAt?: string;
+    /** Error message from the most recent failed sync, empty string when no error. */
+    lastError?: string;
+    /** RFC3339 timestamp of the last successful sync completion. */
+    lastSuccessfulSyncAt?: string;
+    /**
+     * Lifecycle is the derived what-is-it-doing-now field and the one status
+     * clients should read (PRO-1565): reconnect | syncing | pending_setup |
+     * ingesting | active. The embedded `status` field is a scheduler-internal
+     * constant ("active" always) kept only for compatibility, and `sync_status`
+     * is the narrower mid-cycle indicator. Computed at the HTTP boundary from
+     * the connector's stored facts, never persisted, so it cannot disagree
+     * with them.
+     */
+    lifecycle?: string;
+    /** Human-readable label for this resource. */
+    name?: string;
+    needsReauth?: boolean;
+    needsReauthAt?: string;
+    needsReauthReason?: string;
+    /** RFC3339 timestamp when the next scheduled sync will run. */
+    nextSyncAt?: 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;
+    /**
+     * ResourcesPendingFirstSync counts active resources whose provider_cursor
+     * is still empty — resources that have never been successfully pulled.
+     * MOVEIT commits provider_cursor after every successful pull (even a
+     * zero-row one), so this self-clears one cycle after each resource first
+     * syncs. Recomputed by the MOVEIT sync workflow each cycle and by the
+     * resource-mutating handlers, so a resource added to a long-active
+     * connector re-enters the ingesting state.
+     */
+    resourcesPendingFirstSync?: number;
+    /** Current lifecycle or processing state. */
+    status?: string;
+    subTenantId?: string;
+    /**
+     * NeedsReauth is set by MOVEIT's OAuth refresh sweep when the provider has
+     * rejected the connector's refresh token (`invalid_grant` — expired, revoked,
+     * or, for a provider with single-use tokens, already spent).
+     *
+     * It is deliberately distinct from LastError, which records a *sync* failure.
+     * This is the one failure class no amount of retrying resolves: the stored
+     * grant is gone and only the tenant can mint a new one. Surfacing it as its
+     * own field is what lets a client show "reconnect" instead of a generic
+     * "sync failed", and the sweep clears it automatically on the next successful
+     * rotation, so a client can trust the absence of the flag as much as its
+     * presence.
+     *
+     * Only ever set on OAuth-bundle connectors. A connector authenticated with a
+     * static token or with client credentials (X posts: see the `client_id` /
+     * `client_secret` inputs on tap-twitter) has no refresh token and therefore
+     * cannot reach this state at all — which is the reason to prefer that shape
+     * where a provider offers it.
+     * SyncBlocked marks a connector stopped by a terminal failure — one no
+     * retry can fix. The scheduler skips it and next_sync_at is parked a
+     * century out; only a credential or config update clears it. Distinct from
+     * NeedsReauth, which is the OAuth sweep's own narrower signal: this covers
+     * any provider rejection of the stored credentials, including static keys
+     * that have no refresh token to sweep.
+     */
+    syncBlocked?: boolean;
+    syncBlockedAt?: string;
+    syncBlockedReason?: string;
+    /**
+     * SyncCyclesCompleted counts successfully completed sync cycles. Bounded
+     * use only: it lets DeriveLifecycle stop reporting "ingesting" after a few
+     * clean-but-empty cycles on a source that genuinely has nothing to pull.
+     */
+    syncCyclesCompleted?: number;
+    /**
+     * SyncEngine is "classic" (default, empty treated as classic) or "moveit".
+     * See the SyncEngine* constants; the scheduler branches on it.
+     */
+    syncEngine?: string;
+    /** How frequently the scheduler triggers incremental syncs, in seconds. Bounded per provider; send 0 or omit to use the provider default. Change it later with PATCH /connectors/{id}. */
+    syncIntervalSeconds?: number;
+    /** Current sync operation state (e.g. `idle`, `running`). */
+    syncStatus?: string;
+    tenantId?: string;
+}

package/dist/api/types/HandlerConnectorApiView.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/types/HandlerConnectorCatalogResponse.d.ts

@@ -0,0 +1,4 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerConnectorCatalogResponse {
+    connectors?: HydraDB.HandlerCatalogConnector[];
+}

package/dist/api/types/HandlerConnectorCatalogResponse.js

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