postgrid-node 0.1.0-alpha.5 → 0.3.0

package/src/resources/print-mail/contacts.ts

@@ -0,0 +1,594 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Contacts extends APIResource {
+  /**
+   * Creates a contact. This will also verify the contact's address **if you create
+   * it using a live API key**. To sucessfully create a contact, either a
+   * `firstName`, a `companyName`, or both are required. You can supply both, but you
+   * **cannot** supply neither.
+   *
+   * You have the option to supply the entire address (except for `countryCode`) via
+   * `addressLine1`, in which case PostGrid will parse it automatically. However,
+   * this is **not guaranteed to be correct**, so we recommend passing along the
+   * structured address fields (`city`, `provinceOrState`, etc) if you have them.
+   *
+   * _Note that if you create a contact that has identical information to another
+   * contact, this will simply update the description of the existing contact and
+   * return it. This avoids creating duplicate contacts._
+   *
+   * @example
+   * ```ts
+   * const contact = await client.printMail.contacts.create({
+   *   addressLine1: '90 Canal St Suite 600, Boston MA 90210',
+   *   countryCode: 'US',
+   *   firstName: 'Kevin',
+   *   companyName: 'PostGrid',
+   * });
+   * ```
+   */
+  create(body: ContactCreateParams, options?: RequestOptions): APIPromise<Contact> {
+    return this._client.post('/print-mail/v1/contacts', { body, ...options });
+  }
+
+  /**
+   * Retrieve a contact.
+   *
+   * @example
+   * ```ts
+   * const contact = await client.printMail.contacts.retrieve(
+   *   'id',
+   * );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<Contact> {
+    return this._client.get(path`/print-mail/v1/contacts/${id}`, options);
+  }
+
+  /**
+   * Get a list of contacts.
+   *
+   * @example
+   * ```ts
+   * const contacts = await client.printMail.contacts.list();
+   * ```
+   */
+  list(
+    query: ContactListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ContactListResponse> {
+    return this._client.get('/print-mail/v1/contacts', { query, ...options });
+  }
+
+  /**
+   * Delete a contact. Note that this will not affect orders that were sent to this
+   * contact.
+   *
+   * @example
+   * ```ts
+   * const contact = await client.printMail.contacts.delete(
+   *   'id',
+   * );
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<ContactDeleteResponse> {
+    return this._client.delete(path`/print-mail/v1/contacts/${id}`, options);
+  }
+}
+
+export interface Contact {
+  /**
+   * A unique ID prefixed with contact\_
+   */
+  id: string;
+
+  /**
+   * The first line of the contact's address.
+   */
+  addressLine1: string;
+
+  /**
+   * One of `verified`, `corrected`, or `failed`.
+   */
+  addressStatus: 'verified' | 'corrected' | 'failed';
+
+  /**
+   * The ISO 3611-1 country code of the contact's address.
+   */
+  countryCode: string;
+
+  /**
+   * The UTC time at which this resource was created.
+   */
+  createdAt: string;
+
+  /**
+   * `true` if this is a live mode resource else `false`.
+   */
+  live: boolean;
+
+  /**
+   * Always `contact`.
+   */
+  object: 'contact';
+
+  /**
+   * The UTC time at which this resource was last updated.
+   */
+  updatedAt: string;
+
+  /**
+   * A series of human-readable errors/warnings that were raised when running the
+   * provided address through our address verification.
+   */
+  addressErrors?: string;
+
+  /**
+   * Second line of the contact's address, if applicable.
+   */
+  addressLine2?: string;
+
+  /**
+   * The city of the contact's address.
+   */
+  city?: string;
+
+  /**
+   * Company name of the contact.
+   */
+  companyName?: string;
+
+  /**
+   * An optional string describing this resource. Will be visible in the API and the
+   * dashboard.
+   */
+  description?: string;
+
+  /**
+   * Email of the contact.
+   */
+  email?: string;
+
+  /**
+   * First name of the contact.
+   */
+  firstName?: string;
+
+  /**
+   * If `true`, PostGrid will force this contact to have an `addressStatus` of
+   * `verified` even if our address verification system says otherwise.
+   */
+  forceVerifiedStatus?: boolean;
+
+  /**
+   * Job title of the contact.
+   */
+  jobTitle?: string;
+
+  /**
+   * Last name of the contact.
+   */
+  lastName?: string;
+
+  /**
+   * See the section on Metadata.
+   */
+  metadata?: { [key: string]: unknown };
+
+  /**
+   * Phone number of the contact.
+   */
+  phoneNumber?: string;
+
+  /**
+   * The postal or ZIP code of the contact's address.
+   */
+  postalOrZip?: string;
+
+  /**
+   * Province or state of the contact's address.
+   */
+  provinceOrState?: string;
+
+  /**
+   * If `true`, PostGrid will skip running this contact's address through our address
+   * verification system.
+   */
+  skipVerification?: boolean;
+}
+
+export type ContactCreate =
+  | ContactCreate.ContactCreateWithFirstName
+  | ContactCreate.ContactCreateWithCompanyName;
+
+export namespace ContactCreate {
+  export interface ContactCreateWithFirstName {
+    /**
+     * The first line of the contact's address.
+     */
+    addressLine1: string;
+
+    /**
+     * The ISO 3611-1 country code of the contact's address.
+     */
+    countryCode: string;
+
+    firstName: string;
+
+    /**
+     * Second line of the contact's address, if applicable.
+     */
+    addressLine2?: string;
+
+    /**
+     * The city of the contact's address.
+     */
+    city?: string;
+
+    /**
+     * Company name of the contact.
+     */
+    companyName?: string;
+
+    /**
+     * An optional string describing this resource. Will be visible in the API and the
+     * dashboard.
+     */
+    description?: string;
+
+    /**
+     * Email of the contact.
+     */
+    email?: string;
+
+    /**
+     * If `true`, PostGrid will force this contact to have an `addressStatus` of
+     * `verified` even if our address verification system says otherwise.
+     */
+    forceVerifiedStatus?: boolean;
+
+    /**
+     * Job title of the contact.
+     */
+    jobTitle?: string;
+
+    /**
+     * Last name of the contact.
+     */
+    lastName?: string;
+
+    /**
+     * See the section on Metadata.
+     */
+    metadata?: { [key: string]: unknown };
+
+    /**
+     * Phone number of the contact.
+     */
+    phoneNumber?: string;
+
+    /**
+     * The postal or ZIP code of the contact's address.
+     */
+    postalOrZip?: string;
+
+    /**
+     * Province or state of the contact's address.
+     */
+    provinceOrState?: string;
+
+    /**
+     * If `true`, PostGrid will skip running this contact's address through our address
+     * verification system.
+     */
+    skipVerification?: boolean;
+  }
+
+  export interface ContactCreateWithCompanyName {
+    /**
+     * The first line of the contact's address.
+     */
+    addressLine1: string;
+
+    companyName: string;
+
+    /**
+     * The ISO 3611-1 country code of the contact's address.
+     */
+    countryCode: string;
+
+    /**
+     * Second line of the contact's address, if applicable.
+     */
+    addressLine2?: string;
+
+    /**
+     * The city of the contact's address.
+     */
+    city?: string;
+
+    /**
+     * An optional string describing this resource. Will be visible in the API and the
+     * dashboard.
+     */
+    description?: string;
+
+    /**
+     * Email of the contact.
+     */
+    email?: string;
+
+    /**
+     * First name of the contact.
+     */
+    firstName?: string;
+
+    /**
+     * If `true`, PostGrid will force this contact to have an `addressStatus` of
+     * `verified` even if our address verification system says otherwise.
+     */
+    forceVerifiedStatus?: boolean;
+
+    /**
+     * Job title of the contact.
+     */
+    jobTitle?: string;
+
+    /**
+     * Last name of the contact.
+     */
+    lastName?: string;
+
+    /**
+     * See the section on Metadata.
+     */
+    metadata?: { [key: string]: unknown };
+
+    /**
+     * Phone number of the contact.
+     */
+    phoneNumber?: string;
+
+    /**
+     * The postal or ZIP code of the contact's address.
+     */
+    postalOrZip?: string;
+
+    /**
+     * Province or state of the contact's address.
+     */
+    provinceOrState?: string;
+
+    /**
+     * If `true`, PostGrid will skip running this contact's address through our address
+     * verification system.
+     */
+    skipVerification?: boolean;
+  }
+}
+
+export interface ContactListResponse {
+  data: Array<Contact>;
+
+  limit: number;
+
+  object: 'list';
+
+  skip: number;
+
+  totalCount: number;
+}
+
+export interface ContactDeleteResponse {
+  /**
+   * A unique ID prefixed with contact\_
+   */
+  id: string;
+
+  deleted: true;
+
+  /**
+   * Always `contact`.
+   */
+  object: 'contact';
+}
+
+export type ContactCreateParams =
+  | ContactCreateParams.ContactCreateWithFirstName
+  | ContactCreateParams.ContactCreateWithCompanyName;
+
+export declare namespace ContactCreateParams {
+  export interface ContactCreateWithFirstName {
+    /**
+     * The first line of the contact's address.
+     */
+    addressLine1: string;
+
+    /**
+     * The ISO 3611-1 country code of the contact's address.
+     */
+    countryCode: string;
+
+    firstName: string;
+
+    /**
+     * Second line of the contact's address, if applicable.
+     */
+    addressLine2?: string;
+
+    /**
+     * The city of the contact's address.
+     */
+    city?: string;
+
+    /**
+     * Company name of the contact.
+     */
+    companyName?: string;
+
+    /**
+     * An optional string describing this resource. Will be visible in the API and the
+     * dashboard.
+     */
+    description?: string;
+
+    /**
+     * Email of the contact.
+     */
+    email?: string;
+
+    /**
+     * If `true`, PostGrid will force this contact to have an `addressStatus` of
+     * `verified` even if our address verification system says otherwise.
+     */
+    forceVerifiedStatus?: boolean;
+
+    /**
+     * Job title of the contact.
+     */
+    jobTitle?: string;
+
+    /**
+     * Last name of the contact.
+     */
+    lastName?: string;
+
+    /**
+     * See the section on Metadata.
+     */
+    metadata?: { [key: string]: unknown };
+
+    /**
+     * Phone number of the contact.
+     */
+    phoneNumber?: string;
+
+    /**
+     * The postal or ZIP code of the contact's address.
+     */
+    postalOrZip?: string;
+
+    /**
+     * Province or state of the contact's address.
+     */
+    provinceOrState?: string;
+
+    /**
+     * If `true`, PostGrid will skip running this contact's address through our address
+     * verification system.
+     */
+    skipVerification?: boolean;
+  }
+
+  export interface ContactCreateWithCompanyName {
+    /**
+     * The first line of the contact's address.
+     */
+    addressLine1: string;
+
+    companyName: string;
+
+    /**
+     * The ISO 3611-1 country code of the contact's address.
+     */
+    countryCode: string;
+
+    /**
+     * Second line of the contact's address, if applicable.
+     */
+    addressLine2?: string;
+
+    /**
+     * The city of the contact's address.
+     */
+    city?: string;
+
+    /**
+     * An optional string describing this resource. Will be visible in the API and the
+     * dashboard.
+     */
+    description?: string;
+
+    /**
+     * Email of the contact.
+     */
+    email?: string;
+
+    /**
+     * First name of the contact.
+     */
+    firstName?: string;
+
+    /**
+     * If `true`, PostGrid will force this contact to have an `addressStatus` of
+     * `verified` even if our address verification system says otherwise.
+     */
+    forceVerifiedStatus?: boolean;
+
+    /**
+     * Job title of the contact.
+     */
+    jobTitle?: string;
+
+    /**
+     * Last name of the contact.
+     */
+    lastName?: string;
+
+    /**
+     * See the section on Metadata.
+     */
+    metadata?: { [key: string]: unknown };
+
+    /**
+     * Phone number of the contact.
+     */
+    phoneNumber?: string;
+
+    /**
+     * The postal or ZIP code of the contact's address.
+     */
+    postalOrZip?: string;
+
+    /**
+     * Province or state of the contact's address.
+     */
+    provinceOrState?: string;
+
+    /**
+     * If `true`, PostGrid will skip running this contact's address through our address
+     * verification system.
+     */
+    skipVerification?: boolean;
+  }
+}
+
+export interface ContactListParams {
+  limit?: number;
+
+  /**
+   * You can supply any string to help narrow down the list of resources. For
+   * example, if you pass `"New York"` (quoted), it will return resources that have
+   * that string present somewhere in their response. Alternatively, you can supply a
+   * structured search query. See the documentation on `StructuredSearchQuery` for
+   * more details.
+   */
+  search?: string;
+
+  skip?: number;
+}
+
+export declare namespace Contacts {
+  export {
+    type Contact as Contact,
+    type ContactCreate as ContactCreate,
+    type ContactListResponse as ContactListResponse,
+    type ContactDeleteResponse as ContactDeleteResponse,
+    type ContactCreateParams as ContactCreateParams,
+    type ContactListParams as ContactListParams,
+  };
+}

package/src/resources/print-mail/index.ts

@@ -0,0 +1,134 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  BankAccounts,
+  type BankAccount,
+  type BankAccountCountryCode,
+  type BankAccountListResponse,
+  type BankAccountDeleteResponse,
+  type BankAccountCreateParams,
+  type BankAccountListParams,
+} from './bank-accounts';
+export {
+  Boxes,
+  type Box,
+  type BoxChequeBase,
+  type Cancellation,
+  type OrderImbStatus,
+  type OrderMailingClass,
+  type OrderStatus,
+  type BoxListResponse,
+  type BoxCreateParams,
+  type BoxListParams,
+} from './boxes';
+export {
+  Campaigns,
+  type Campaign,
+  type CampaignListResponse,
+  type CampaignDeleteResponse,
+  type CampaignCreateParams,
+  type CampaignUpdateParams,
+  type CampaignListParams,
+  type CampaignSendParams,
+} from './campaigns';
+export {
+  Cheques,
+  type Cheque,
+  type ChequeSize,
+  type DigitalOnly,
+  type ChequeListResponse,
+  type ChequeRetrieveURLResponse,
+  type ChequeCreateParams,
+  type ChequeListParams,
+} from './cheques';
+export {
+  Contacts,
+  type Contact,
+  type ContactCreate,
+  type ContactListResponse,
+  type ContactDeleteResponse,
+  type ContactCreateParams,
+  type ContactListParams,
+} from './contacts';
+export {
+  Letters,
+  type AddressPlacement,
+  type AttachedPdf,
+  type Letter,
+  type LetterSize,
+  type PlasticCard,
+  type LetterListResponse,
+  type LetterRetrieveURLResponse,
+  type LetterCreateParams,
+  type LetterListParams,
+} from './letters';
+export {
+  MailingListImports,
+  type FileType,
+  type MailingListImportResponse,
+  type VerificationStatusCount,
+  type MailingListImportListResponse,
+  type MailingListImportDeleteResponse,
+  type MailingListImportCreateParams,
+  type MailingListImportUpdateParams,
+  type MailingListImportListParams,
+} from './mailing-list-imports';
+export {
+  MailingLists,
+  type MailingList,
+  type MailingListUpdate,
+  type MailingListListResponse,
+  type MailingListDeleteResponse,
+  type MailingListCreateParams,
+  type MailingListUpdateParams,
+  type MailingListListParams,
+  type MailingListJobsParams,
+} from './mailing-lists';
+export { OrderProfiles } from './order-profiles/index';
+export {
+  Postcards,
+  type Postcard,
+  type PostcardListResponse,
+  type PostcardRetrieveURLResponse,
+  type PostcardCreateParams,
+  type PostcardListParams,
+} from './postcards';
+export { PrintMail } from './print-mail';
+export {
+  Reports,
+  type DeletedResponse,
+  type Report,
+  type ReportListResponse,
+  type ReportCreateParams,
+  type ReportUpdateParams,
+  type ReportListParams,
+  type ReportSampleParams,
+} from './reports/index';
+export {
+  SelfMailers,
+  type SelfMailer,
+  type SelfMailerListResponse,
+  type SelfMailerRetrieveURLResponse,
+  type SelfMailerCreateParams,
+  type SelfMailerListParams,
+} from './self-mailers';
+export {
+  SubOrganizations,
+  type EmailPreferences,
+  type SubOrganization,
+  type SubOrganizationUpdateResponse,
+  type SubOrganizationListResponse,
+  type SubOrganizationRetrieveUsersResponse,
+  type SubOrganizationUpdateParams,
+  type SubOrganizationListParams,
+  type SubOrganizationRetrieveUsersParams,
+} from './sub-organizations';
+export {
+  Templates,
+  type Template,
+  type TemplateListResponse,
+  type TemplateDeleteResponse,
+  type TemplateCreateParams,
+  type TemplateUpdateParams,
+  type TemplateListParams,
+} from './templates';