samva 0.26.0 → 0.28.0

package/dist/effect/generated/contacts.d.ts

@@ -1,6 +1,7 @@
+import type * as EffectBrand from "effect/Brand";
 import { HttpApiEndpoint, HttpApiGroup } from "effect/http-api";
 import * as Schema from "effect/Schema";
-import { ApiKeySecurityMiddleware, BillingProviderError, ConflictError, ContactGroupId, ContactId, ContactIdentity, ContactIdentityId, ConversationId, Cursor, ForbiddenError, GatewayTimeoutError, InternalError, JsonObject, MessageId, NamespaceId, PaymentRequiredError, ResourceNotFoundError, UnauthorizedError, ValidationError } from "./shared";
+import { ApiKeySecurityMiddleware, BillingProviderError, ConflictError, ContactGroupId, ContactId, ContactIdentity, ContactIdentityId, ConversationId, Cursor, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, JsonObject, MessageId, NamespaceId, PaymentRequiredError, ResourceNotFoundError, TopicId, UnauthorizedError, ValidationError } from "./shared";
 export type ContactCustomFields = {
     readonly [x: string]: string | number | boolean | null;
 };
@@ -51,6 +52,8 @@ export declare const ContactPreferences: Schema.Struct<{
         }>, Schema.Null]>>;
     }>, Schema.Null]>>;
 }>;
+export type ContactImportJobId = string & EffectBrand.Brand<"ContactImportJobId">;
+export declare const ContactImportJobId: Schema.brand<Schema.String, "ContactImportJobId">;
 export type BulkUpdateResult = {
     readonly updated: number;
     readonly failed: number;
@@ -252,6 +255,64 @@ export type Contact = {
     readonly preferences: ContactPreferences | null;
     readonly tags: ReadonlyArray<string>;
     readonly metadata: JsonObject | null;
+    readonly importProvenance: {
+        readonly first: {
+            readonly jobId: ContactImportJobId;
+            readonly topicId: TopicId;
+            readonly preset: "beehiiv" | "substack" | "kit" | "mailchimp";
+            readonly importedAt: string;
+            readonly summary?: {
+                readonly signupAt: {
+                    readonly value: string;
+                    readonly kind: "time" | "text";
+                } | null;
+                readonly sources: ReadonlyArray<string>;
+                readonly omittedSources: number;
+            } | null;
+            readonly evidence: ReadonlyArray<{
+                readonly file: string;
+                readonly row: number;
+                readonly declared: {
+                    readonly kind: "status_column";
+                } | {
+                    readonly kind: "export_scope";
+                    readonly scope: "subscribed" | "unsubscribed" | "suppressed" | "cleaned/bounced";
+                };
+                readonly suppressionFree: boolean;
+                readonly sourceStatus: string | null;
+                readonly signupAt: string | null;
+                readonly source: string | null;
+            }>;
+        };
+        readonly latest: {
+            readonly jobId: ContactImportJobId;
+            readonly topicId: TopicId;
+            readonly preset: "beehiiv" | "substack" | "kit" | "mailchimp";
+            readonly importedAt: string;
+            readonly summary?: {
+                readonly signupAt: {
+                    readonly value: string;
+                    readonly kind: "time" | "text";
+                } | null;
+                readonly sources: ReadonlyArray<string>;
+                readonly omittedSources: number;
+            } | null;
+            readonly evidence: ReadonlyArray<{
+                readonly file: string;
+                readonly row: number;
+                readonly declared: {
+                    readonly kind: "status_column";
+                } | {
+                    readonly kind: "export_scope";
+                    readonly scope: "subscribed" | "unsubscribed" | "suppressed" | "cleaned/bounced";
+                };
+                readonly suppressionFree: boolean;
+                readonly sourceStatus: string | null;
+                readonly signupAt: string | null;
+                readonly source: string | null;
+            }>;
+        };
+    } | null;
     readonly createdAt: string;
     readonly updatedAt: string;
 };
@@ -308,11 +369,69 @@ export declare const Contact: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
 export type ContactsListQuery = {
-    readonly limit?: string | null;
+    readonly limit?: number | null;
     readonly cursor?: Cursor | null;
     readonly namespaceId?: NamespaceId | null;
     readonly search?: string | null;
@@ -324,7 +443,7 @@ export type ContactsListQuery = {
     readonly before?: string | null;
 };
 export declare const ContactsListQuery: Schema.Struct<{
-    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.Null]>>;
     readonly cursor: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
     readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
     readonly search: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
@@ -477,6 +596,64 @@ export declare const ContactsCreate201: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -558,6 +735,64 @@ export declare const ContactsGet200: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -704,6 +939,64 @@ export declare const ContactsUpdate200: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -730,12 +1023,12 @@ export declare const ContactsGetActivityTimelinePathParams: Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "ContactId">;
 }>;
 export type ContactsGetActivityTimelineQuery = {
-    readonly limit?: string | null;
+    readonly limit?: number | null;
     readonly cursor?: Cursor | null;
     readonly channel?: "email" | null;
 };
 export declare const ContactsGetActivityTimelineQuery: Schema.Struct<{
-    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.Null]>>;
     readonly cursor: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
     readonly channel: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"email">, Schema.Null]>>;
 }>;
@@ -808,11 +1101,11 @@ export declare const ContactsGetGroupMembershipsPathParams: Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "ContactId">;
 }>;
 export type ContactsGetGroupMembershipsQuery = {
-    readonly limit?: string | null;
+    readonly limit?: number | null;
     readonly cursor?: Cursor | null;
 };
 export declare const ContactsGetGroupMembershipsQuery: Schema.Struct<{
-    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.Null]>>;
     readonly cursor: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
 }>;
 export type ContactsGetGroupMemberships200 = ContactGroupMembershipPage;
@@ -909,6 +1202,64 @@ export declare const ContactsAddIdentity200: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -988,6 +1339,64 @@ export declare const ContactsRemoveIdentity200: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -1079,6 +1488,64 @@ export declare const ContactsSetConsent200: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -1160,6 +1627,64 @@ export declare const ContactsAddTags200: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -1241,6 +1766,64 @@ export declare const ContactsRemoveTags200: Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>;
@@ -1282,110 +1865,6 @@ export type ContactsBulkDelete502 = BillingProviderError;
 export declare const ContactsBulkDelete502: typeof BillingProviderError;
 export type ContactsBulkDelete504 = GatewayTimeoutError;
 export declare const ContactsBulkDelete504: typeof GatewayTimeoutError;
-export type ContactsBulkImportRequestJson = {
-    readonly namespaceId?: NamespaceId | null;
-    readonly contacts: ReadonlyArray<{
-        readonly name: string;
-        readonly displayName?: string | null | null;
-        readonly avatar?: string | null | null;
-        readonly identities?: ReadonlyArray<ContactIdentityInput> | null;
-        readonly profile?: ContactProfile | null | null;
-        readonly preferences?: ContactPreferences | null | null;
-        readonly tags?: ReadonlyArray<string> | null;
-        readonly status?: "active" | "paused" | "blocked" | "archived" | null;
-        readonly statusReason?: string | null | null;
-        readonly externalId?: string | null | null;
-        readonly metadata?: JsonObject | null | null;
-    }>;
-    readonly onConflict?: "skip" | "update" | null;
-};
-export declare const ContactsBulkImportRequestJson: Schema.Struct<{
-    readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
-    readonly contacts: Schema.$Array<Schema.Struct<{
-        readonly name: Schema.String;
-        readonly displayName: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly avatar: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly identities: Schema.optionalKey<Schema.Union<readonly [Schema.$Array<Schema.Struct<{
-            readonly type: Schema.Union<readonly [Schema.Literal<"email">, Schema.Literal<"phone">]>;
-            readonly identifier: Schema.String;
-            readonly verified: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
-        }>>, Schema.Null]>>;
-        readonly profile: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
-            readonly firstName: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly lastName: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly company: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly jobTitle: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly location: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
-                readonly country: Schema.String;
-                readonly state: Schema.String;
-                readonly city: Schema.String;
-                readonly timezone: Schema.String;
-            }>, Schema.Null]>>;
-            readonly customFields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>, Schema.Null]>>;
-            readonly source: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"import">, Schema.Literal<"manual">, Schema.Literal<"form">]>, Schema.Null]>>;
-        }>, Schema.Null]>, Schema.Null]>>;
-        readonly preferences: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
-            readonly preferredChannels: Schema.optionalKey<Schema.Union<readonly [Schema.$Array<Schema.Literal<"email">>, Schema.Null]>>;
-            readonly language: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly timezone: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly notifications: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
-                readonly email: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
-                readonly quiet_hours: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
-                    readonly start: Schema.String;
-                    readonly end: Schema.String;
-                }>, Schema.Null]>>;
-            }>, Schema.Null]>>;
-        }>, Schema.Null]>, Schema.Null]>>;
-        readonly tags: Schema.optionalKey<Schema.Union<readonly [Schema.$Array<Schema.String>, Schema.Null]>>;
-        readonly status: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"paused">, Schema.Literal<"blocked">, Schema.Literal<"archived">]>, Schema.Null]>>;
-        readonly statusReason: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly externalId: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly metadata: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>, Schema.Null]>>;
-    }>>;
-    readonly onConflict: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"skip">, Schema.Literal<"update">]>, Schema.Null]>>;
-}>;
-export type ContactsBulkImport200 = {
-    readonly total: number;
-    readonly created: number;
-    readonly updated: number;
-    readonly skipped: number;
-    readonly errors: number;
-    readonly results: ReadonlyArray<{
-        readonly index: number;
-        readonly status: "created" | "updated" | "skipped" | "error";
-        readonly contactId?: ContactId | null;
-        readonly error?: string | null;
-    }>;
-};
-export declare const ContactsBulkImport200: Schema.Struct<{
-    readonly total: Schema.Finite;
-    readonly created: Schema.Finite;
-    readonly updated: Schema.Finite;
-    readonly skipped: Schema.Finite;
-    readonly errors: Schema.Finite;
-    readonly results: Schema.$Array<Schema.Struct<{
-        readonly index: Schema.Finite;
-        readonly status: Schema.Union<readonly [Schema.Literal<"created">, Schema.Literal<"updated">, Schema.Literal<"skipped">, Schema.Literal<"error">]>;
-        readonly contactId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "ContactId">, Schema.Null]>>;
-        readonly error: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-    }>>;
-}>;
-export type ContactsBulkImport401 = UnauthorizedError;
-export declare const ContactsBulkImport401: typeof UnauthorizedError;
-export type ContactsBulkImport402 = PaymentRequiredError;
-export declare const ContactsBulkImport402: typeof PaymentRequiredError;
-export type ContactsBulkImport403 = ForbiddenError;
-export declare const ContactsBulkImport403: typeof ForbiddenError;
-export type ContactsBulkImport404 = ResourceNotFoundError;
-export declare const ContactsBulkImport404: typeof ResourceNotFoundError;
-export type ContactsBulkImport422 = ValidationError;
-export declare const ContactsBulkImport422: typeof ValidationError;
-export type ContactsBulkImport500 = InternalError;
-export declare const ContactsBulkImport500: typeof InternalError;
-export type ContactsBulkImport502 = BillingProviderError;
-export declare const ContactsBulkImport502: typeof BillingProviderError;
-export type ContactsBulkImport504 = GatewayTimeoutError;
-export declare const ContactsBulkImport504: typeof GatewayTimeoutError;
 export type ContactsBulkUpdateStatusRequestJson = {
     readonly ids: readonly [ContactId, ...Array<ContactId>];
     readonly status: "active" | "paused" | "blocked" | "archived";
@@ -1542,6 +2021,64 @@ export declare const ContactsFind200: Schema.Union<readonly [Schema.Struct<{
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>, Schema.Null]>;
@@ -1667,6 +2204,64 @@ export declare const ContactsFindOrCreate200: Schema.Struct<{
         }>, Schema.Null]>;
         readonly tags: Schema.$Array<Schema.String>;
         readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+        readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+            readonly first: Schema.Struct<{
+                readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+                readonly topicId: Schema.brand<Schema.String, "TopicId">;
+                readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+                readonly importedAt: Schema.String;
+                readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                    readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                        readonly value: Schema.String;
+                        readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                    }>, Schema.Null]>;
+                    readonly sources: Schema.$Array<Schema.String>;
+                    readonly omittedSources: Schema.Finite;
+                }>, Schema.Null]>>;
+                readonly evidence: Schema.$Array<Schema.Struct<{
+                    readonly file: Schema.String;
+                    readonly row: Schema.Finite;
+                    readonly declared: Schema.Union<readonly [Schema.Struct<{
+                        readonly kind: Schema.Literal<"status_column">;
+                    }>, Schema.Struct<{
+                        readonly kind: Schema.Literal<"export_scope">;
+                        readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                    }>]>;
+                    readonly suppressionFree: Schema.Boolean;
+                    readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                }>>;
+            }>;
+            readonly latest: Schema.Struct<{
+                readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+                readonly topicId: Schema.brand<Schema.String, "TopicId">;
+                readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+                readonly importedAt: Schema.String;
+                readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                    readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                        readonly value: Schema.String;
+                        readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                    }>, Schema.Null]>;
+                    readonly sources: Schema.$Array<Schema.String>;
+                    readonly omittedSources: Schema.Finite;
+                }>, Schema.Null]>>;
+                readonly evidence: Schema.$Array<Schema.Struct<{
+                    readonly file: Schema.String;
+                    readonly row: Schema.Finite;
+                    readonly declared: Schema.Union<readonly [Schema.Struct<{
+                        readonly kind: Schema.Literal<"status_column">;
+                    }>, Schema.Struct<{
+                        readonly kind: Schema.Literal<"export_scope">;
+                        readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                    }>]>;
+                    readonly suppressionFree: Schema.Boolean;
+                    readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                }>>;
+            }>;
+        }>, Schema.Null]>;
         readonly createdAt: Schema.String;
         readonly updatedAt: Schema.String;
     }>;
@@ -1690,6 +2285,358 @@ export type ContactsFindOrCreate502 = BillingProviderError;
 export declare const ContactsFindOrCreate502: typeof BillingProviderError;
 export type ContactsFindOrCreate504 = GatewayTimeoutError;
 export declare const ContactsFindOrCreate504: typeof GatewayTimeoutError;
+export type ContactsStartImportRequestJson = {
+    readonly mode: "new";
+    readonly input: {
+        readonly preset: "beehiiv" | "substack" | "kit" | "mailchimp";
+        readonly topicId: TopicId;
+        readonly namespaceId?: NamespaceId | null;
+        readonly files: readonly [
+            {
+                readonly name: string;
+                readonly csv: string;
+                readonly evidence: {
+                    readonly kind: "status_column";
+                } | {
+                    readonly kind: "export_scope";
+                    readonly scope: "subscribed" | "unsubscribed" | "suppressed" | "cleaned/bounced";
+                };
+                readonly suppressionFree?: boolean | null;
+            },
+            ...Array<{
+                readonly name: string;
+                readonly csv: string;
+                readonly evidence: {
+                    readonly kind: "status_column";
+                } | {
+                    readonly kind: "export_scope";
+                    readonly scope: "subscribed" | "unsubscribed" | "suppressed" | "cleaned/bounced";
+                };
+                readonly suppressionFree?: boolean | null;
+            }>
+        ];
+    };
+    readonly planHash: string;
+    readonly idempotencyKey: string;
+} | {
+    readonly mode: "resume";
+    readonly jobId: ContactImportJobId;
+    readonly expectedGeneration: number;
+};
+export declare const ContactsStartImportRequestJson: Schema.Union<readonly [Schema.Struct<{
+    readonly mode: Schema.Literal<"new">;
+    readonly input: Schema.Struct<{
+        readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+        readonly topicId: Schema.brand<Schema.String, "TopicId">;
+        readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
+        readonly files: Schema.TupleWithRest<Schema.Tuple<readonly [Schema.Struct<{
+            readonly name: Schema.String;
+            readonly csv: Schema.String;
+            readonly evidence: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"status_column">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"export_scope">;
+                readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+            }>]>;
+            readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+        }>]>, readonly [Schema.Struct<{
+            readonly name: Schema.String;
+            readonly csv: Schema.String;
+            readonly evidence: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"status_column">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"export_scope">;
+                readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+            }>]>;
+            readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+        }>]>;
+    }>;
+    readonly planHash: Schema.String;
+    readonly idempotencyKey: Schema.String;
+}>, Schema.Struct<{
+    readonly mode: Schema.Literal<"resume">;
+    readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+    readonly expectedGeneration: Schema.Finite;
+}>]>;
+export type ContactsStartImport202 = {
+    readonly id: ContactImportJobId;
+    readonly namespaceId: NamespaceId | null;
+    readonly topicId: TopicId;
+    readonly preset: "beehiiv" | "substack" | "kit" | "mailchimp";
+    readonly status: "queued" | "running" | "finalizing" | "completed" | "failed";
+    readonly generation: number;
+    readonly counts: {
+        readonly totalRows: number;
+        readonly uniqueAddresses: number;
+        readonly subscribed: number;
+        readonly unsubscribed: number;
+        readonly suppressed: number;
+        readonly skipped: number;
+        readonly conflicts: number;
+        readonly created: number;
+        readonly existing: number;
+    };
+    readonly processedRows: number;
+    readonly totalRows: number;
+    readonly createdAt: string;
+    readonly startedAt: string | null;
+    readonly updatedAt: string;
+    readonly completedAt: string | null;
+    readonly failure: {
+        readonly code: string;
+        readonly message: string;
+        readonly retryable: boolean;
+    } | null;
+    readonly resumable: boolean;
+};
+export declare const ContactsStartImport202: Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "ContactImportJobId">;
+    readonly namespaceId: Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"queued">, Schema.Literal<"running">, Schema.Literal<"finalizing">, Schema.Literal<"completed">, Schema.Literal<"failed">]>;
+    readonly generation: Schema.Finite;
+    readonly counts: Schema.Struct<{
+        readonly totalRows: Schema.Finite;
+        readonly uniqueAddresses: Schema.Finite;
+        readonly subscribed: Schema.Finite;
+        readonly unsubscribed: Schema.Finite;
+        readonly suppressed: Schema.Finite;
+        readonly skipped: Schema.Finite;
+        readonly conflicts: Schema.Finite;
+        readonly created: Schema.Finite;
+        readonly existing: Schema.Finite;
+    }>;
+    readonly processedRows: Schema.Finite;
+    readonly totalRows: Schema.Finite;
+    readonly createdAt: Schema.String;
+    readonly startedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly updatedAt: Schema.String;
+    readonly completedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly failure: Schema.Union<readonly [Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+    }>, Schema.Null]>;
+    readonly resumable: Schema.Boolean;
+}>;
+export type ContactsStartImport401 = UnauthorizedError;
+export declare const ContactsStartImport401: typeof UnauthorizedError;
+export type ContactsStartImport402 = PaymentRequiredError;
+export declare const ContactsStartImport402: typeof PaymentRequiredError;
+export type ContactsStartImport403 = ForbiddenError | FlagDisabledError;
+export declare const ContactsStartImport403: Schema.Union<readonly [typeof ForbiddenError, typeof FlagDisabledError]>;
+export type ContactsStartImport404 = ResourceNotFoundError;
+export declare const ContactsStartImport404: typeof ResourceNotFoundError;
+export type ContactsStartImport409 = ConflictError;
+export declare const ContactsStartImport409: typeof ConflictError;
+export type ContactsStartImport422 = ValidationError;
+export declare const ContactsStartImport422: typeof ValidationError;
+export type ContactsStartImport500 = InternalError;
+export declare const ContactsStartImport500: typeof InternalError;
+export type ContactsStartImport502 = BillingProviderError;
+export declare const ContactsStartImport502: typeof BillingProviderError;
+export type ContactsStartImport504 = GatewayTimeoutError;
+export declare const ContactsStartImport504: typeof GatewayTimeoutError;
+export type ContactsGetImportJobPathParams = {
+    readonly id: ContactImportJobId;
+};
+export declare const ContactsGetImportJobPathParams: Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "ContactImportJobId">;
+}>;
+export type ContactsGetImportJob200 = {
+    readonly id: ContactImportJobId;
+    readonly namespaceId: NamespaceId | null;
+    readonly topicId: TopicId;
+    readonly preset: "beehiiv" | "substack" | "kit" | "mailchimp";
+    readonly status: "queued" | "running" | "finalizing" | "completed" | "failed";
+    readonly generation: number;
+    readonly counts: {
+        readonly totalRows: number;
+        readonly uniqueAddresses: number;
+        readonly subscribed: number;
+        readonly unsubscribed: number;
+        readonly suppressed: number;
+        readonly skipped: number;
+        readonly conflicts: number;
+        readonly created: number;
+        readonly existing: number;
+    };
+    readonly processedRows: number;
+    readonly totalRows: number;
+    readonly createdAt: string;
+    readonly startedAt: string | null;
+    readonly updatedAt: string;
+    readonly completedAt: string | null;
+    readonly failure: {
+        readonly code: string;
+        readonly message: string;
+        readonly retryable: boolean;
+    } | null;
+    readonly resumable: boolean;
+};
+export declare const ContactsGetImportJob200: Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "ContactImportJobId">;
+    readonly namespaceId: Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"queued">, Schema.Literal<"running">, Schema.Literal<"finalizing">, Schema.Literal<"completed">, Schema.Literal<"failed">]>;
+    readonly generation: Schema.Finite;
+    readonly counts: Schema.Struct<{
+        readonly totalRows: Schema.Finite;
+        readonly uniqueAddresses: Schema.Finite;
+        readonly subscribed: Schema.Finite;
+        readonly unsubscribed: Schema.Finite;
+        readonly suppressed: Schema.Finite;
+        readonly skipped: Schema.Finite;
+        readonly conflicts: Schema.Finite;
+        readonly created: Schema.Finite;
+        readonly existing: Schema.Finite;
+    }>;
+    readonly processedRows: Schema.Finite;
+    readonly totalRows: Schema.Finite;
+    readonly createdAt: Schema.String;
+    readonly startedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly updatedAt: Schema.String;
+    readonly completedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly failure: Schema.Union<readonly [Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+    }>, Schema.Null]>;
+    readonly resumable: Schema.Boolean;
+}>;
+export type ContactsGetImportJob401 = UnauthorizedError;
+export declare const ContactsGetImportJob401: typeof UnauthorizedError;
+export type ContactsGetImportJob403 = ForbiddenError;
+export declare const ContactsGetImportJob403: typeof ForbiddenError;
+export type ContactsGetImportJob404 = ResourceNotFoundError;
+export declare const ContactsGetImportJob404: typeof ResourceNotFoundError;
+export type ContactsGetImportJob422 = ValidationError;
+export declare const ContactsGetImportJob422: typeof ValidationError;
+export type ContactsGetImportJob500 = InternalError;
+export declare const ContactsGetImportJob500: typeof InternalError;
+export type ContactsGetImportJob504 = GatewayTimeoutError;
+export declare const ContactsGetImportJob504: typeof GatewayTimeoutError;
+export type ContactsPlanImportRequestJson = {
+    readonly preset: "beehiiv" | "substack" | "kit" | "mailchimp";
+    readonly topicId: TopicId;
+    readonly namespaceId?: NamespaceId | null;
+    readonly files: readonly [
+        {
+            readonly name: string;
+            readonly csv: string;
+            readonly evidence: {
+                readonly kind: "status_column";
+            } | {
+                readonly kind: "export_scope";
+                readonly scope: "subscribed" | "unsubscribed" | "suppressed" | "cleaned/bounced";
+            };
+            readonly suppressionFree?: boolean | null;
+        },
+        ...Array<{
+            readonly name: string;
+            readonly csv: string;
+            readonly evidence: {
+                readonly kind: "status_column";
+            } | {
+                readonly kind: "export_scope";
+                readonly scope: "subscribed" | "unsubscribed" | "suppressed" | "cleaned/bounced";
+            };
+            readonly suppressionFree?: boolean | null;
+        }>
+    ];
+};
+export declare const ContactsPlanImportRequestJson: Schema.Struct<{
+    readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
+    readonly files: Schema.TupleWithRest<Schema.Tuple<readonly [Schema.Struct<{
+        readonly name: Schema.String;
+        readonly csv: Schema.String;
+        readonly evidence: Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"status_column">;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"export_scope">;
+            readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+        }>]>;
+        readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+    }>]>, readonly [Schema.Struct<{
+        readonly name: Schema.String;
+        readonly csv: Schema.String;
+        readonly evidence: Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"status_column">;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"export_scope">;
+            readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+        }>]>;
+        readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+    }>]>;
+}>;
+export type ContactsPlanImport200 = {
+    readonly planHash: string;
+    readonly presetVersion: string;
+    readonly namespaceId: NamespaceId | null;
+    readonly topicId: TopicId;
+    readonly canStart: boolean;
+    readonly counts: {
+        readonly totalRows: number;
+        readonly uniqueAddresses: number;
+        readonly subscribed: number;
+        readonly unsubscribed: number;
+        readonly suppressed: number;
+        readonly skipped: number;
+        readonly conflicts: number;
+        readonly created: number;
+        readonly existing: number;
+    };
+    readonly diagnostics: ReadonlyArray<{
+        readonly file: string;
+        readonly row: number;
+        readonly code: string;
+        readonly message: string;
+        readonly email?: string | null;
+    }>;
+    readonly diagnosticsTruncated: boolean;
+};
+export declare const ContactsPlanImport200: Schema.Struct<{
+    readonly planHash: Schema.String;
+    readonly presetVersion: Schema.String;
+    readonly namespaceId: Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly canStart: Schema.Boolean;
+    readonly counts: Schema.Struct<{
+        readonly totalRows: Schema.Finite;
+        readonly uniqueAddresses: Schema.Finite;
+        readonly subscribed: Schema.Finite;
+        readonly unsubscribed: Schema.Finite;
+        readonly suppressed: Schema.Finite;
+        readonly skipped: Schema.Finite;
+        readonly conflicts: Schema.Finite;
+        readonly created: Schema.Finite;
+        readonly existing: Schema.Finite;
+    }>;
+    readonly diagnostics: Schema.$Array<Schema.Struct<{
+        readonly file: Schema.String;
+        readonly row: Schema.Finite;
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly email: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    }>>;
+    readonly diagnosticsTruncated: Schema.Boolean;
+}>;
+export type ContactsPlanImport401 = UnauthorizedError;
+export declare const ContactsPlanImport401: typeof UnauthorizedError;
+export type ContactsPlanImport403 = ForbiddenError | FlagDisabledError;
+export declare const ContactsPlanImport403: Schema.Union<readonly [typeof ForbiddenError, typeof FlagDisabledError]>;
+export type ContactsPlanImport404 = ResourceNotFoundError;
+export declare const ContactsPlanImport404: typeof ResourceNotFoundError;
+export type ContactsPlanImport422 = ValidationError;
+export declare const ContactsPlanImport422: typeof ValidationError;
+export type ContactsPlanImport500 = InternalError;
+export declare const ContactsPlanImport500: typeof InternalError;
+export type ContactsPlanImport504 = GatewayTimeoutError;
+export declare const ContactsPlanImport504: typeof GatewayTimeoutError;
 declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiEndpoint.HttpApiEndpoint<"contactsAddIdentity", "POST", "/v1/contacts/:id/identities", Schema.toCodecStringTree<Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "ContactId">;
 }>>, never, Schema.toCodecJson<Schema.Struct<{
@@ -1749,6 +2696,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ConflictError, {
@@ -1908,6 +2913,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ForbiddenError, {
@@ -2067,184 +3130,12 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     readonly _tag: Schema.tag<"ValidationError">;
     readonly message: Schema.String;
     readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
-}>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsBulkImport", "POST", "/v1/contacts/bulk-import", never, never, Schema.toCodecJson<Schema.Struct<{
-    readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
-    readonly contacts: Schema.$Array<Schema.Struct<{
-        readonly name: Schema.String;
-        readonly displayName: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly avatar: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly identities: Schema.optionalKey<Schema.Union<readonly [Schema.$Array<Schema.Struct<{
-            readonly type: Schema.Union<readonly [Schema.Literal<"email">, Schema.Literal<"phone">]>;
-            readonly identifier: Schema.String;
-            readonly verified: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
-        }>>, Schema.Null]>>;
-        readonly profile: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
-            readonly firstName: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly lastName: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly company: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly jobTitle: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly location: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
-                readonly country: Schema.String;
-                readonly state: Schema.String;
-                readonly city: Schema.String;
-                readonly timezone: Schema.String;
-            }>, Schema.Null]>>;
-            readonly customFields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>, Schema.Null]>>;
-            readonly source: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"import">, Schema.Literal<"manual">, Schema.Literal<"form">]>, Schema.Null]>>;
-        }>, Schema.Null]>, Schema.Null]>>;
-        readonly preferences: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
-            readonly preferredChannels: Schema.optionalKey<Schema.Union<readonly [Schema.$Array<Schema.Literal<"email">>, Schema.Null]>>;
-            readonly language: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly timezone: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-            readonly notifications: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
-                readonly email: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
-                readonly quiet_hours: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
-                    readonly start: Schema.String;
-                    readonly end: Schema.String;
-                }>, Schema.Null]>>;
-            }>, Schema.Null]>>;
-        }>, Schema.Null]>, Schema.Null]>>;
-        readonly tags: Schema.optionalKey<Schema.Union<readonly [Schema.$Array<Schema.String>, Schema.Null]>>;
-        readonly status: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"paused">, Schema.Literal<"blocked">, Schema.Literal<"archived">]>, Schema.Null]>>;
-        readonly statusReason: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly externalId: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Null]>, Schema.Null]>>;
-        readonly metadata: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>, Schema.Null]>>;
-    }>>;
-    readonly onConflict: Schema.optionalKey<Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"skip">, Schema.Literal<"update">]>, Schema.Null]>>;
+}>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsBulkUpdateStatus", "POST", "/v1/contacts/bulk-update-status", never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ids: Schema.TupleWithRest<Schema.Tuple<readonly [Schema.brand<Schema.String, "ContactId">]>, readonly [Schema.brand<Schema.String, "ContactId">]>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"paused">, Schema.Literal<"blocked">, Schema.Literal<"archived">]>;
 }>>, never, Schema.toCodecJson<Schema.Struct<{
-    readonly total: Schema.Finite;
-    readonly created: Schema.Finite;
     readonly updated: Schema.Finite;
-    readonly skipped: Schema.Finite;
-    readonly errors: Schema.Finite;
-    readonly results: Schema.$Array<Schema.Struct<{
-        readonly index: Schema.Finite;
-        readonly status: Schema.Union<readonly [Schema.Literal<"created">, Schema.Literal<"updated">, Schema.Literal<"skipped">, Schema.Literal<"error">]>;
-        readonly contactId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "ContactId">, Schema.Null]>>;
-        readonly error: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
-    }>>;
-}>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<BillingProviderError, {
-    readonly _tag: "BillingProviderError";
-    readonly message: string;
-}, readonly [Schema.Struct<{
-    readonly _tag: Schema.tag<"BillingProviderError">;
-    readonly message: Schema.String;
-}>], {
-    readonly _tag: "BillingProviderError";
-    readonly message: string;
-}>, Schema.Struct<{
-    readonly _tag: Schema.tag<"BillingProviderError">;
-    readonly message: Schema.String;
-}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ForbiddenError, {
-    readonly _tag: "ForbiddenError";
-    readonly message: string;
-}, readonly [Schema.Struct<{
-    readonly _tag: Schema.tag<"ForbiddenError">;
-    readonly message: Schema.String;
-}>], {
-    readonly _tag: "ForbiddenError";
-    readonly message: string;
-}>, Schema.Struct<{
-    readonly _tag: Schema.tag<"ForbiddenError">;
-    readonly message: Schema.String;
-}>, never, never> | Schema.decodeTo<Schema.declareConstructor<GatewayTimeoutError, {
-    readonly _tag: "GatewayTimeoutError";
-    readonly message: string;
-    readonly retryAfterSeconds: number;
-}, readonly [Schema.Struct<{
-    readonly _tag: Schema.tag<"GatewayTimeoutError">;
-    readonly message: Schema.String;
-    readonly retryAfterSeconds: Schema.Finite;
-}>], {
-    readonly _tag: "GatewayTimeoutError";
-    readonly message: string;
-    readonly retryAfterSeconds: number;
-}>, Schema.Struct<{
-    readonly _tag: Schema.tag<"GatewayTimeoutError">;
-    readonly message: Schema.String;
-    readonly retryAfterSeconds: Schema.Finite;
-}>, never, never> | Schema.decodeTo<Schema.declareConstructor<PaymentRequiredError, {
-    readonly _tag: "PaymentRequiredError";
-    readonly message: string;
-    readonly resource: string;
-    readonly currentUsage: number;
-    readonly limit: number;
-}, readonly [Schema.Struct<{
-    readonly _tag: Schema.tag<"PaymentRequiredError">;
-    readonly message: Schema.String;
-    readonly resource: Schema.String;
-    readonly currentUsage: Schema.Finite;
-    readonly limit: Schema.Finite;
-}>], {
-    readonly _tag: "PaymentRequiredError";
-    readonly message: string;
-    readonly resource: string;
-    readonly currentUsage: number;
-    readonly limit: number;
-}>, Schema.Struct<{
-    readonly _tag: Schema.tag<"PaymentRequiredError">;
-    readonly message: Schema.String;
-    readonly resource: Schema.String;
-    readonly currentUsage: Schema.Finite;
-    readonly limit: Schema.Finite;
-}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ResourceNotFoundError, {
-    readonly _tag: "ResourceNotFoundError";
-    readonly resource: string;
-    readonly id: string;
-    readonly message: string;
-}, readonly [Schema.Struct<{
-    readonly _tag: Schema.tag<"ResourceNotFoundError">;
-    readonly resource: Schema.String;
-    readonly id: Schema.String;
-    readonly message: Schema.String;
-}>], {
-    readonly _tag: "ResourceNotFoundError";
-    readonly resource: string;
-    readonly id: string;
-    readonly message: string;
-}>, Schema.Struct<{
-    readonly _tag: Schema.tag<"ResourceNotFoundError">;
-    readonly resource: Schema.String;
-    readonly id: Schema.String;
-    readonly message: Schema.String;
-}>, never, never> | Schema.decodeTo<Schema.declareConstructor<UnauthorizedError, {
-    readonly _tag: "UnauthorizedError";
-    readonly message: string;
-}, readonly [Schema.Struct<{
-    readonly _tag: Schema.tag<"UnauthorizedError">;
-    readonly message: Schema.String;
-}>], {
-    readonly _tag: "UnauthorizedError";
-    readonly message: string;
-}>, Schema.Struct<{
-    readonly _tag: Schema.tag<"UnauthorizedError">;
-    readonly message: Schema.String;
-}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ValidationError, {
-    readonly _tag: "ValidationError";
-    readonly message: string;
-    readonly fields?: {
-        readonly [x: string]: readonly string[];
-    } | null;
-}, readonly [Schema.Struct<{
-    readonly _tag: Schema.tag<"ValidationError">;
-    readonly message: Schema.String;
-    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
-}>], {
-    readonly _tag: "ValidationError";
-    readonly message: string;
-    readonly fields?: {
-        readonly [x: string]: readonly string[];
-    } | null;
-}>, Schema.Struct<{
-    readonly _tag: Schema.tag<"ValidationError">;
-    readonly message: Schema.String;
-    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
-}>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsBulkUpdateStatus", "POST", "/v1/contacts/bulk-update-status", never, never, Schema.toCodecJson<Schema.Struct<{
-    readonly ids: Schema.TupleWithRest<Schema.Tuple<readonly [Schema.brand<Schema.String, "ContactId">]>, readonly [Schema.brand<Schema.String, "ContactId">]>;
-    readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"paused">, Schema.Literal<"blocked">, Schema.Literal<"archived">]>;
-}>>, never, Schema.toCodecJson<Schema.Struct<{
-    readonly updated: Schema.Finite;
-    readonly failed: Schema.Finite;
+    readonly failed: Schema.Finite;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<BillingProviderError, {
     readonly _tag: "BillingProviderError";
     readonly message: string;
@@ -2502,6 +3393,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<BillingProviderError, {
@@ -2770,6 +3719,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>, Schema.Null]>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ConflictError, {
@@ -2963,6 +3970,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
         }>, Schema.Null]>;
         readonly tags: Schema.$Array<Schema.String>;
         readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+        readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+            readonly first: Schema.Struct<{
+                readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+                readonly topicId: Schema.brand<Schema.String, "TopicId">;
+                readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+                readonly importedAt: Schema.String;
+                readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                    readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                        readonly value: Schema.String;
+                        readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                    }>, Schema.Null]>;
+                    readonly sources: Schema.$Array<Schema.String>;
+                    readonly omittedSources: Schema.Finite;
+                }>, Schema.Null]>>;
+                readonly evidence: Schema.$Array<Schema.Struct<{
+                    readonly file: Schema.String;
+                    readonly row: Schema.Finite;
+                    readonly declared: Schema.Union<readonly [Schema.Struct<{
+                        readonly kind: Schema.Literal<"status_column">;
+                    }>, Schema.Struct<{
+                        readonly kind: Schema.Literal<"export_scope">;
+                        readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                    }>]>;
+                    readonly suppressionFree: Schema.Boolean;
+                    readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                }>>;
+            }>;
+            readonly latest: Schema.Struct<{
+                readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+                readonly topicId: Schema.brand<Schema.String, "TopicId">;
+                readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+                readonly importedAt: Schema.String;
+                readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                    readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                        readonly value: Schema.String;
+                        readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                    }>, Schema.Null]>;
+                    readonly sources: Schema.$Array<Schema.String>;
+                    readonly omittedSources: Schema.Finite;
+                }>, Schema.Null]>>;
+                readonly evidence: Schema.$Array<Schema.Struct<{
+                    readonly file: Schema.String;
+                    readonly row: Schema.Finite;
+                    readonly declared: Schema.Union<readonly [Schema.Struct<{
+                        readonly kind: Schema.Literal<"status_column">;
+                    }>, Schema.Struct<{
+                        readonly kind: Schema.Literal<"export_scope">;
+                        readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                    }>]>;
+                    readonly suppressionFree: Schema.Boolean;
+                    readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                    readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                }>>;
+            }>;
+        }>, Schema.Null]>;
         readonly createdAt: Schema.String;
         readonly updatedAt: Schema.String;
     }>;
@@ -3158,6 +4223,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ForbiddenError, {
@@ -3243,7 +4366,7 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
 }>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsGetActivityTimeline", "GET", "/v1/contacts/:id/activity", Schema.toCodecStringTree<Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "ContactId">;
 }>>, Schema.toCodecStringTree<Schema.Struct<{
-    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.Null]>>;
     readonly cursor: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
     readonly channel: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"email">, Schema.Null]>>;
 }>>, never, never, Schema.toCodecJson<Schema.Struct<{
@@ -3430,7 +4553,7 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
 }>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsGetGroupMemberships", "GET", "/v1/contacts/:id/groups", Schema.toCodecStringTree<Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "ContactId">;
 }>>, Schema.toCodecStringTree<Schema.Struct<{
-    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.Null]>>;
     readonly cursor: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
 }>>, never, never, Schema.toCodecJson<Schema.Struct<{
     readonly items: Schema.$Array<Schema.Struct<{
@@ -3522,8 +4645,120 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     readonly _tag: Schema.tag<"ValidationError">;
     readonly message: Schema.String;
     readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
+}>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsGetImportJob", "GET", "/v1/contacts/imports/:id", Schema.toCodecStringTree<Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "ContactImportJobId">;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "ContactImportJobId">;
+    readonly namespaceId: Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"queued">, Schema.Literal<"running">, Schema.Literal<"finalizing">, Schema.Literal<"completed">, Schema.Literal<"failed">]>;
+    readonly generation: Schema.Finite;
+    readonly counts: Schema.Struct<{
+        readonly totalRows: Schema.Finite;
+        readonly uniqueAddresses: Schema.Finite;
+        readonly subscribed: Schema.Finite;
+        readonly unsubscribed: Schema.Finite;
+        readonly suppressed: Schema.Finite;
+        readonly skipped: Schema.Finite;
+        readonly conflicts: Schema.Finite;
+        readonly created: Schema.Finite;
+        readonly existing: Schema.Finite;
+    }>;
+    readonly processedRows: Schema.Finite;
+    readonly totalRows: Schema.Finite;
+    readonly createdAt: Schema.String;
+    readonly startedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly updatedAt: Schema.String;
+    readonly completedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly failure: Schema.Union<readonly [Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+    }>, Schema.Null]>;
+    readonly resumable: Schema.Boolean;
+}>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ForbiddenError, {
+    readonly _tag: "ForbiddenError";
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ForbiddenError">;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "ForbiddenError";
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ForbiddenError">;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<GatewayTimeoutError, {
+    readonly _tag: "GatewayTimeoutError";
+    readonly message: string;
+    readonly retryAfterSeconds: number;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"GatewayTimeoutError">;
+    readonly message: Schema.String;
+    readonly retryAfterSeconds: Schema.Finite;
+}>], {
+    readonly _tag: "GatewayTimeoutError";
+    readonly message: string;
+    readonly retryAfterSeconds: number;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"GatewayTimeoutError">;
+    readonly message: Schema.String;
+    readonly retryAfterSeconds: Schema.Finite;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ResourceNotFoundError, {
+    readonly _tag: "ResourceNotFoundError";
+    readonly resource: string;
+    readonly id: string;
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ResourceNotFoundError">;
+    readonly resource: Schema.String;
+    readonly id: Schema.String;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "ResourceNotFoundError";
+    readonly resource: string;
+    readonly id: string;
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ResourceNotFoundError">;
+    readonly resource: Schema.String;
+    readonly id: Schema.String;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<UnauthorizedError, {
+    readonly _tag: "UnauthorizedError";
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"UnauthorizedError">;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "UnauthorizedError";
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"UnauthorizedError">;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ValidationError, {
+    readonly _tag: "ValidationError";
+    readonly message: string;
+    readonly fields?: {
+        readonly [x: string]: readonly string[];
+    } | null;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ValidationError">;
+    readonly message: Schema.String;
+    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
+}>], {
+    readonly _tag: "ValidationError";
+    readonly message: string;
+    readonly fields?: {
+        readonly [x: string]: readonly string[];
+    } | null;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ValidationError">;
+    readonly message: Schema.String;
+    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
 }>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsList", "GET", "/v1/contacts", never, Schema.toCodecStringTree<Schema.Struct<{
-    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.Null]>>;
     readonly cursor: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
     readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
     readonly search: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
@@ -3613,6 +4848,124 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     readonly _tag: Schema.tag<"ValidationError">;
     readonly message: Schema.String;
     readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
+}>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsPlanImport", "POST", "/v1/contacts/imports/plan", never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
+    readonly files: Schema.TupleWithRest<Schema.Tuple<readonly [Schema.Struct<{
+        readonly name: Schema.String;
+        readonly csv: Schema.String;
+        readonly evidence: Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"status_column">;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"export_scope">;
+            readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+        }>]>;
+        readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+    }>]>, readonly [Schema.Struct<{
+        readonly name: Schema.String;
+        readonly csv: Schema.String;
+        readonly evidence: Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"status_column">;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"export_scope">;
+            readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+        }>]>;
+        readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+    }>]>;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly planHash: Schema.String;
+    readonly presetVersion: Schema.String;
+    readonly namespaceId: Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly canStart: Schema.Boolean;
+    readonly counts: Schema.Struct<{
+        readonly totalRows: Schema.Finite;
+        readonly uniqueAddresses: Schema.Finite;
+        readonly subscribed: Schema.Finite;
+        readonly unsubscribed: Schema.Finite;
+        readonly suppressed: Schema.Finite;
+        readonly skipped: Schema.Finite;
+        readonly conflicts: Schema.Finite;
+        readonly created: Schema.Finite;
+        readonly existing: Schema.Finite;
+    }>;
+    readonly diagnostics: Schema.$Array<Schema.Struct<{
+        readonly file: Schema.String;
+        readonly row: Schema.Finite;
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly email: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+    }>>;
+    readonly diagnosticsTruncated: Schema.Boolean;
+}>>, Schema.toCodecJson<Schema.Union<readonly [typeof ForbiddenError, typeof FlagDisabledError]> | Schema.decodeTo<Schema.declareConstructor<GatewayTimeoutError, {
+    readonly _tag: "GatewayTimeoutError";
+    readonly message: string;
+    readonly retryAfterSeconds: number;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"GatewayTimeoutError">;
+    readonly message: Schema.String;
+    readonly retryAfterSeconds: Schema.Finite;
+}>], {
+    readonly _tag: "GatewayTimeoutError";
+    readonly message: string;
+    readonly retryAfterSeconds: number;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"GatewayTimeoutError">;
+    readonly message: Schema.String;
+    readonly retryAfterSeconds: Schema.Finite;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ResourceNotFoundError, {
+    readonly _tag: "ResourceNotFoundError";
+    readonly resource: string;
+    readonly id: string;
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ResourceNotFoundError">;
+    readonly resource: Schema.String;
+    readonly id: Schema.String;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "ResourceNotFoundError";
+    readonly resource: string;
+    readonly id: string;
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ResourceNotFoundError">;
+    readonly resource: Schema.String;
+    readonly id: Schema.String;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<UnauthorizedError, {
+    readonly _tag: "UnauthorizedError";
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"UnauthorizedError">;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "UnauthorizedError";
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"UnauthorizedError">;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ValidationError, {
+    readonly _tag: "ValidationError";
+    readonly message: string;
+    readonly fields?: {
+        readonly [x: string]: readonly string[];
+    } | null;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ValidationError">;
+    readonly message: Schema.String;
+    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
+}>], {
+    readonly _tag: "ValidationError";
+    readonly message: string;
+    readonly fields?: {
+        readonly [x: string]: readonly string[];
+    } | null;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ValidationError">;
+    readonly message: Schema.String;
+    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
 }>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsRemove", "DELETE", "/v1/contacts/:id", Schema.toCodecStringTree<Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "ContactId">;
 }>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
@@ -3765,6 +5118,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ForbiddenError, {
@@ -3904,6 +5315,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ForbiddenError, {
@@ -4048,6 +5517,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<ForbiddenError, {
@@ -4130,6 +5657,194 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     readonly _tag: Schema.tag<"ValidationError">;
     readonly message: Schema.String;
     readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
+}>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsStartImport", "POST", "/v1/contacts/imports", never, never, Schema.toCodecJson<Schema.Union<readonly [Schema.Struct<{
+    readonly mode: Schema.Literal<"new">;
+    readonly input: Schema.Struct<{
+        readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+        readonly topicId: Schema.brand<Schema.String, "TopicId">;
+        readonly namespaceId: Schema.optionalKey<Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>>;
+        readonly files: Schema.TupleWithRest<Schema.Tuple<readonly [Schema.Struct<{
+            readonly name: Schema.String;
+            readonly csv: Schema.String;
+            readonly evidence: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"status_column">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"export_scope">;
+                readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+            }>]>;
+            readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+        }>]>, readonly [Schema.Struct<{
+            readonly name: Schema.String;
+            readonly csv: Schema.String;
+            readonly evidence: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"status_column">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"export_scope">;
+                readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+            }>]>;
+            readonly suppressionFree: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.Null]>>;
+        }>]>;
+    }>;
+    readonly planHash: Schema.String;
+    readonly idempotencyKey: Schema.String;
+}>, Schema.Struct<{
+    readonly mode: Schema.Literal<"resume">;
+    readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+    readonly expectedGeneration: Schema.Finite;
+}>]>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "ContactImportJobId">;
+    readonly namespaceId: Schema.Union<readonly [Schema.brand<Schema.String, "NamespaceId">, Schema.Null]>;
+    readonly topicId: Schema.brand<Schema.String, "TopicId">;
+    readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"queued">, Schema.Literal<"running">, Schema.Literal<"finalizing">, Schema.Literal<"completed">, Schema.Literal<"failed">]>;
+    readonly generation: Schema.Finite;
+    readonly counts: Schema.Struct<{
+        readonly totalRows: Schema.Finite;
+        readonly uniqueAddresses: Schema.Finite;
+        readonly subscribed: Schema.Finite;
+        readonly unsubscribed: Schema.Finite;
+        readonly suppressed: Schema.Finite;
+        readonly skipped: Schema.Finite;
+        readonly conflicts: Schema.Finite;
+        readonly created: Schema.Finite;
+        readonly existing: Schema.Finite;
+    }>;
+    readonly processedRows: Schema.Finite;
+    readonly totalRows: Schema.Finite;
+    readonly createdAt: Schema.String;
+    readonly startedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly updatedAt: Schema.String;
+    readonly completedAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+    readonly failure: Schema.Union<readonly [Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+    }>, Schema.Null]>;
+    readonly resumable: Schema.Boolean;
+}>>, Schema.toCodecJson<Schema.Union<readonly [typeof ForbiddenError, typeof FlagDisabledError]> | Schema.decodeTo<Schema.declareConstructor<BillingProviderError, {
+    readonly _tag: "BillingProviderError";
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"BillingProviderError">;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "BillingProviderError";
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"BillingProviderError">;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ConflictError, {
+    readonly _tag: "ConflictError";
+    readonly message: string;
+    readonly resource: string;
+    readonly id?: string | null;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ConflictError">;
+    readonly message: Schema.String;
+    readonly resource: Schema.String;
+    readonly id: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+}>], {
+    readonly _tag: "ConflictError";
+    readonly message: string;
+    readonly resource: string;
+    readonly id?: string | null;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ConflictError">;
+    readonly message: Schema.String;
+    readonly resource: Schema.String;
+    readonly id: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Null]>>;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<GatewayTimeoutError, {
+    readonly _tag: "GatewayTimeoutError";
+    readonly message: string;
+    readonly retryAfterSeconds: number;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"GatewayTimeoutError">;
+    readonly message: Schema.String;
+    readonly retryAfterSeconds: Schema.Finite;
+}>], {
+    readonly _tag: "GatewayTimeoutError";
+    readonly message: string;
+    readonly retryAfterSeconds: number;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"GatewayTimeoutError">;
+    readonly message: Schema.String;
+    readonly retryAfterSeconds: Schema.Finite;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<PaymentRequiredError, {
+    readonly _tag: "PaymentRequiredError";
+    readonly message: string;
+    readonly resource: string;
+    readonly currentUsage: number;
+    readonly limit: number;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"PaymentRequiredError">;
+    readonly message: Schema.String;
+    readonly resource: Schema.String;
+    readonly currentUsage: Schema.Finite;
+    readonly limit: Schema.Finite;
+}>], {
+    readonly _tag: "PaymentRequiredError";
+    readonly message: string;
+    readonly resource: string;
+    readonly currentUsage: number;
+    readonly limit: number;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"PaymentRequiredError">;
+    readonly message: Schema.String;
+    readonly resource: Schema.String;
+    readonly currentUsage: Schema.Finite;
+    readonly limit: Schema.Finite;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ResourceNotFoundError, {
+    readonly _tag: "ResourceNotFoundError";
+    readonly resource: string;
+    readonly id: string;
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ResourceNotFoundError">;
+    readonly resource: Schema.String;
+    readonly id: Schema.String;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "ResourceNotFoundError";
+    readonly resource: string;
+    readonly id: string;
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ResourceNotFoundError">;
+    readonly resource: Schema.String;
+    readonly id: Schema.String;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<UnauthorizedError, {
+    readonly _tag: "UnauthorizedError";
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"UnauthorizedError">;
+    readonly message: Schema.String;
+}>], {
+    readonly _tag: "UnauthorizedError";
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"UnauthorizedError">;
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<ValidationError, {
+    readonly _tag: "ValidationError";
+    readonly message: string;
+    readonly fields?: {
+        readonly [x: string]: readonly string[];
+    } | null;
+}, readonly [Schema.Struct<{
+    readonly _tag: Schema.tag<"ValidationError">;
+    readonly message: Schema.String;
+    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
+}>], {
+    readonly _tag: "ValidationError";
+    readonly message: string;
+    readonly fields?: {
+        readonly [x: string]: readonly string[];
+    } | null;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"ValidationError">;
+    readonly message: Schema.String;
+    readonly fields: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.$Array<Schema.String>>, Schema.Null]>>;
 }>, never, never> | typeof InternalError>, ApiKeySecurityMiddleware, never> | HttpApiEndpoint.HttpApiEndpoint<"contactsUpdate", "PATCH", "/v1/contacts/:id", Schema.toCodecStringTree<Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "ContactId">;
 }>>, never, Schema.toCodecJson<Schema.Struct<{
@@ -4218,6 +5933,64 @@ declare const ContactsGroup_base: HttpApiGroup.HttpApiGroup<"Contacts", HttpApiE
     }>, Schema.Null]>;
     readonly tags: Schema.$Array<Schema.String>;
     readonly metadata: Schema.Union<readonly [Schema.$Record<Schema.String, Schema.suspend<Schema.Codec<import("./shared").JsonValue, import("./shared").JsonValue, never, never>>>, Schema.Null]>;
+    readonly importProvenance: Schema.Union<readonly [Schema.Struct<{
+        readonly first: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+        readonly latest: Schema.Struct<{
+            readonly jobId: Schema.brand<Schema.String, "ContactImportJobId">;
+            readonly topicId: Schema.brand<Schema.String, "TopicId">;
+            readonly preset: Schema.Union<readonly [Schema.Literal<"beehiiv">, Schema.Literal<"substack">, Schema.Literal<"kit">, Schema.Literal<"mailchimp">]>;
+            readonly importedAt: Schema.String;
+            readonly summary: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+                readonly signupAt: Schema.Union<readonly [Schema.Struct<{
+                    readonly value: Schema.String;
+                    readonly kind: Schema.Union<readonly [Schema.Literal<"time">, Schema.Literal<"text">]>;
+                }>, Schema.Null]>;
+                readonly sources: Schema.$Array<Schema.String>;
+                readonly omittedSources: Schema.Finite;
+            }>, Schema.Null]>>;
+            readonly evidence: Schema.$Array<Schema.Struct<{
+                readonly file: Schema.String;
+                readonly row: Schema.Finite;
+                readonly declared: Schema.Union<readonly [Schema.Struct<{
+                    readonly kind: Schema.Literal<"status_column">;
+                }>, Schema.Struct<{
+                    readonly kind: Schema.Literal<"export_scope">;
+                    readonly scope: Schema.Union<readonly [Schema.Literal<"subscribed">, Schema.Literal<"unsubscribed">, Schema.Literal<"suppressed">, Schema.Literal<"cleaned/bounced">]>;
+                }>]>;
+                readonly suppressionFree: Schema.Boolean;
+                readonly sourceStatus: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly signupAt: Schema.Union<readonly [Schema.String, Schema.Null]>;
+                readonly source: Schema.Union<readonly [Schema.String, Schema.Null]>;
+            }>>;
+        }>;
+    }>, Schema.Null]>;
     readonly createdAt: Schema.String;
     readonly updatedAt: Schema.String;
 }>>, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<BillingProviderError, {