/**
 * Phone Numbers namespace — list, search, purchase, get, update, release, bind.
 */
import type { HttpClient } from '../HttpClient.js';
import type { QueryParams } from '../types.js';
import { CrudResource } from '../base/CrudResource.js';
/** Optional companion fields for {@link PhoneNumbersResource.setSwmlWebhook}. */
export interface SetSwmlWebhookExtra {
    [key: string]: unknown;
}
/** Parameters for {@link PhoneNumbersResource.setCxmlWebhook}. */
export interface SetCxmlWebhookParams {
    /** Primary cXML document URL. Serialized as `call_request_url`. */
    url: string;
    /** Fallback URL if the primary request fails. Serialized as `call_fallback_url`. */
    fallbackUrl?: string;
    /** Status callback URL for call status updates. Serialized as `call_status_callback_url`. */
    statusCallbackUrl?: string;
    /** Any additional wire-level fields are passed through verbatim. */
    [key: string]: unknown;
}
/** Parameters for {@link PhoneNumbersResource.setCallFlow}. */
export interface SetCallFlowParams {
    /** Call Flow resource ID. Serialized as `call_flow_id`. */
    flowId: string;
    /**
     * Optional pinned version — `"working_copy"` or `"current_deployed"`
     * (server default when omitted). Serialized as `call_flow_version`.
     */
    version?: string;
    /** Any additional wire-level fields are passed through verbatim. */
    [key: string]: unknown;
}
/** Parameters for {@link PhoneNumbersResource.setRelayTopic}. */
export interface SetRelayTopicParams {
    /** RELAY topic name. Serialized as `call_relay_topic`. */
    topic: string;
    /**
     * Optional status callback URL for RELAY topic delivery updates.
     * Serialized as `call_relay_topic_status_callback_url`.
     */
    statusCallbackUrl?: string;
    /** Any additional wire-level fields are passed through verbatim. */
    [key: string]: unknown;
}
/**
 * Phone number management.
 *
 * Supports the standard CRUD surface plus typed helpers for binding an
 * inbound call to a handler (SWML webhook, cXML webhook, AI agent, call
 * flow, RELAY application/topic). The binding model is: set `call_handler`
 * + the handler-specific companion field on the phone number; the server
 * auto-materializes the matching Fabric resource. See
 * {@link PhoneCallHandler} for the enum of valid `call_handler` values.
 *
 * `create` and `update` accept an untyped body object (`body: any = {}`).
 * No `PhoneNumberCreateParams` / `PhoneNumberUpdateParams` interfaces are
 * defined because the Python reference SDK uses bare `**kwargs` with no
 * named or typed parameters — there is no Python type contract to port.
 * This is an intentional IDIOMATIC_DEVIATION: Python kwargs ↔ TS `any` object
 * literal with an optional default of `{}` to preserve call-without-args
 * semantics.  If the REST API stabilises a known field set, consider adding
 * typed interfaces and specialising `CrudResource<>` generics here.
 */
export declare class PhoneNumbersResource extends CrudResource {
    protected _updateMethod: 'PATCH' | 'PUT';
    constructor(http: HttpClient);
    /**
     * Purchase / create a phone number resource in this project.
     * Body is optional to match Python's `**kwargs` call convention.
     *
     * @param body - Phone-number creation payload (platform-shaped JSON).
     *   Defaults to `{}` when omitted.
     * @returns The newly-created phone-number resource.
     * @throws {RestError} On any non-2xx HTTP response.
     *
     * @example
     * ```ts
     * const num = await client.phoneNumbers.create({ number: '+15551234567' });
     * ```
     */
    create(body?: any): Promise<any>;
    /**
     * Update a phone number resource by ID. Body is optional to match Python `**kwargs`.
     *
     * Setting `call_handler` + the matching companion field (see
     * {@link PhoneCallHandler}) on the phone number auto-materializes the
     * matching Fabric resource on the server; prefer the `set*` helpers
     * below for the common cases.
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param body - Partial update payload. Defaults to `{}`.
     * @returns The updated phone-number resource.
     * @throws {RestError} On any non-2xx HTTP response.
     */
    update(resourceId: string, body?: any): Promise<any>;
    /**
     * Search available phone numbers for purchase.
     *
     * @param params - Search filters (e.g. `areaCode`, `contains`, `region`,
     *   `number_type`, pagination).
     * @returns A paginated list of matching available numbers.
     * @throws {RestError} On any non-2xx HTTP response.
     *
     * @example
     * ```ts
     * const results = await client.phoneNumbers.search({ areaCode: '512', contains: '5555' });
     * ```
     */
    search(params?: QueryParams): Promise<any>;
    /**
     * Route inbound calls to an SWML webhook URL.
     *
     * Your backend returns an SWML document per call. The server
     * auto-creates a `swml_webhook` Fabric resource keyed off this URL —
     * you do **not** need to call `fabric.swmlWebhooks.create` or
     * `fabric.resources.assignPhoneRoute`.
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param url - Your backend's SWML endpoint.
     * @param extra - Additional wire-level fields (e.g. `name`) merged into
     *   the PUT body.
     * @returns The updated phone-number resource.
     *
     * @example
     * ```ts
     * await client.phoneNumbers.setSwmlWebhook('pn-1', 'https://example.com/swml');
     * ```
     */
    setSwmlWebhook(resourceId: string, url: string, extra?: SetSwmlWebhookExtra): Promise<any>;
    /**
     * Route inbound calls to a cXML (Twilio-compat / LAML) webhook.
     *
     * Despite the wire value `laml_webhooks` being plural, this creates a
     * single `cxml_webhook` Fabric resource.  `fallbackUrl` is used when the
     * primary URL fails; `statusCallbackUrl` receives call status updates.
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param params - URL and optional fallback/status URLs plus any extra
     *   wire-level fields.
     * @returns The updated phone-number resource.
     *
     * @example
     * ```ts
     * await client.phoneNumbers.setCxmlWebhook('pn-1', {
     *   url: 'https://example.com/voice.xml',
     *   fallbackUrl: 'https://example.com/fallback.xml',
     * });
     * ```
     */
    setCxmlWebhook(resourceId: string, params: SetCxmlWebhookParams): Promise<any>;
    /**
     * Route inbound calls to an existing cXML application by ID.
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param applicationId - cXML application ID.
     * @param extra - Additional wire-level fields merged into the body.
     * @returns The updated phone-number resource.
     */
    setCxmlApplication(resourceId: string, applicationId: string, extra?: Record<string, unknown>): Promise<any>;
    /**
     * Route inbound calls to an AI Agent Fabric resource by ID.
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param agentId - AI agent Fabric resource ID.
     * @param extra - Additional wire-level fields merged into the body.
     * @returns The updated phone-number resource.
     */
    setAiAgent(resourceId: string, agentId: string, extra?: Record<string, unknown>): Promise<any>;
    /**
     * Route inbound calls to a Call Flow by ID.
     *
     * `version` accepts `"working_copy"` or `"current_deployed"` (server
     * default when omitted).
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param params - Flow ID and optional pinned version plus any extra
     *   wire-level fields.
     * @returns The updated phone-number resource.
     */
    setCallFlow(resourceId: string, params: SetCallFlowParams): Promise<any>;
    /**
     * Route inbound calls to a named RELAY application.
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param name - RELAY application name.
     * @param extra - Additional wire-level fields merged into the body.
     * @returns The updated phone-number resource.
     */
    setRelayApplication(resourceId: string, name: string, extra?: Record<string, unknown>): Promise<any>;
    /**
     * Route inbound calls to a RELAY topic (client subscription).
     *
     * @param resourceId - Unique phone-number resource ID.
     * @param params - Topic name and optional status-callback URL plus any
     *   extra wire-level fields.
     * @returns The updated phone-number resource.
     */
    setRelayTopic(resourceId: string, params: SetRelayTopicParams): Promise<any>;
}