samva 0.26.0 → 0.28.0

package/dist/effect/generated/contacts.js

@@ -1,4 +1,4 @@
-import { ApiKeySecurityMiddleware, BillingProviderError, ConflictError, ContactGroupId, ContactId, ContactIdentity, ContactIdentityId, ConversationId, Cursor, ForbiddenError, GatewayTimeoutError, InternalError, JsonObject, MessageId, NamespaceId, PaymentRequiredError, ResourceNotFoundError, UnauthorizedError, ValidationError } from "./shared.js";
+import { ApiKeySecurityMiddleware, BillingProviderError, ConflictError, ContactGroupId, ContactId, ContactIdentity, ContactIdentityId, ConversationId, Cursor, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, JsonObject, MessageId, NamespaceId, PaymentRequiredError, ResourceNotFoundError, TopicId, UnauthorizedError, ValidationError } from "./shared.js";
 import { HttpApiEndpoint, HttpApiGroup, HttpApiSchema, OpenApi } from "effect/http-api";
 import * as Schema from "effect/Schema";
 //#region src/effect/generated/contacts.ts
@@ -31,6 +31,10 @@ const ContactPreferences = /* @__PURE__ */ Schema.Struct({
 		}), Schema.Null]))
 	}), Schema.Null]))
 }).annotate({ identifier: "ContactPreferences" });
+const ContactImportJobId = /* @__PURE__ */ Schema.String.check(Schema.isPattern(/* @__PURE__ */ new RegExp("^cimport_[0-9a-hjkmnp-tv-z]{16,24}$", "u")).annotate({
+	expected: "a string matching the RegExp ^cimport_[0-9a-hjkmnp-tv-z]{16,24}$",
+	identifier: "ContactImportJobId"
+})).pipe(Schema.brand("ContactImportJobId"));
 const BulkUpdateResult = /* @__PURE__ */ Schema.Struct({
 	updated: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
 	failed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
@@ -156,11 +160,85 @@ const Contact = /* @__PURE__ */ Schema.Struct({
 	preferences: Schema.Union([ContactPreferences, Schema.Null]),
 	tags: Schema.Array(Schema.String),
 	metadata: Schema.Union([JsonObject, Schema.Null]),
+	importProvenance: Schema.Union([Schema.Struct({
+		first: Schema.Struct({
+			jobId: ContactImportJobId,
+			topicId: TopicId,
+			preset: Schema.Union([
+				Schema.Literal("beehiiv"),
+				Schema.Literal("substack"),
+				Schema.Literal("kit"),
+				Schema.Literal("mailchimp")
+			]),
+			importedAt: Schema.String,
+			summary: Schema.optionalKey(Schema.Union([Schema.Struct({
+				signupAt: Schema.Union([Schema.Struct({
+					value: Schema.String.check(Schema.isMaxCodePoints(160).annotate({ expected: "a string with at most 160 code points" })).check(Schema.isMaxLength(160).annotate({ expected: "a value with a length of at most 160" })),
+					kind: Schema.Union([Schema.Literal("time"), Schema.Literal("text")])
+				}), Schema.Null]),
+				sources: Schema.Array(Schema.String.check(Schema.isMaxCodePoints(160).annotate({ expected: "a string with at most 160 code points" })).check(Schema.isMaxLength(160).annotate({ expected: "a value with a length of at most 160" }))).check(Schema.isMaxLength(8).annotate({ expected: "a value with a length of at most 8" })),
+				omittedSources: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
+			}), Schema.Null])),
+			evidence: Schema.Array(Schema.Struct({
+				file: Schema.String,
+				row: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(-9007199254740991).annotate({ expected: "a value greater than or equal to -9007199254740991" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+				declared: Schema.Union([Schema.Struct({ kind: Schema.Literal("status_column") }), Schema.Struct({
+					kind: Schema.Literal("export_scope"),
+					scope: Schema.Union([
+						Schema.Literal("subscribed"),
+						Schema.Literal("unsubscribed"),
+						Schema.Literal("suppressed"),
+						Schema.Literal("cleaned/bounced")
+					])
+				})]),
+				suppressionFree: Schema.Boolean,
+				sourceStatus: Schema.Union([Schema.String, Schema.Null]),
+				signupAt: Schema.Union([Schema.String, Schema.Null]),
+				source: Schema.Union([Schema.String, Schema.Null])
+			}))
+		}),
+		latest: Schema.Struct({
+			jobId: ContactImportJobId,
+			topicId: TopicId,
+			preset: Schema.Union([
+				Schema.Literal("beehiiv"),
+				Schema.Literal("substack"),
+				Schema.Literal("kit"),
+				Schema.Literal("mailchimp")
+			]),
+			importedAt: Schema.String,
+			summary: Schema.optionalKey(Schema.Union([Schema.Struct({
+				signupAt: Schema.Union([Schema.Struct({
+					value: Schema.String.check(Schema.isMaxCodePoints(160).annotate({ expected: "a string with at most 160 code points" })).check(Schema.isMaxLength(160).annotate({ expected: "a value with a length of at most 160" })),
+					kind: Schema.Union([Schema.Literal("time"), Schema.Literal("text")])
+				}), Schema.Null]),
+				sources: Schema.Array(Schema.String.check(Schema.isMaxCodePoints(160).annotate({ expected: "a string with at most 160 code points" })).check(Schema.isMaxLength(160).annotate({ expected: "a value with a length of at most 160" }))).check(Schema.isMaxLength(8).annotate({ expected: "a value with a length of at most 8" })),
+				omittedSources: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
+			}), Schema.Null])),
+			evidence: Schema.Array(Schema.Struct({
+				file: Schema.String,
+				row: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(-9007199254740991).annotate({ expected: "a value greater than or equal to -9007199254740991" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+				declared: Schema.Union([Schema.Struct({ kind: Schema.Literal("status_column") }), Schema.Struct({
+					kind: Schema.Literal("export_scope"),
+					scope: Schema.Union([
+						Schema.Literal("subscribed"),
+						Schema.Literal("unsubscribed"),
+						Schema.Literal("suppressed"),
+						Schema.Literal("cleaned/bounced")
+					])
+				})]),
+				suppressionFree: Schema.Boolean,
+				sourceStatus: Schema.Union([Schema.String, Schema.Null]),
+				signupAt: Schema.Union([Schema.String, Schema.Null]),
+				source: Schema.Union([Schema.String, Schema.Null])
+			}))
+		})
+	}), Schema.Null]),
 	createdAt: Schema.String,
 	updatedAt: Schema.String
 }).annotate({ identifier: "Contact" });
 const ContactsListQuery = /* @__PURE__ */ Schema.Struct({
-	limit: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+	limit: Schema.optionalKey(Schema.Union([Schema.Finite.annotate({ description: "Items per page, at most 100." }).check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isLessThanOrEqualTo(100).annotate({ expected: "a value less than or equal to 100" })).check(Schema.isGreaterThan(0).annotate({ expected: "a value greater than 0" })), Schema.Null])),
 	cursor: Schema.optionalKey(Schema.Union([Cursor, Schema.Null])),
 	namespaceId: Schema.optionalKey(Schema.Union([NamespaceId, Schema.Null])),
 	search: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
@@ -256,7 +334,7 @@ const ContactsUpdate502 = BillingProviderError;
 const ContactsUpdate504 = GatewayTimeoutError;
 const ContactsGetActivityTimelinePathParams = /* @__PURE__ */ Schema.Struct({ id: ContactId });
 const ContactsGetActivityTimelineQuery = /* @__PURE__ */ Schema.Struct({
-	limit: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+	limit: Schema.optionalKey(Schema.Union([Schema.Finite.annotate({ description: "Items per page, at most 100." }).check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isLessThanOrEqualTo(100).annotate({ expected: "a value less than or equal to 100" })).check(Schema.isGreaterThan(0).annotate({ expected: "a value greater than 0" })), Schema.Null])),
 	cursor: Schema.optionalKey(Schema.Union([Cursor, Schema.Null])),
 	channel: Schema.optionalKey(Schema.Union([Schema.Literal("email"), Schema.Null]))
 });
@@ -284,7 +362,7 @@ const ContactsGetEngagement500 = InternalError;
 const ContactsGetEngagement504 = GatewayTimeoutError;
 const ContactsGetGroupMembershipsPathParams = /* @__PURE__ */ Schema.Struct({ id: ContactId });
 const ContactsGetGroupMembershipsQuery = /* @__PURE__ */ Schema.Struct({
-	limit: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),
+	limit: Schema.optionalKey(Schema.Union([Schema.Finite.annotate({ description: "Items per page, at most 100." }).check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isLessThanOrEqualTo(100).annotate({ expected: "a value less than or equal to 100" })).check(Schema.isGreaterThan(0).annotate({ expected: "a value greater than 0" })), Schema.Null])),
 	cursor: Schema.optionalKey(Schema.Union([Cursor, Schema.Null]))
 });
 const ContactsGetGroupMemberships200 = ContactGroupMembershipPage;
@@ -355,7 +433,7 @@ const ContactsRemoveTags404 = ResourceNotFoundError;
 const ContactsRemoveTags422 = ValidationError;
 const ContactsRemoveTags500 = InternalError;
 const ContactsRemoveTags504 = GatewayTimeoutError;
-const ContactsBulkDeleteRequestJson = /* @__PURE__ */ Schema.Struct({ ids: Schema.TupleWithRest(Schema.Tuple([ContactId]), [ContactId]) });
+const ContactsBulkDeleteRequestJson = /* @__PURE__ */ Schema.Struct({ ids: Schema.TupleWithRest(Schema.Tuple([ContactId]), [ContactId]).check(Schema.isMaxLength(1e3).annotate({ expected: "a value with a length of at most 1000" })) });
 const ContactsBulkDelete200 = /* @__PURE__ */ Schema.Struct({
 	deleted: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
 	failed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
@@ -366,56 +444,8 @@ const ContactsBulkDelete422 = ValidationError;
 const ContactsBulkDelete500 = InternalError;
 const ContactsBulkDelete502 = BillingProviderError;
 const ContactsBulkDelete504 = GatewayTimeoutError;
-const ContactsBulkImportRequestJson = /* @__PURE__ */ Schema.Struct({
-	namespaceId: Schema.optionalKey(Schema.Union([NamespaceId, Schema.Null])),
-	contacts: Schema.Array(Schema.Struct({
-		name: Schema.String,
-		displayName: Schema.optionalKey(Schema.Union([Schema.Union([Schema.String, Schema.Null]), Schema.Null])),
-		avatar: Schema.optionalKey(Schema.Union([Schema.Union([Schema.String, Schema.Null]), Schema.Null])),
-		identities: Schema.optionalKey(Schema.Union([Schema.Array(ContactIdentityInput), Schema.Null])),
-		profile: Schema.optionalKey(Schema.Union([Schema.Union([ContactProfile, Schema.Null]), Schema.Null])),
-		preferences: Schema.optionalKey(Schema.Union([Schema.Union([ContactPreferences, Schema.Null]), Schema.Null])),
-		tags: Schema.optionalKey(Schema.Union([Schema.Array(Schema.String), Schema.Null])),
-		status: Schema.optionalKey(Schema.Union([Schema.Union([
-			Schema.Literal("active"),
-			Schema.Literal("paused"),
-			Schema.Literal("blocked"),
-			Schema.Literal("archived")
-		]), Schema.Null])),
-		statusReason: Schema.optionalKey(Schema.Union([Schema.Union([Schema.String, Schema.Null]), Schema.Null])),
-		externalId: Schema.optionalKey(Schema.Union([Schema.Union([Schema.String, Schema.Null]), Schema.Null])),
-		metadata: Schema.optionalKey(Schema.Union([Schema.Union([JsonObject, Schema.Null]), Schema.Null]))
-	})),
-	onConflict: Schema.optionalKey(Schema.Union([Schema.Union([Schema.Literal("skip"), Schema.Literal("update")]), Schema.Null]))
-});
-const ContactsBulkImport200 = /* @__PURE__ */ Schema.Struct({
-	total: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
-	created: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
-	updated: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
-	skipped: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
-	errors: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
-	results: Schema.Array(Schema.Struct({
-		index: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
-		status: Schema.Union([
-			Schema.Literal("created"),
-			Schema.Literal("updated"),
-			Schema.Literal("skipped"),
-			Schema.Literal("error")
-		]),
-		contactId: Schema.optionalKey(Schema.Union([ContactId, Schema.Null])),
-		error: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null]))
-	}))
-});
-const ContactsBulkImport401 = UnauthorizedError;
-const ContactsBulkImport402 = PaymentRequiredError;
-const ContactsBulkImport403 = ForbiddenError;
-const ContactsBulkImport404 = ResourceNotFoundError;
-const ContactsBulkImport422 = ValidationError;
-const ContactsBulkImport500 = InternalError;
-const ContactsBulkImport502 = BillingProviderError;
-const ContactsBulkImport504 = GatewayTimeoutError;
 const ContactsBulkUpdateStatusRequestJson = /* @__PURE__ */ Schema.Struct({
-	ids: Schema.TupleWithRest(Schema.Tuple([ContactId]), [ContactId]),
+	ids: Schema.TupleWithRest(Schema.Tuple([ContactId]), [ContactId]).check(Schema.isMaxLength(1e3).annotate({ expected: "a value with a length of at most 1000" })),
 	status: Schema.Union([
 		Schema.Literal("active"),
 		Schema.Literal("paused"),
@@ -432,7 +462,7 @@ const ContactsBulkUpdateStatus500 = InternalError;
 const ContactsBulkUpdateStatus502 = BillingProviderError;
 const ContactsBulkUpdateStatus504 = GatewayTimeoutError;
 const ContactsBulkUpdateTagsRequestJson = /* @__PURE__ */ Schema.Struct({
-	ids: Schema.TupleWithRest(Schema.Tuple([ContactId]), [ContactId]),
+	ids: Schema.TupleWithRest(Schema.Tuple([ContactId]), [ContactId]).check(Schema.isMaxLength(1e3).annotate({ expected: "a value with a length of at most 1000" })),
 	operation: Schema.Union([
 		Schema.Literal("add"),
 		Schema.Literal("remove"),
@@ -447,7 +477,7 @@ const ContactsBulkUpdateTags422 = ValidationError;
 const ContactsBulkUpdateTags500 = InternalError;
 const ContactsBulkUpdateTags504 = GatewayTimeoutError;
 const ContactsExportRequestJson = /* @__PURE__ */ Schema.Struct({
-	ids: Schema.optionalKey(Schema.Union([Schema.Array(ContactId), Schema.Null])),
+	ids: Schema.optionalKey(Schema.Union([Schema.Array(ContactId).check(Schema.isMaxLength(1e3).annotate({ expected: "a value with a length of at most 1000" })), Schema.Null])),
 	format: Schema.optionalKey(Schema.Union([Schema.Union([Schema.Literal("json"), Schema.Literal("csv")]), Schema.Null])),
 	filters: Schema.optionalKey(Schema.Union([Schema.Struct({
 		status: Schema.optionalKey(Schema.Union([Schema.Union([
@@ -509,6 +539,221 @@ const ContactsFindOrCreate422 = ValidationError;
 const ContactsFindOrCreate500 = InternalError;
 const ContactsFindOrCreate502 = BillingProviderError;
 const ContactsFindOrCreate504 = GatewayTimeoutError;
+const ContactsStartImportRequestJson = /* @__PURE__ */ Schema.Union([Schema.Struct({
+	mode: Schema.Literal("new"),
+	input: Schema.Struct({
+		preset: Schema.Union([
+			Schema.Literal("beehiiv"),
+			Schema.Literal("substack"),
+			Schema.Literal("kit"),
+			Schema.Literal("mailchimp")
+		]),
+		topicId: TopicId,
+		namespaceId: Schema.optionalKey(Schema.Union([NamespaceId, Schema.Null])),
+		files: Schema.TupleWithRest(Schema.Tuple([Schema.Struct({
+			name: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })).check(Schema.isMaxCodePoints(255).annotate({ expected: "a string with at most 255 code points" })).check(Schema.isBetweenLength(1, 255).annotate({ expected: "a value with a length between 1 and 255" })),
+			csv: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })),
+			evidence: Schema.Union([Schema.Struct({ kind: Schema.Literal("status_column") }), Schema.Struct({
+				kind: Schema.Literal("export_scope"),
+				scope: Schema.Union([
+					Schema.Literal("subscribed"),
+					Schema.Literal("unsubscribed"),
+					Schema.Literal("suppressed"),
+					Schema.Literal("cleaned/bounced")
+				])
+			})]),
+			suppressionFree: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null]).annotate({ description: "The operator declares this beehiiv export was filtered to Suppression does not exist." }))
+		})]), [Schema.Struct({
+			name: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })).check(Schema.isMaxCodePoints(255).annotate({ expected: "a string with at most 255 code points" })).check(Schema.isBetweenLength(1, 255).annotate({ expected: "a value with a length between 1 and 255" })),
+			csv: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })),
+			evidence: Schema.Union([Schema.Struct({ kind: Schema.Literal("status_column") }), Schema.Struct({
+				kind: Schema.Literal("export_scope"),
+				scope: Schema.Union([
+					Schema.Literal("subscribed"),
+					Schema.Literal("unsubscribed"),
+					Schema.Literal("suppressed"),
+					Schema.Literal("cleaned/bounced")
+				])
+			})]),
+			suppressionFree: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null]).annotate({ description: "The operator declares this beehiiv export was filtered to Suppression does not exist." }))
+		})]).check(Schema.isMaxLength(20).annotate({ expected: "a value with a length of at most 20" }))
+	}),
+	planHash: Schema.String,
+	idempotencyKey: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })).check(Schema.isMaxCodePoints(255).annotate({ expected: "a string with at most 255 code points" })).check(Schema.isBetweenLength(1, 255).annotate({ expected: "a value with a length between 1 and 255" }))
+}), Schema.Struct({
+	mode: Schema.Literal("resume"),
+	jobId: ContactImportJobId,
+	expectedGeneration: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
+})]);
+const ContactsStartImport202 = /* @__PURE__ */ Schema.Struct({
+	id: ContactImportJobId,
+	namespaceId: Schema.Union([NamespaceId, Schema.Null]),
+	topicId: TopicId,
+	preset: Schema.Union([
+		Schema.Literal("beehiiv"),
+		Schema.Literal("substack"),
+		Schema.Literal("kit"),
+		Schema.Literal("mailchimp")
+	]),
+	status: Schema.Union([
+		Schema.Literal("queued"),
+		Schema.Literal("running"),
+		Schema.Literal("finalizing"),
+		Schema.Literal("completed"),
+		Schema.Literal("failed")
+	]),
+	generation: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+	counts: Schema.Struct({
+		totalRows: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		uniqueAddresses: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		subscribed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		unsubscribed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		suppressed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		skipped: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		conflicts: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		created: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		existing: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
+	}),
+	processedRows: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+	totalRows: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+	createdAt: Schema.String,
+	startedAt: Schema.Union([Schema.String, Schema.Null]),
+	updatedAt: Schema.String,
+	completedAt: Schema.Union([Schema.String, Schema.Null]),
+	failure: Schema.Union([Schema.Struct({
+		code: Schema.String,
+		message: Schema.String,
+		retryable: Schema.Boolean
+	}), Schema.Null]),
+	resumable: Schema.Boolean
+});
+const ContactsStartImport401 = UnauthorizedError;
+const ContactsStartImport402 = PaymentRequiredError;
+const ContactsStartImport403 = /* @__PURE__ */ Schema.Union([ForbiddenError, FlagDisabledError]);
+const ContactsStartImport404 = ResourceNotFoundError;
+const ContactsStartImport409 = ConflictError;
+const ContactsStartImport422 = ValidationError;
+const ContactsStartImport500 = InternalError;
+const ContactsStartImport502 = BillingProviderError;
+const ContactsStartImport504 = GatewayTimeoutError;
+const ContactsGetImportJobPathParams = /* @__PURE__ */ Schema.Struct({ id: ContactImportJobId });
+const ContactsGetImportJob200 = /* @__PURE__ */ Schema.Struct({
+	id: ContactImportJobId,
+	namespaceId: Schema.Union([NamespaceId, Schema.Null]),
+	topicId: TopicId,
+	preset: Schema.Union([
+		Schema.Literal("beehiiv"),
+		Schema.Literal("substack"),
+		Schema.Literal("kit"),
+		Schema.Literal("mailchimp")
+	]),
+	status: Schema.Union([
+		Schema.Literal("queued"),
+		Schema.Literal("running"),
+		Schema.Literal("finalizing"),
+		Schema.Literal("completed"),
+		Schema.Literal("failed")
+	]),
+	generation: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+	counts: Schema.Struct({
+		totalRows: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		uniqueAddresses: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		subscribed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		unsubscribed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		suppressed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		skipped: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		conflicts: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		created: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		existing: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
+	}),
+	processedRows: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+	totalRows: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+	createdAt: Schema.String,
+	startedAt: Schema.Union([Schema.String, Schema.Null]),
+	updatedAt: Schema.String,
+	completedAt: Schema.Union([Schema.String, Schema.Null]),
+	failure: Schema.Union([Schema.Struct({
+		code: Schema.String,
+		message: Schema.String,
+		retryable: Schema.Boolean
+	}), Schema.Null]),
+	resumable: Schema.Boolean
+});
+const ContactsGetImportJob401 = UnauthorizedError;
+const ContactsGetImportJob403 = ForbiddenError;
+const ContactsGetImportJob404 = ResourceNotFoundError;
+const ContactsGetImportJob422 = ValidationError;
+const ContactsGetImportJob500 = InternalError;
+const ContactsGetImportJob504 = GatewayTimeoutError;
+const ContactsPlanImportRequestJson = /* @__PURE__ */ Schema.Struct({
+	preset: Schema.Union([
+		Schema.Literal("beehiiv"),
+		Schema.Literal("substack"),
+		Schema.Literal("kit"),
+		Schema.Literal("mailchimp")
+	]),
+	topicId: TopicId,
+	namespaceId: Schema.optionalKey(Schema.Union([NamespaceId, Schema.Null])),
+	files: Schema.TupleWithRest(Schema.Tuple([Schema.Struct({
+		name: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })).check(Schema.isMaxCodePoints(255).annotate({ expected: "a string with at most 255 code points" })).check(Schema.isBetweenLength(1, 255).annotate({ expected: "a value with a length between 1 and 255" })),
+		csv: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })),
+		evidence: Schema.Union([Schema.Struct({ kind: Schema.Literal("status_column") }), Schema.Struct({
+			kind: Schema.Literal("export_scope"),
+			scope: Schema.Union([
+				Schema.Literal("subscribed"),
+				Schema.Literal("unsubscribed"),
+				Schema.Literal("suppressed"),
+				Schema.Literal("cleaned/bounced")
+			])
+		})]),
+		suppressionFree: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null]).annotate({ description: "The operator declares this beehiiv export was filtered to Suppression does not exist." }))
+	})]), [Schema.Struct({
+		name: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })).check(Schema.isMaxCodePoints(255).annotate({ expected: "a string with at most 255 code points" })).check(Schema.isBetweenLength(1, 255).annotate({ expected: "a value with a length between 1 and 255" })),
+		csv: Schema.String.check(Schema.isMinLength(1).annotate({ expected: "a value with a length of at least 1" })),
+		evidence: Schema.Union([Schema.Struct({ kind: Schema.Literal("status_column") }), Schema.Struct({
+			kind: Schema.Literal("export_scope"),
+			scope: Schema.Union([
+				Schema.Literal("subscribed"),
+				Schema.Literal("unsubscribed"),
+				Schema.Literal("suppressed"),
+				Schema.Literal("cleaned/bounced")
+			])
+		})]),
+		suppressionFree: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Null]).annotate({ description: "The operator declares this beehiiv export was filtered to Suppression does not exist." }))
+	})]).check(Schema.isMaxLength(20).annotate({ expected: "a value with a length of at most 20" }))
+});
+const ContactsPlanImport200 = /* @__PURE__ */ Schema.Struct({
+	planHash: Schema.String,
+	presetVersion: Schema.String,
+	namespaceId: Schema.Union([NamespaceId, Schema.Null]),
+	topicId: TopicId,
+	canStart: Schema.Boolean,
+	counts: Schema.Struct({
+		totalRows: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		uniqueAddresses: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		subscribed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		unsubscribed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		suppressed: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		skipped: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		conflicts: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		created: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		existing: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(0).annotate({ expected: "a value greater than or equal to 0" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" }))
+	}),
+	diagnostics: Schema.Array(Schema.Struct({
+		file: Schema.String,
+		row: Schema.Finite.check(Schema.isInt().annotate({ expected: "an integer" })).check(Schema.isGreaterThanOrEqualTo(-9007199254740991).annotate({ expected: "a value greater than or equal to -9007199254740991" })).check(Schema.isLessThanOrEqualTo(9007199254740991).annotate({ expected: "a value less than or equal to 9007199254740991" })),
+		code: Schema.String,
+		message: Schema.String,
+		email: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null]))
+	})),
+	diagnosticsTruncated: Schema.Boolean
+});
+const ContactsPlanImport401 = UnauthorizedError;
+const ContactsPlanImport403 = /* @__PURE__ */ Schema.Union([ForbiddenError, FlagDisabledError]);
+const ContactsPlanImport404 = ResourceNotFoundError;
+const ContactsPlanImport422 = ValidationError;
+const ContactsPlanImport500 = InternalError;
+const ContactsPlanImport504 = GatewayTimeoutError;
 var ContactsGroup = class extends HttpApiGroup.make("Contacts").add(HttpApiEndpoint.get("contactsList", "/v1/contacts", {
 	query: ContactsListQuery,
 	success: ContactsList200,
@@ -676,20 +921,7 @@ var ContactsGroup = class extends HttpApiGroup.make("Contacts").add(HttpApiEndpo
 		ContactsBulkDelete502.pipe(HttpApiSchema.status(502)),
 		ContactsBulkDelete504.pipe(HttpApiSchema.status(504))
 	]
-}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.bulkDelete").annotate(OpenApi.Summary, "Bulk delete contacts").annotate(OpenApi.Description, "Permanently deletes multiple contacts by ID, returning counts of deleted and failed records."), HttpApiEndpoint.post("contactsBulkImport", "/v1/contacts/bulk-import", {
-	payload: ContactsBulkImportRequestJson,
-	success: ContactsBulkImport200,
-	error: [
-		ContactsBulkImport401.pipe(HttpApiSchema.status(401)),
-		ContactsBulkImport402.pipe(HttpApiSchema.status(402)),
-		ContactsBulkImport403.pipe(HttpApiSchema.status(403)),
-		ContactsBulkImport404.pipe(HttpApiSchema.status(404)),
-		ContactsBulkImport422.pipe(HttpApiSchema.status(422)),
-		ContactsBulkImport500,
-		ContactsBulkImport502.pipe(HttpApiSchema.status(502)),
-		ContactsBulkImport504.pipe(HttpApiSchema.status(504))
-	]
-}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.bulkImport").annotate(OpenApi.Summary, "Bulk import contacts").annotate(OpenApi.Description, "Creates contacts in bulk from a list of entries shaped like a create request, returning per-entry results with created, updated, skipped, and error counts. An entry whose identities match an existing contact is skipped, or updates it with `onConflict: \"update\"`."), HttpApiEndpoint.post("contactsBulkUpdateStatus", "/v1/contacts/bulk-update-status", {
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.bulkDelete").annotate(OpenApi.Summary, "Bulk delete contacts").annotate(OpenApi.Description, "Permanently deletes multiple contacts by ID, returning counts of deleted and failed records. One request carries at most 1000 ids."), HttpApiEndpoint.post("contactsBulkUpdateStatus", "/v1/contacts/bulk-update-status", {
 	payload: ContactsBulkUpdateStatusRequestJson,
 	success: ContactsBulkUpdateStatus200,
 	error: [
@@ -701,7 +933,7 @@ var ContactsGroup = class extends HttpApiGroup.make("Contacts").add(HttpApiEndpo
 		ContactsBulkUpdateStatus502.pipe(HttpApiSchema.status(502)),
 		ContactsBulkUpdateStatus504.pipe(HttpApiSchema.status(504))
 	]
-}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.bulkUpdateStatus").annotate(OpenApi.Summary, "Bulk update contact status").annotate(OpenApi.Description, "Sets the status on multiple contacts in one request, returning counts of updated and failed records."), HttpApiEndpoint.post("contactsBulkUpdateTags", "/v1/contacts/bulk-update-tags", {
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.bulkUpdateStatus").annotate(OpenApi.Summary, "Bulk update contact status").annotate(OpenApi.Description, "Sets the status on multiple contacts in one request, returning counts of updated and failed records. One request carries at most 1000 ids."), HttpApiEndpoint.post("contactsBulkUpdateTags", "/v1/contacts/bulk-update-tags", {
 	payload: ContactsBulkUpdateTagsRequestJson,
 	success: ContactsBulkUpdateTags200,
 	error: [
@@ -711,7 +943,7 @@ var ContactsGroup = class extends HttpApiGroup.make("Contacts").add(HttpApiEndpo
 		ContactsBulkUpdateTags500,
 		ContactsBulkUpdateTags504.pipe(HttpApiSchema.status(504))
 	]
-}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.bulkUpdateTags").annotate(OpenApi.Summary, "Bulk update contact tags").annotate(OpenApi.Description, "Adds, removes, or replaces tags on multiple contacts in one request, returning counts of updated and failed records."), HttpApiEndpoint.post("contactsExport", "/v1/contacts/export", {
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.bulkUpdateTags").annotate(OpenApi.Summary, "Bulk update contact tags").annotate(OpenApi.Description, "Adds, removes, or replaces tags on multiple contacts in one request, returning counts of updated and failed records. One request carries at most 1000 ids."), HttpApiEndpoint.post("contactsExport", "/v1/contacts/export", {
 	payload: ContactsExportRequestJson,
 	success: ContactsExport200,
 	error: [
@@ -721,7 +953,7 @@ var ContactsGroup = class extends HttpApiGroup.make("Contacts").add(HttpApiEndpo
 		ContactsExport500,
 		ContactsExport504.pipe(HttpApiSchema.status(504))
 	]
-}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.export").annotate(OpenApi.Summary, "Export contacts").annotate(OpenApi.Description, "Exports contacts as JSON or CSV, returning the serialized data and a count of exported records."), HttpApiEndpoint.post("contactsFind", "/v1/contacts/find", {
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.export").annotate(OpenApi.Summary, "Export contacts").annotate(OpenApi.Description, "Exports contacts as JSON or CSV, returning the serialized data and a count of exported records. The ids filter takes at most 1000 ids."), HttpApiEndpoint.post("contactsFind", "/v1/contacts/find", {
 	payload: ContactsFindRequestJson,
 	success: ContactsFind200,
 	error: [
@@ -747,8 +979,44 @@ var ContactsGroup = class extends HttpApiGroup.make("Contacts").add(HttpApiEndpo
 		ContactsFindOrCreate502.pipe(HttpApiSchema.status(502)),
 		ContactsFindOrCreate504.pipe(HttpApiSchema.status(504))
 	]
-}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.findOrCreate").annotate(OpenApi.Summary, "Find or create a contact").annotate(OpenApi.Description, "Looks up exactly one identifier through `lookup: { type, value }`. Returns `{ contact, created: false }` unchanged when it exists. Otherwise creates the lookup identity (or external ID), applies `create` attributes, and returns `{ contact, created: true }`. Additional addresses belong in `create.identities`, custom fields in `create.profile.customFields`; custom field keys must be defined and values must match their types. An external ID lookup cannot be contradicted by `create.externalId`. Creation returns HTTP 409 ConflictError if an externalId or address belongs to another contact; the conflicting field is named and no contact is created. Use the update endpoint to change an existing contact.")).annotate(OpenApi.Description, "Contact CRUD, bulk operations, engagement metrics, and activity timeline") {};
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.findOrCreate").annotate(OpenApi.Summary, "Find or create a contact").annotate(OpenApi.Description, "Looks up exactly one identifier through `lookup: { type, value }`. Returns `{ contact, created: false }` unchanged when it exists. Otherwise creates the lookup identity (or external ID), applies `create` attributes, and returns `{ contact, created: true }`. Additional addresses belong in `create.identities`, custom fields in `create.profile.customFields`; custom field keys must be defined and values must match their types. An external ID lookup cannot be contradicted by `create.externalId`. Creation returns HTTP 409 ConflictError if an externalId or address belongs to another contact; the conflicting field is named and no contact is created. Use the update endpoint to change an existing contact."), HttpApiEndpoint.post("contactsStartImport", "/v1/contacts/imports", {
+	payload: ContactsStartImportRequestJson,
+	success: ContactsStartImport202.pipe(HttpApiSchema.status(202)),
+	error: [
+		ContactsStartImport401.pipe(HttpApiSchema.status(401)),
+		ContactsStartImport402.pipe(HttpApiSchema.status(402)),
+		ContactsStartImport403.pipe(HttpApiSchema.status(403)),
+		ContactsStartImport404.pipe(HttpApiSchema.status(404)),
+		ContactsStartImport409.pipe(HttpApiSchema.status(409)),
+		ContactsStartImport422.pipe(HttpApiSchema.status(422)),
+		ContactsStartImport500,
+		ContactsStartImport502.pipe(HttpApiSchema.status(502)),
+		ContactsStartImport504.pipe(HttpApiSchema.status(504))
+	]
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.startImport").annotate(OpenApi.Summary, "Start or resume a list migration").annotate(OpenApi.Description, "The complete encoded JSON request, including new-start metadata, must not exceed 3000000 bytes. Admits a durable import using the preview hash and an idempotency key, or resumes the same persisted input at its committed cursor. Imports never restore an existing unsubscribe, suppression or bounce. Namespace-scoped credentials cannot create organization-wide suppressions; those rows are conflicts and create no contact. New active contacts are billable and normal contact events apply. Requires listMigration for new admissions."), HttpApiEndpoint.get("contactsGetImportJob", "/v1/contacts/imports/:id", {
+	params: ContactsGetImportJobPathParams,
+	success: ContactsGetImportJob200,
+	error: [
+		ContactsGetImportJob401.pipe(HttpApiSchema.status(401)),
+		ContactsGetImportJob403.pipe(HttpApiSchema.status(403)),
+		ContactsGetImportJob404.pipe(HttpApiSchema.status(404)),
+		ContactsGetImportJob422.pipe(HttpApiSchema.status(422)),
+		ContactsGetImportJob500,
+		ContactsGetImportJob504.pipe(HttpApiSchema.status(504))
+	]
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.getImportJob").annotate(OpenApi.Summary, "Get list migration progress").annotate(OpenApi.Description, "Returns the visible import job's committed counts, generation, terminal failure and resumability. The job persists across worker restarts and page reloads. Admitted jobs remain readable when listMigration is disabled."), HttpApiEndpoint.post("contactsPlanImport", "/v1/contacts/imports/plan", {
+	payload: ContactsPlanImportRequestJson,
+	success: ContactsPlanImport200,
+	error: [
+		ContactsPlanImport401.pipe(HttpApiSchema.status(401)),
+		ContactsPlanImport403.pipe(HttpApiSchema.status(403)),
+		ContactsPlanImport404.pipe(HttpApiSchema.status(404)),
+		ContactsPlanImport422.pipe(HttpApiSchema.status(422)),
+		ContactsPlanImport500,
+		ContactsPlanImport504.pipe(HttpApiSchema.status(504))
+	]
+}).middleware(ApiKeySecurityMiddleware).annotate(OpenApi.Identifier, "contacts.planImport").annotate(OpenApi.Summary, "Preview a list migration").annotate(OpenApi.Description, "The complete encoded JSON request must not exceed 3000000 bytes. Reads multiple declared export files without changing contacts. Restrictive evidence wins per address. Returns estimated counts and at most 100 diagnostics; processing rechecks current restrictions. Filenames never establish permission. Requires listMigration. Missing required columns refuse the file; unknown status values are conflicts and never subscribe a reader.")).annotate(OpenApi.Description, "Contact CRUD, bulk operations, engagement metrics, and activity timeline") {};
 //#endregion
-export { BulkUpdateResult, Contact, ContactActivityPage, ContactCustomFields, ContactGroupMembershipPage, ContactIdentityInput, ContactListMembership, ContactLocation, ContactLookup, ContactPage, ContactPreferences, ContactProfile, ContactProfileUpdate, ContactSummary, ContactsAddIdentity200, ContactsAddIdentity401, ContactsAddIdentity403, ContactsAddIdentity404, ContactsAddIdentity409, ContactsAddIdentity422, ContactsAddIdentity500, ContactsAddIdentity504, ContactsAddIdentityPathParams, ContactsAddIdentityRequestJson, ContactsAddTags200, ContactsAddTags401, ContactsAddTags403, ContactsAddTags404, ContactsAddTags422, ContactsAddTags500, ContactsAddTags504, ContactsAddTagsPathParams, ContactsAddTagsRequestJson, ContactsBulkDelete200, ContactsBulkDelete401, ContactsBulkDelete403, ContactsBulkDelete422, ContactsBulkDelete500, ContactsBulkDelete502, ContactsBulkDelete504, ContactsBulkDeleteRequestJson, ContactsBulkImport200, ContactsBulkImport401, ContactsBulkImport402, ContactsBulkImport403, ContactsBulkImport404, ContactsBulkImport422, ContactsBulkImport500, ContactsBulkImport502, ContactsBulkImport504, ContactsBulkImportRequestJson, ContactsBulkUpdateStatus200, ContactsBulkUpdateStatus401, ContactsBulkUpdateStatus402, ContactsBulkUpdateStatus403, ContactsBulkUpdateStatus422, ContactsBulkUpdateStatus500, ContactsBulkUpdateStatus502, ContactsBulkUpdateStatus504, ContactsBulkUpdateStatusRequestJson, ContactsBulkUpdateTags200, ContactsBulkUpdateTags401, ContactsBulkUpdateTags403, ContactsBulkUpdateTags422, ContactsBulkUpdateTags500, ContactsBulkUpdateTags504, ContactsBulkUpdateTagsRequestJson, ContactsCreate201, ContactsCreate401, ContactsCreate402, ContactsCreate403, ContactsCreate404, ContactsCreate409, ContactsCreate422, ContactsCreate500, ContactsCreate502, ContactsCreate504, ContactsCreateRequestJson, ContactsExport200, ContactsExport401, ContactsExport403, ContactsExport422, ContactsExport500, ContactsExport504, ContactsExportRequestJson, ContactsFind200, ContactsFind401, ContactsFind403, ContactsFind404, ContactsFind409, ContactsFind422, ContactsFind500, ContactsFind504, ContactsFindOrCreate200, ContactsFindOrCreate401, ContactsFindOrCreate402, ContactsFindOrCreate403, ContactsFindOrCreate404, ContactsFindOrCreate409, ContactsFindOrCreate422, ContactsFindOrCreate500, ContactsFindOrCreate502, ContactsFindOrCreate504, ContactsFindOrCreateRequestJson, ContactsFindRequestJson, ContactsGet200, ContactsGet401, ContactsGet403, ContactsGet404, ContactsGet422, ContactsGet500, ContactsGet504, ContactsGetActivityTimeline200, ContactsGetActivityTimeline401, ContactsGetActivityTimeline403, ContactsGetActivityTimeline404, ContactsGetActivityTimeline422, ContactsGetActivityTimeline500, ContactsGetActivityTimeline504, ContactsGetActivityTimelinePathParams, ContactsGetActivityTimelineQuery, ContactsGetEngagement200, ContactsGetEngagement401, ContactsGetEngagement403, ContactsGetEngagement404, ContactsGetEngagement422, ContactsGetEngagement500, ContactsGetEngagement504, ContactsGetEngagementPathParams, ContactsGetGroupMemberships200, ContactsGetGroupMemberships401, ContactsGetGroupMemberships403, ContactsGetGroupMemberships404, ContactsGetGroupMemberships422, ContactsGetGroupMemberships500, ContactsGetGroupMemberships504, ContactsGetGroupMembershipsPathParams, ContactsGetGroupMembershipsQuery, ContactsGetPathParams, ContactsGroup, ContactsList200, ContactsList401, ContactsList403, ContactsList422, ContactsList500, ContactsList504, ContactsListQuery, ContactsRemove200, ContactsRemove401, ContactsRemove403, ContactsRemove404, ContactsRemove422, ContactsRemove500, ContactsRemove502, ContactsRemove504, ContactsRemoveIdentity200, ContactsRemoveIdentity401, ContactsRemoveIdentity403, ContactsRemoveIdentity404, ContactsRemoveIdentity422, ContactsRemoveIdentity500, ContactsRemoveIdentity504, ContactsRemoveIdentityPathParams, ContactsRemovePathParams, ContactsRemoveTags200, ContactsRemoveTags401, ContactsRemoveTags403, ContactsRemoveTags404, ContactsRemoveTags422, ContactsRemoveTags500, ContactsRemoveTags504, ContactsRemoveTagsPathParams, ContactsRemoveTagsRequestJson, ContactsSetConsent200, ContactsSetConsent401, ContactsSetConsent403, ContactsSetConsent404, ContactsSetConsent422, ContactsSetConsent500, ContactsSetConsent504, ContactsSetConsentPathParams, ContactsSetConsentRequestJson, ContactsUpdate200, ContactsUpdate401, ContactsUpdate402, ContactsUpdate403, ContactsUpdate404, ContactsUpdate422, ContactsUpdate500, ContactsUpdate502, ContactsUpdate504, ContactsUpdatePathParams, ContactsUpdateRequestJson };
+export { BulkUpdateResult, Contact, ContactActivityPage, ContactCustomFields, ContactGroupMembershipPage, ContactIdentityInput, ContactImportJobId, ContactListMembership, ContactLocation, ContactLookup, ContactPage, ContactPreferences, ContactProfile, ContactProfileUpdate, ContactSummary, ContactsAddIdentity200, ContactsAddIdentity401, ContactsAddIdentity403, ContactsAddIdentity404, ContactsAddIdentity409, ContactsAddIdentity422, ContactsAddIdentity500, ContactsAddIdentity504, ContactsAddIdentityPathParams, ContactsAddIdentityRequestJson, ContactsAddTags200, ContactsAddTags401, ContactsAddTags403, ContactsAddTags404, ContactsAddTags422, ContactsAddTags500, ContactsAddTags504, ContactsAddTagsPathParams, ContactsAddTagsRequestJson, ContactsBulkDelete200, ContactsBulkDelete401, ContactsBulkDelete403, ContactsBulkDelete422, ContactsBulkDelete500, ContactsBulkDelete502, ContactsBulkDelete504, ContactsBulkDeleteRequestJson, ContactsBulkUpdateStatus200, ContactsBulkUpdateStatus401, ContactsBulkUpdateStatus402, ContactsBulkUpdateStatus403, ContactsBulkUpdateStatus422, ContactsBulkUpdateStatus500, ContactsBulkUpdateStatus502, ContactsBulkUpdateStatus504, ContactsBulkUpdateStatusRequestJson, ContactsBulkUpdateTags200, ContactsBulkUpdateTags401, ContactsBulkUpdateTags403, ContactsBulkUpdateTags422, ContactsBulkUpdateTags500, ContactsBulkUpdateTags504, ContactsBulkUpdateTagsRequestJson, ContactsCreate201, ContactsCreate401, ContactsCreate402, ContactsCreate403, ContactsCreate404, ContactsCreate409, ContactsCreate422, ContactsCreate500, ContactsCreate502, ContactsCreate504, ContactsCreateRequestJson, ContactsExport200, ContactsExport401, ContactsExport403, ContactsExport422, ContactsExport500, ContactsExport504, ContactsExportRequestJson, ContactsFind200, ContactsFind401, ContactsFind403, ContactsFind404, ContactsFind409, ContactsFind422, ContactsFind500, ContactsFind504, ContactsFindOrCreate200, ContactsFindOrCreate401, ContactsFindOrCreate402, ContactsFindOrCreate403, ContactsFindOrCreate404, ContactsFindOrCreate409, ContactsFindOrCreate422, ContactsFindOrCreate500, ContactsFindOrCreate502, ContactsFindOrCreate504, ContactsFindOrCreateRequestJson, ContactsFindRequestJson, ContactsGet200, ContactsGet401, ContactsGet403, ContactsGet404, ContactsGet422, ContactsGet500, ContactsGet504, ContactsGetActivityTimeline200, ContactsGetActivityTimeline401, ContactsGetActivityTimeline403, ContactsGetActivityTimeline404, ContactsGetActivityTimeline422, ContactsGetActivityTimeline500, ContactsGetActivityTimeline504, ContactsGetActivityTimelinePathParams, ContactsGetActivityTimelineQuery, ContactsGetEngagement200, ContactsGetEngagement401, ContactsGetEngagement403, ContactsGetEngagement404, ContactsGetEngagement422, ContactsGetEngagement500, ContactsGetEngagement504, ContactsGetEngagementPathParams, ContactsGetGroupMemberships200, ContactsGetGroupMemberships401, ContactsGetGroupMemberships403, ContactsGetGroupMemberships404, ContactsGetGroupMemberships422, ContactsGetGroupMemberships500, ContactsGetGroupMemberships504, ContactsGetGroupMembershipsPathParams, ContactsGetGroupMembershipsQuery, ContactsGetImportJob200, ContactsGetImportJob401, ContactsGetImportJob403, ContactsGetImportJob404, ContactsGetImportJob422, ContactsGetImportJob500, ContactsGetImportJob504, ContactsGetImportJobPathParams, ContactsGetPathParams, ContactsGroup, ContactsList200, ContactsList401, ContactsList403, ContactsList422, ContactsList500, ContactsList504, ContactsListQuery, ContactsPlanImport200, ContactsPlanImport401, ContactsPlanImport403, ContactsPlanImport404, ContactsPlanImport422, ContactsPlanImport500, ContactsPlanImport504, ContactsPlanImportRequestJson, ContactsRemove200, ContactsRemove401, ContactsRemove403, ContactsRemove404, ContactsRemove422, ContactsRemove500, ContactsRemove502, ContactsRemove504, ContactsRemoveIdentity200, ContactsRemoveIdentity401, ContactsRemoveIdentity403, ContactsRemoveIdentity404, ContactsRemoveIdentity422, ContactsRemoveIdentity500, ContactsRemoveIdentity504, ContactsRemoveIdentityPathParams, ContactsRemovePathParams, ContactsRemoveTags200, ContactsRemoveTags401, ContactsRemoveTags403, ContactsRemoveTags404, ContactsRemoveTags422, ContactsRemoveTags500, ContactsRemoveTags504, ContactsRemoveTagsPathParams, ContactsRemoveTagsRequestJson, ContactsSetConsent200, ContactsSetConsent401, ContactsSetConsent403, ContactsSetConsent404, ContactsSetConsent422, ContactsSetConsent500, ContactsSetConsent504, ContactsSetConsentPathParams, ContactsSetConsentRequestJson, ContactsStartImport202, ContactsStartImport401, ContactsStartImport402, ContactsStartImport403, ContactsStartImport404, ContactsStartImport409, ContactsStartImport422, ContactsStartImport500, ContactsStartImport502, ContactsStartImport504, ContactsStartImportRequestJson, ContactsUpdate200, ContactsUpdate401, ContactsUpdate402, ContactsUpdate403, ContactsUpdate404, ContactsUpdate422, ContactsUpdate500, ContactsUpdate502, ContactsUpdate504, ContactsUpdatePathParams, ContactsUpdateRequestJson };
 
 //# sourceMappingURL=contacts.js.map