@hydradb/sdk 2.1.2 → 2.1.3

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

@@ -0,0 +1,128 @@
+export interface HandlerConnectorCreateResponse {
+    /**
+     * 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;
+    /** FirstSyncAt is when the first scheduled sync runs (RFC3339). */
+    firstSyncAt?: 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;
+    /** Message is a human-readable expectation, safe to show verbatim. */
+    message?: 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/HandlerConnectorCreateResponse.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/HandlerConnectorDeleteResponse.d.ts

@@ -0,0 +1,6 @@
+export interface HandlerConnectorDeleteResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Whether this specific item was deleted. */
+    deleted?: boolean;
+}

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

@@ -0,0 +1,11 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerConnectorListResponse {
+    connectors?: HydraDB.HandlerConnectorApiView[];
+    /**
+     * Health maps connector_id to its rollup (healthy | degraded | failed |
+     * checking), present only when the caller asks for `?include=health`.
+     * A connector missing from the map has an unknown rollup — its resources
+     * could not be read — which clients must not render as a failure.
+     */
+    health?: Record<string, string>;
+}

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

@@ -0,0 +1,21 @@
+export interface HandlerConnectorResourceStatus {
+    checkedAt?: string;
+    /** Human-readable name for this resource. */
+    displayName?: string;
+    /** HTTPStatus is the provider's response code when one was reported. */
+    httpStatus?: number;
+    /** LastRowCount is the rows produced by the last sync. */
+    lastRowCount?: number;
+    /** Message is the provider's own words when Status is failed. */
+    message?: string;
+    /** Resource identifier from the Discover endpoint. */
+    resourceId?: string;
+    /**
+     * Retryable is set only for a failed resource: false for a provider
+     * rejection the user must fix (403, 404, a misconfigured table), true for
+     * something that may clear on its own.
+     */
+    retryable?: boolean;
+    /** Status is one of ok | empty | failed | checking | unknown. */
+    status?: string;
+}

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Error is the connector-level failure, set when Status is failed. Absent
+ * when the trouble is confined to individual resources — those carry their
+ * own messages below.
+ */
+export interface HandlerConnectorStatusError {
+    /** Action is what the user must do, when there is something they can do. */
+    action?: string;
+    /** DetectedAt is when the failure was observed (RFC3339). */
+    detectedAt?: string;
+    /** Human-readable result message. */
+    message?: string;
+    /**
+     * Retryable reports whether waiting can fix this. False means only the user
+     * can: a rejected credential is not a transient error, and telling someone
+     * to retry a dead OAuth grant wastes their time.
+     */
+    retryable?: boolean;
+}

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

@@ -0,0 +1,37 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerConnectorStatusResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Error message, empty string on success. */
+    error?: HydraDB.HandlerConnectorStatusError;
+    /** RFC3339 timestamp of the most recent sync attempt (successful or not). */
+    lastAttemptedSyncAt?: string;
+    /** RFC3339 timestamp of the last successful sync completion. */
+    lastSuccessfulSyncAt?: string;
+    /**
+     * Lifecycle is the derived what-is-it-doing-now field (PRO-1565):
+     * reconnect | syncing | pending_setup | ingesting | active. Orthogonal to
+     * the health rollup above — a connector can be ingesting and healthy, or
+     * active and degraded.
+     */
+    lifecycle?: 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;
+    /**
+     * Resources is one entry per configured resource, always non-nil so it
+     * serialises as [] rather than null.
+     */
+    resources?: HydraDB.HandlerConnectorResourceStatus[];
+    /**
+     * Status is the rollup: healthy | degraded | failed | checking. It is the
+     * worst of the credential state and every resource state.
+     */
+    status?: string;
+    /**
+     * SyncStatus is the in-progress indicator ("syncing"/"idle"), orthogonal to
+     * Status — a connector can be mid-sync and degraded at the same time.
+     */
+    syncStatus?: string;
+}

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

@@ -0,0 +1,4 @@
+export interface HandlerConnectorSyncResponse {
+    runId?: string;
+    workflowId?: string;
+}

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

@@ -0,0 +1,17 @@
+export interface HandlerConnectorUpdateResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /**
+     * CredentialsUpdated reports that the stored credential bundle was
+     * re-written (and any needs-reauth flag cleared) by this request.
+     */
+    credentialsUpdated?: boolean;
+    /** Largest sync_interval_seconds this connector's provider allows. */
+    maxSyncIntervalSeconds?: number;
+    /** Smallest sync_interval_seconds this connector's provider allows. Values below it are rejected, never clamped. */
+    minSyncIntervalSeconds?: number;
+    /** RFC3339 timestamp when the next scheduled sync will run. */
+    nextSyncAt?: 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;
+}

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

@@ -0,0 +1,6 @@
+export interface HandlerCredentialsUpdateResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Whether the source metadata was updated. */
+    updated?: boolean;
+}

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

@@ -0,0 +1,9 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerDiscoverResponseBody {
+    hasMore?: boolean;
+    /** Opaque pagination cursor for the next page; null or absent when no more pages. */
+    nextCursor?: string;
+    /** External provider being synced (e.g. `slack`, `github`, `linear`, `notion`, `gmail`). */
+    provider?: string;
+    resources?: HydraDB.HandlerDiscoveredResourceDto[];
+}

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

@@ -0,0 +1,9 @@
+export interface HandlerDiscoveredResourceDto {
+    /** Unique identifier for this resource. */
+    id?: string;
+    metadata?: Record<string, unknown>;
+    /** Human-readable label for this resource. */
+    name?: string;
+    /** Type of resource within the provider (e.g. `channel`, `repo`, `linear_team`). */
+    resourceType?: string;
+}

package/dist/api/types/HandlerDiscoveredResourceDto.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/{HandlerEnvelopeListV2SourceListResponse.d.ts → HandlerEnvelopeFeedbackSubmitResponse.d.ts}

@@ -1,6 +1,6 @@
 import type * as HydraDB from "../index.js";
-export interface HandlerEnvelopeListV2SourceListResponse {
-    data?: HydraDB.ListV2SourceListResponse;
+export interface HandlerEnvelopeFeedbackSubmitResponse {
+    data?: HydraDB.FeedbackSubmitResponse;
     /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;

package/dist/api/types/HandlerEnvelopeFeedbackSubmitResponse.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/{HandlerEnvelopeIngestionV2SourceUploadResponse.d.ts → HandlerEnvelopeIngestionV2IngestResponse.d.ts}

@@ -1,6 +1,6 @@
 import type * as HydraDB from "../index.js";
-export interface HandlerEnvelopeIngestionV2SourceUploadResponse {
-    data?: HydraDB.IngestionV2SourceUploadResponse;
+export interface HandlerEnvelopeIngestionV2IngestResponse {
+    data?: HydraDB.IngestionV2IngestResponse;
     /** Error message, empty string on success. */
     error?: HydraDB.HandlerApiError;
     meta?: HydraDB.HandlerResponseMeta;

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

@@ -0,0 +1,9 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerEnvelopeListV2ListResponse {
+    data?: HydraDB.ListV2ListResponse;
+    /** Error message, empty string on success. */
+    error?: HydraDB.HandlerApiError;
+    meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
+    success?: boolean;
+}

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

@@ -0,0 +1,9 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerEnvelopeTenantsTenantMetadataSchemaResponse {
+    data?: HydraDB.TenantsTenantMetadataSchemaResponse;
+    /** Error message, empty string on success. */
+    error?: HydraDB.HandlerApiError;
+    meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
+    success?: boolean;
+}

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

@@ -0,0 +1,9 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerEnvelopeWebhooksSigningSecretResponse {
+    data?: HydraDB.WebhooksSigningSecretResponse;
+    /** Error message, empty string on success. */
+    error?: HydraDB.HandlerApiError;
+    meta?: HydraDB.HandlerResponseMeta;
+    /** Whether the request succeeded. */
+    success?: boolean;
+}

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

@@ -9,6 +9,13 @@ export interface HandlerErrorDetail {
     message?: string;
     /** The canonical replacement for the deprecated field. */
     preferredField?: string;
-    /** Always false for error responses. */
+    /**
+     * Deprecated for API clients: always false on this path, so it carries no
+     * information. To detect a failure read the HTTP status code; for what
+     * went wrong read the envelope's error.code and error.message, and
+     * meta.request_id when reporting it. The whole `detail` object is
+     * deprecated legacy — tagging the field individually so SDK users see it
+     * on the property, not just the container (PRO-1208).
+     */
     success?: boolean;
 }

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

@@ -0,0 +1,10 @@
+import type * as HydraDB from "../index.js";
+export interface HandlerErrorEnvelopeSourcesMemoryDeleteResponse {
+    data?: HydraDB.SourcesMemoryDeleteResponse;
+    detail?: HydraDB.HandlerErrorDetail;
+    /** Error message, empty string on success. */
+    error?: HydraDB.HandlerApiError;
+    meta?: HydraDB.HandlerErrorMeta;
+    /** Whether the request succeeded. */
+    success?: boolean;
+}

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

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

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

@@ -0,0 +1,8 @@
+export interface HandlerResourceDeleteResponse {
+    /** Connector this resource belongs to. */
+    connectorId?: string;
+    /** Whether this specific item was deleted. */
+    deleted?: boolean;
+    /** Resource identifier from the Discover endpoint. */
+    resourceId?: string;
+}

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

@@ -1,3 +1,4 @@
+import type * as HydraDB from "../index.js";
 export interface HandlerResourceMapping {
     /**
      * AdditionalMetadata is merged into the additional_metadata layer of every
@@ -37,6 +38,16 @@ export interface HandlerResourceMapping {
      * collection.
      */
     subTenantId?: string;
+    /**
+     * SyncMode is the per-resource update strategy for taps that support one
+     * (today: attio objects/lists). "rescan" (default) re-reads the full set
+     * every sync — the only way edits are seen on APIs with no updated_at.
+     * "new_only" bounds each scan to the sync window and stops paging at its
+     * floor — cheap, and an explicit opt-in to not seeing edits until
+     * webhooks land. Stored in the resource's filters and carried to the tap
+     * on every window.
+     */
+    syncMode?: HydraDB.HandlerResourceMappingSyncMode;
     /**
      * Optional per-resource tenant override (for "route specific resources to
      * different tenants"). Empty means the resource inherits the connector

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

@@ -0,0 +1,14 @@
+/**
+ * SyncMode is the per-resource update strategy for taps that support one
+ * (today: attio objects/lists). "rescan" (default) re-reads the full set
+ * every sync — the only way edits are seen on APIs with no updated_at.
+ * "new_only" bounds each scan to the sync window and stops paging at its
+ * floor — cheap, and an explicit opt-in to not seeing edits until
+ * webhooks land. Stored in the resource's filters and carried to the tap
+ * on every window.
+ */
+export declare const HandlerResourceMappingSyncMode: {
+    readonly Rescan: "rescan";
+    readonly NewOnly: "new_only";
+};
+export type HandlerResourceMappingSyncMode = (typeof HandlerResourceMappingSyncMode)[keyof typeof HandlerResourceMappingSyncMode];

package/dist/api/types/HandlerResourceMappingSyncMode.js

@@ -0,0 +1,17 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerResourceMappingSyncMode = void 0;
+/**
+ * SyncMode is the per-resource update strategy for taps that support one
+ * (today: attio objects/lists). "rescan" (default) re-reads the full set
+ * every sync — the only way edits are seen on APIs with no updated_at.
+ * "new_only" bounds each scan to the sync window and stops paging at its
+ * floor — cheap, and an explicit opt-in to not seeing edits until
+ * webhooks land. Stored in the resource's filters and carried to the tap
+ * on every window.
+ */
+exports.HandlerResourceMappingSyncMode = {
+    Rescan: "rescan",
+    NewOnly: "new_only",
+};

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

@@ -0,0 +1,5 @@
+export interface HandlerTableConfigEntry {
+    changeHistory?: string;
+    replicationKey?: string;
+    table?: string;
+}

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

@@ -1,3 +1,7 @@
+/**
+ * Status is the item's initial lifecycle state. Both modes share this
+ * vocabulary — memory mode reuses the same values.
+ */
 export declare const IngestionSourceStatus: {
     readonly Queued: "queued";
     readonly Processing: "processing";

package/dist/api/types/IngestionSourceStatus.js

@@ -2,6 +2,10 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IngestionSourceStatus = void 0;
+/**
+ * Status is the item's initial lifecycle state. Both modes share this
+ * vocabulary — memory mode reuses the same values.
+ */
 exports.IngestionSourceStatus = {
     Queued: "queued",
     Processing: "processing",

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

@@ -0,0 +1,21 @@
+import type * as HydraDB from "../index.js";
+export interface IngestionV2IngestResponse {
+    /** Number of uploaded files that failed to queue. */
+    failedCount?: number;
+    /** Human-readable result message. */
+    message?: string;
+    /** Per-item results. */
+    results?: HydraDB.IngestionV2IngestResultItem[];
+    /**
+     * Deprecated for API clients: whether the REQUEST was accepted is the HTTP
+     * status code (202) or equivalently the envelope's top-level `success`.
+     * Whether each SOURCE ingested is per-item — read results[].status and
+     * results[].error, then poll GET /context/status, since a 202 only means
+     * queued. This flag answers neither question independently: it always
+     * mirrors the envelope. Still emitted unchanged for existing clients
+     * (PRO-1208).
+     */
+    success?: boolean;
+    /** Number of files successfully queued for processing. */
+    successCount?: number;
+}

package/dist/api/types/IngestionV2IngestResponse.js

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