feat: improve type errors for audience -> segments transition

src/contacts/contacts.ts

@@ -39,6 +39,15 @@ export class Contacts {
     this.segments = new ContactSegments(this.resend);
   }
 
+  async create(
+    paylaod: CreateContactOptions,
+    options?: CreateContactRequestOptions,
+  ): Promise<CreateContactResponse>;
+  async create(
+    paylaod: LegacyCreateContactOptions,
+    options?: CreateContactRequestOptions,
+  ): Promise<CreateContactResponse>;
+
   async create(
     payload: CreateContactOptions | LegacyCreateContactOptions,
     options: CreateContactRequestOptions = {},

src/contacts/interfaces/create-contact-options.interface.ts

@@ -9,15 +9,15 @@ interface CreateContactPropertiesOptions {
 export interface LegacyCreateContactOptions {
   /**
    * @deprecated Use `segments` instead to add one or more segments to the new contact
+   *
+   * @see https://resend.com/docs/dashboard/segments/migrating-from-audiences-to-segments
    */
   audienceId: string;
   email: string;
   unsubscribed?: boolean;
   firstName?: string;
   lastName?: string;
   properties?: CreateContactPropertiesOptions;
-  segments?: never;
-  topics?: never;
 }
 
 export interface CreateContactOptions {
@@ -33,10 +33,6 @@ export interface CreateContactOptions {
     id: string;
     subscription: 'opt_in' | 'opt_out';
   }[];
-  /**
-   * @deprecated Use `segments` instead to add one or more segments to the new contact
-   */
-  audienceId?: never;
 }
 
 export interface CreateContactRequestOptions extends PostOptions {}