telnyx 7.2.0 → 7.3.0

package/resources/dir/references.d.ts

@@ -0,0 +1,231 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Submit and manage the two business references and one financial reference that vouch for a DIR. References are contacted to confirm the business identity during vetting.
+ */
+export declare class References extends APIResource {
+    /**
+     * Submit the two business references and one financial reference for a DIR.
+     *
+     * The DIR's authorizer email must be verified first (see the email-verification
+     * endpoint). Until it is, this returns `409` and no references are stored.
+     *
+     * The request body carries exactly two business references plus one financial
+     * reference. On success the references are stored and the response echoes them in
+     * the same shape as the GET. Submitting again converges on the already-stored
+     * references rather than erroring.
+     *
+     * @example
+     * ```ts
+     * const referenceList = await client.dir.references.create(
+     *   '16635d38-75a6-4481-82e8-69af60e05011',
+     *   {
+     *     business_references: [
+     *       {
+     *         email: 'dana.reyes@example.com',
+     *         full_name: 'Dana Reyes',
+     *         phone_e164: '+14155550123',
+     *         timezone: 'America/New_York',
+     *       },
+     *       {
+     *         email: 'dana.reyes@example.com',
+     *         full_name: 'Dana Reyes',
+     *         phone_e164: '+14155550123',
+     *         timezone: 'America/New_York',
+     *       },
+     *     ],
+     *     financial_reference: {
+     *       email: 'dana.reyes@example.com',
+     *       full_name: 'Dana Reyes',
+     *       phone_e164: '+14155550123',
+     *       timezone: 'America/New_York',
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    create(dirID: string, body: ReferenceCreateParams, options?: RequestOptions): APIPromise<ReferenceList>;
+    /**
+     * Partially update one reference, addressed by the DIR id plus the reference's
+     * type (business or financial) and slot.
+     *
+     * Cosmetic fields (full name, job title, organization, relationship, email) are
+     * always editable. The phone number and timezone may only be changed while a
+     * scheduled call has not yet been dialed; if a call is in progress or all attempts
+     * are complete, those fields are locked. Changing the timezone reschedules any
+     * pending call into the new local calling window.
+     *
+     * @example
+     * ```ts
+     * const reference = await client.dir.references.update(0, {
+     *   dir_id: '16635d38-75a6-4481-82e8-69af60e05011',
+     *   ref_type: 'business',
+     * });
+     * ```
+     */
+    update(slot: number, params: ReferenceUpdateParams, options?: RequestOptions): APIPromise<ReferenceUpdateResponse>;
+    /**
+     * List the business and financial references submitted for a DIR.
+     *
+     * Returns the two business references (slots 0 and 1) followed by the single
+     * financial reference. Each entry carries only the customer-supplied details
+     * (name, title, organization, relationship, phone, email, timezone). Returns an
+     * empty list when no references were submitted.
+     *
+     * @example
+     * ```ts
+     * const referenceList = await client.dir.references.list(
+     *   '16635d38-75a6-4481-82e8-69af60e05011',
+     * );
+     * ```
+     */
+    list(dirID: string, options?: RequestOptions): APIPromise<ReferenceList>;
+}
+/**
+ * A reference (business or financial) on a DIR, in the customer-facing shape. No
+ * internal identifiers are exposed.
+ */
+export interface Reference {
+    /**
+     * Full name of the reference contact.
+     */
+    full_name: string;
+    /**
+     * Reference phone number in E.164 format.
+     */
+    phone_e164: string;
+    /**
+     * Always `dir_reference`.
+     */
+    record_type: 'dir_reference';
+    /**
+     * Whether this is a business reference or the financial reference.
+     */
+    ref_type: 'business' | 'financial';
+    /**
+     * Position within the reference type. Business references occupy slots 0 and 1;
+     * the financial reference occupies slot 0.
+     */
+    slot: number;
+    /**
+     * IANA timezone id for the reference. Calls are only placed within the reference's
+     * local 8am-9pm window.
+     */
+    timezone: string;
+    /**
+     * Reference contact email address.
+     */
+    email?: string | null;
+    /**
+     * Job title of the reference contact.
+     */
+    job_title?: string | null;
+    /**
+     * Organization the reference contact belongs to.
+     */
+    organization?: string | null;
+    /**
+     * How the reference contact is related to the registering business.
+     */
+    relationship_to_registrant?: string | null;
+}
+/**
+ * One reference supplied at submit. The reference type is implied by the field
+ * that carries it (business_references vs financial_reference).
+ */
+export interface ReferenceInput {
+    /**
+     * Reference contact email address. Required: the reference is emailed scheduling
+     * and dial-in notices.
+     */
+    email: string;
+    /**
+     * Full name of the reference contact.
+     */
+    full_name: string;
+    /**
+     * Reference phone number in E.164 format, e.g. +14155550123.
+     */
+    phone_e164: string;
+    /**
+     * IANA timezone id for the reference (e.g. America/New_York). Required: calls are
+     * only placed within the reference's local 8am-9pm window.
+     */
+    timezone: string;
+    /**
+     * Job title of the reference contact.
+     */
+    job_title?: string | null;
+    /**
+     * Organization the reference contact belongs to.
+     */
+    organization?: string | null;
+    /**
+     * How the reference contact is related to the registering business.
+     */
+    relationship_to_registrant?: string | null;
+}
+export interface ReferenceList {
+    data: Array<Reference>;
+}
+export interface ReferenceUpdateResponse {
+    /**
+     * A reference (business or financial) on a DIR, in the customer-facing shape. No
+     * internal identifiers are exposed.
+     */
+    data: Reference;
+}
+export interface ReferenceCreateParams {
+    /**
+     * Exactly two business references.
+     */
+    business_references: Array<ReferenceInput>;
+    /**
+     * One reference supplied at submit. The reference type is implied by the field
+     * that carries it (business_references vs financial_reference).
+     */
+    financial_reference: ReferenceInput;
+}
+export interface ReferenceUpdateParams {
+    /**
+     * Path param: The DIR id. Lowercase UUID.
+     */
+    dir_id: string;
+    /**
+     * Path param: Reference type to address.
+     */
+    ref_type: 'business' | 'financial';
+    /**
+     * Body param: Reference contact email address.
+     */
+    email?: string;
+    /**
+     * Body param: Full name of the reference contact.
+     */
+    full_name?: string;
+    /**
+     * Body param: Job title of the reference contact.
+     */
+    job_title?: string | null;
+    /**
+     * Body param: Organization the reference contact belongs to.
+     */
+    organization?: string | null;
+    /**
+     * Body param: Reference phone number in E.164 format.
+     */
+    phone_e164?: string;
+    /**
+     * Body param: How the reference contact is related to the registering business.
+     */
+    relationship_to_registrant?: string | null;
+    /**
+     * Body param: IANA timezone id for the reference.
+     */
+    timezone?: string;
+}
+export declare namespace References {
+    export { type Reference as Reference, type ReferenceInput as ReferenceInput, type ReferenceList as ReferenceList, type ReferenceUpdateResponse as ReferenceUpdateResponse, type ReferenceCreateParams as ReferenceCreateParams, type ReferenceUpdateParams as ReferenceUpdateParams, };
+}
+//# sourceMappingURL=references.d.ts.map

package/resources/dir/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/resources/dir/references.ts"],"names":[],"mappings":"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"}

package/resources/dir/references.js

@@ -0,0 +1,96 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.References = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Submit and manage the two business references and one financial reference that vouch for a DIR. References are contacted to confirm the business identity during vetting.
+ */
+class References extends resource_1.APIResource {
+    /**
+     * Submit the two business references and one financial reference for a DIR.
+     *
+     * The DIR's authorizer email must be verified first (see the email-verification
+     * endpoint). Until it is, this returns `409` and no references are stored.
+     *
+     * The request body carries exactly two business references plus one financial
+     * reference. On success the references are stored and the response echoes them in
+     * the same shape as the GET. Submitting again converges on the already-stored
+     * references rather than erroring.
+     *
+     * @example
+     * ```ts
+     * const referenceList = await client.dir.references.create(
+     *   '16635d38-75a6-4481-82e8-69af60e05011',
+     *   {
+     *     business_references: [
+     *       {
+     *         email: 'dana.reyes@example.com',
+     *         full_name: 'Dana Reyes',
+     *         phone_e164: '+14155550123',
+     *         timezone: 'America/New_York',
+     *       },
+     *       {
+     *         email: 'dana.reyes@example.com',
+     *         full_name: 'Dana Reyes',
+     *         phone_e164: '+14155550123',
+     *         timezone: 'America/New_York',
+     *       },
+     *     ],
+     *     financial_reference: {
+     *       email: 'dana.reyes@example.com',
+     *       full_name: 'Dana Reyes',
+     *       phone_e164: '+14155550123',
+     *       timezone: 'America/New_York',
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    create(dirID, body, options) {
+        return this._client.post((0, path_1.path) `/dir/${dirID}/references`, { body, ...options });
+    }
+    /**
+     * Partially update one reference, addressed by the DIR id plus the reference's
+     * type (business or financial) and slot.
+     *
+     * Cosmetic fields (full name, job title, organization, relationship, email) are
+     * always editable. The phone number and timezone may only be changed while a
+     * scheduled call has not yet been dialed; if a call is in progress or all attempts
+     * are complete, those fields are locked. Changing the timezone reschedules any
+     * pending call into the new local calling window.
+     *
+     * @example
+     * ```ts
+     * const reference = await client.dir.references.update(0, {
+     *   dir_id: '16635d38-75a6-4481-82e8-69af60e05011',
+     *   ref_type: 'business',
+     * });
+     * ```
+     */
+    update(slot, params, options) {
+        const { dir_id, ref_type, ...body } = params;
+        return this._client.patch((0, path_1.path) `/dir/${dir_id}/references/${ref_type}/${slot}`, { body, ...options });
+    }
+    /**
+     * List the business and financial references submitted for a DIR.
+     *
+     * Returns the two business references (slots 0 and 1) followed by the single
+     * financial reference. Each entry carries only the customer-supplied details
+     * (name, title, organization, relationship, phone, email, timezone). Returns an
+     * empty list when no references were submitted.
+     *
+     * @example
+     * ```ts
+     * const referenceList = await client.dir.references.list(
+     *   '16635d38-75a6-4481-82e8-69af60e05011',
+     * );
+     * ```
+     */
+    list(dirID, options) {
+        return this._client.get((0, path_1.path) `/dir/${dirID}/references`, options);
+    }
+}
+exports.References = References;
+//# sourceMappingURL=references.js.map

package/resources/dir/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/resources/dir/references.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,MAAM,CAAC,KAAa,EAAE,IAA2B,EAAE,OAAwB;QACzE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,QAAQ,KAAK,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,IAAY,EACZ,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,QAAQ,MAAM,eAAe,QAAQ,IAAI,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,KAAa,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,QAAQ,KAAK,aAAa,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;CACF;AA1FD,gCA0FC"}

package/resources/dir/references.mjs

@@ -0,0 +1,92 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Submit and manage the two business references and one financial reference that vouch for a DIR. References are contacted to confirm the business identity during vetting.
+ */
+export class References extends APIResource {
+    /**
+     * Submit the two business references and one financial reference for a DIR.
+     *
+     * The DIR's authorizer email must be verified first (see the email-verification
+     * endpoint). Until it is, this returns `409` and no references are stored.
+     *
+     * The request body carries exactly two business references plus one financial
+     * reference. On success the references are stored and the response echoes them in
+     * the same shape as the GET. Submitting again converges on the already-stored
+     * references rather than erroring.
+     *
+     * @example
+     * ```ts
+     * const referenceList = await client.dir.references.create(
+     *   '16635d38-75a6-4481-82e8-69af60e05011',
+     *   {
+     *     business_references: [
+     *       {
+     *         email: 'dana.reyes@example.com',
+     *         full_name: 'Dana Reyes',
+     *         phone_e164: '+14155550123',
+     *         timezone: 'America/New_York',
+     *       },
+     *       {
+     *         email: 'dana.reyes@example.com',
+     *         full_name: 'Dana Reyes',
+     *         phone_e164: '+14155550123',
+     *         timezone: 'America/New_York',
+     *       },
+     *     ],
+     *     financial_reference: {
+     *       email: 'dana.reyes@example.com',
+     *       full_name: 'Dana Reyes',
+     *       phone_e164: '+14155550123',
+     *       timezone: 'America/New_York',
+     *     },
+     *   },
+     * );
+     * ```
+     */
+    create(dirID, body, options) {
+        return this._client.post(path `/dir/${dirID}/references`, { body, ...options });
+    }
+    /**
+     * Partially update one reference, addressed by the DIR id plus the reference's
+     * type (business or financial) and slot.
+     *
+     * Cosmetic fields (full name, job title, organization, relationship, email) are
+     * always editable. The phone number and timezone may only be changed while a
+     * scheduled call has not yet been dialed; if a call is in progress or all attempts
+     * are complete, those fields are locked. Changing the timezone reschedules any
+     * pending call into the new local calling window.
+     *
+     * @example
+     * ```ts
+     * const reference = await client.dir.references.update(0, {
+     *   dir_id: '16635d38-75a6-4481-82e8-69af60e05011',
+     *   ref_type: 'business',
+     * });
+     * ```
+     */
+    update(slot, params, options) {
+        const { dir_id, ref_type, ...body } = params;
+        return this._client.patch(path `/dir/${dir_id}/references/${ref_type}/${slot}`, { body, ...options });
+    }
+    /**
+     * List the business and financial references submitted for a DIR.
+     *
+     * Returns the two business references (slots 0 and 1) followed by the single
+     * financial reference. Each entry carries only the customer-supplied details
+     * (name, title, organization, relationship, phone, email, timezone). Returns an
+     * empty list when no references were submitted.
+     *
+     * @example
+     * ```ts
+     * const referenceList = await client.dir.references.list(
+     *   '16635d38-75a6-4481-82e8-69af60e05011',
+     * );
+     * ```
+     */
+    list(dirID, options) {
+        return this._client.get(path `/dir/${dirID}/references`, options);
+    }
+}
+//# sourceMappingURL=references.mjs.map

package/resources/dir/references.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.mjs","sourceRoot":"","sources":["../../src/resources/dir/references.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,MAAM,CAAC,KAAa,EAAE,IAA2B,EAAE,OAAwB;QACzE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,QAAQ,KAAK,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,IAAY,EACZ,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,QAAQ,MAAM,eAAe,QAAQ,IAAI,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,KAAa,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,QAAQ,KAAK,aAAa,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;CACF"}

package/resources/dir/verify-email.d.mts

@@ -0,0 +1,90 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Verify ownership of a DIR's authorizer email. A short code is emailed and confirmed; the email must be verified before references can be submitted.
+ */
+export declare class VerifyEmail extends APIResource {
+    /**
+     * Email a 6-digit code to the DIR's authorizer email to confirm ownership of that
+     * address.
+     *
+     * The code expires in 15 minutes. Requesting a new code invalidates any previous
+     * one. Resends are rate limited (a short cooldown plus a daily cap). Submit the
+     * code to `POST /dir/{dir_id}/verify_email/confirm`.
+     *
+     * @example
+     * ```ts
+     * const emailVerificationStatusWrapped =
+     *   await client.dir.verifyEmail.create(
+     *     '16635d38-75a6-4481-82e8-69af60e05011',
+     *   );
+     * ```
+     */
+    create(dirID: string, options?: RequestOptions): APIPromise<EmailVerificationStatusWrapped>;
+    /**
+     * Whether the DIR's current authorizer email has been verified.
+     *
+     * @example
+     * ```ts
+     * const emailVerificationStatusWrapped =
+     *   await client.dir.verifyEmail.list(
+     *     '16635d38-75a6-4481-82e8-69af60e05011',
+     *   );
+     * ```
+     */
+    list(dirID: string, options?: RequestOptions): APIPromise<EmailVerificationStatusWrapped>;
+    /**
+     * Submit the 6-digit code that was emailed to the DIR's authorizer email. On
+     * success the authorizer email is marked verified.
+     *
+     * For security, any failure (wrong, expired, already-used, or too many attempts)
+     * returns the same generic message.
+     *
+     * @example
+     * ```ts
+     * const emailVerificationStatusWrapped =
+     *   await client.dir.verifyEmail.confirm(
+     *     '16635d38-75a6-4481-82e8-69af60e05011',
+     *     { code: '482915' },
+     *   );
+     * ```
+     */
+    confirm(dirID: string, body: VerifyEmailConfirmParams, options?: RequestOptions): APIPromise<EmailVerificationStatusWrapped>;
+}
+export interface EmailVerificationStatusWrapped {
+    /**
+     * Verification state for a DIR's authorizer email.
+     */
+    data: EmailVerificationStatusWrapped.Data;
+}
+export declare namespace EmailVerificationStatusWrapped {
+    /**
+     * Verification state for a DIR's authorizer email.
+     */
+    interface Data {
+        /**
+         * Whether the DIR's authorizer email has been confirmed.
+         */
+        email_verified: boolean;
+        /**
+         * Always `email_verification`.
+         */
+        record_type: 'email_verification';
+        /**
+         * `sent` after a code is emailed; `verified` after a successful confirm;
+         * `unverified` when no verification is in progress.
+         */
+        status: 'sent' | 'verified' | 'unverified';
+    }
+}
+export interface VerifyEmailConfirmParams {
+    /**
+     * The 6-digit code sent to the authorizer email.
+     */
+    code: string;
+}
+export declare namespace VerifyEmail {
+    export { type EmailVerificationStatusWrapped as EmailVerificationStatusWrapped, type VerifyEmailConfirmParams as VerifyEmailConfirmParams, };
+}
+//# sourceMappingURL=verify-email.d.mts.map

package/resources/dir/verify-email.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-email.d.mts","sourceRoot":"","sources":["../../src/resources/dir/verify-email.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,8BAA8B,CAAC;IAI3F;;;;;;;;;;OAUG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,8BAA8B,CAAC;IAIzF;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CACL,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,wBAAwB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,EAAE,8BAA8B,CAAC,IAAI,CAAC;CAC3C;AAED,yBAAiB,8BAA8B,CAAC;IAC9C;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,cAAc,EAAE,OAAO,CAAC;QAExB;;WAEG;QACH,WAAW,EAAE,oBAAoB,CAAC;QAElC;;;WAGG;QACH,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;KAC5C;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/dir/verify-email.d.ts

@@ -0,0 +1,90 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Verify ownership of a DIR's authorizer email. A short code is emailed and confirmed; the email must be verified before references can be submitted.
+ */
+export declare class VerifyEmail extends APIResource {
+    /**
+     * Email a 6-digit code to the DIR's authorizer email to confirm ownership of that
+     * address.
+     *
+     * The code expires in 15 minutes. Requesting a new code invalidates any previous
+     * one. Resends are rate limited (a short cooldown plus a daily cap). Submit the
+     * code to `POST /dir/{dir_id}/verify_email/confirm`.
+     *
+     * @example
+     * ```ts
+     * const emailVerificationStatusWrapped =
+     *   await client.dir.verifyEmail.create(
+     *     '16635d38-75a6-4481-82e8-69af60e05011',
+     *   );
+     * ```
+     */
+    create(dirID: string, options?: RequestOptions): APIPromise<EmailVerificationStatusWrapped>;
+    /**
+     * Whether the DIR's current authorizer email has been verified.
+     *
+     * @example
+     * ```ts
+     * const emailVerificationStatusWrapped =
+     *   await client.dir.verifyEmail.list(
+     *     '16635d38-75a6-4481-82e8-69af60e05011',
+     *   );
+     * ```
+     */
+    list(dirID: string, options?: RequestOptions): APIPromise<EmailVerificationStatusWrapped>;
+    /**
+     * Submit the 6-digit code that was emailed to the DIR's authorizer email. On
+     * success the authorizer email is marked verified.
+     *
+     * For security, any failure (wrong, expired, already-used, or too many attempts)
+     * returns the same generic message.
+     *
+     * @example
+     * ```ts
+     * const emailVerificationStatusWrapped =
+     *   await client.dir.verifyEmail.confirm(
+     *     '16635d38-75a6-4481-82e8-69af60e05011',
+     *     { code: '482915' },
+     *   );
+     * ```
+     */
+    confirm(dirID: string, body: VerifyEmailConfirmParams, options?: RequestOptions): APIPromise<EmailVerificationStatusWrapped>;
+}
+export interface EmailVerificationStatusWrapped {
+    /**
+     * Verification state for a DIR's authorizer email.
+     */
+    data: EmailVerificationStatusWrapped.Data;
+}
+export declare namespace EmailVerificationStatusWrapped {
+    /**
+     * Verification state for a DIR's authorizer email.
+     */
+    interface Data {
+        /**
+         * Whether the DIR's authorizer email has been confirmed.
+         */
+        email_verified: boolean;
+        /**
+         * Always `email_verification`.
+         */
+        record_type: 'email_verification';
+        /**
+         * `sent` after a code is emailed; `verified` after a successful confirm;
+         * `unverified` when no verification is in progress.
+         */
+        status: 'sent' | 'verified' | 'unverified';
+    }
+}
+export interface VerifyEmailConfirmParams {
+    /**
+     * The 6-digit code sent to the authorizer email.
+     */
+    code: string;
+}
+export declare namespace VerifyEmail {
+    export { type EmailVerificationStatusWrapped as EmailVerificationStatusWrapped, type VerifyEmailConfirmParams as VerifyEmailConfirmParams, };
+}
+//# sourceMappingURL=verify-email.d.ts.map

package/resources/dir/verify-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-email.d.ts","sourceRoot":"","sources":["../../src/resources/dir/verify-email.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,8BAA8B,CAAC;IAI3F;;;;;;;;;;OAUG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,8BAA8B,CAAC;IAIzF;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CACL,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,wBAAwB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,EAAE,8BAA8B,CAAC,IAAI,CAAC;CAC3C;AAED,yBAAiB,8BAA8B,CAAC;IAC9C;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,cAAc,EAAE,OAAO,CAAC;QAExB;;WAEG;QACH,WAAW,EAAE,oBAAoB,CAAC;QAElC;;;WAGG;QACH,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;KAC5C;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}