<?php

/**
 * This code was generated by
 * \ / _    _  _|   _  _
 * | (_)\/(_)(_|\/| |(/_  v1.0.0
 * /       /
 */

namespace Twilio\Rest\Proxy\V1;

use Twilio\Options;
use Twilio\Values;

/**
 * PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
 */
abstract class ServiceOptions {
    /**
     * @param int $defaultTtl Default TTL for a Session, in seconds
     * @param string $callbackUrl The URL we should call when the interaction
     *                            status changes
     * @param string $geoMatchLevel Where a proxy number must be located relative
     *                              to the participant identifier
     * @param string $numberSelectionBehavior The preference for Proxy Number
     *                                        selection for the Service instance
     * @param string $interceptCallbackUrl The URL we call on each interaction
     * @param string $outOfSessionCallbackUrl The URL we call when an inbound call
     *                                        or SMS action occurs on a closed or
     *                                        non-existent Session
     * @param string $chatInstanceSid The SID of the Chat Service Instance
     * @return CreateServiceOptions Options builder
     */
    public static function create(int $defaultTtl = Values::NONE, string $callbackUrl = Values::NONE, string $geoMatchLevel = Values::NONE, string $numberSelectionBehavior = Values::NONE, string $interceptCallbackUrl = Values::NONE, string $outOfSessionCallbackUrl = Values::NONE, string $chatInstanceSid = Values::NONE): CreateServiceOptions {
        return new CreateServiceOptions($defaultTtl, $callbackUrl, $geoMatchLevel, $numberSelectionBehavior, $interceptCallbackUrl, $outOfSessionCallbackUrl, $chatInstanceSid);
    }

    /**
     * @param string $uniqueName An application-defined string that uniquely
     *                           identifies the resource
     * @param int $defaultTtl Default TTL for a Session, in seconds
     * @param string $callbackUrl The URL we should call when the interaction
     *                            status changes
     * @param string $geoMatchLevel Where a proxy number must be located relative
     *                              to the participant identifier
     * @param string $numberSelectionBehavior The preference for Proxy Number
     *                                        selection for the Service instance
     * @param string $interceptCallbackUrl The URL we call on each interaction
     * @param string $outOfSessionCallbackUrl The URL we call when an inbound call
     *                                        or SMS action occurs on a closed or
     *                                        non-existent Session
     * @param string $chatInstanceSid The SID of the Chat Service Instance
     * @return UpdateServiceOptions Options builder
     */
    public static function update(string $uniqueName = Values::NONE, int $defaultTtl = Values::NONE, string $callbackUrl = Values::NONE, string $geoMatchLevel = Values::NONE, string $numberSelectionBehavior = Values::NONE, string $interceptCallbackUrl = Values::NONE, string $outOfSessionCallbackUrl = Values::NONE, string $chatInstanceSid = Values::NONE): UpdateServiceOptions {
        return new UpdateServiceOptions($uniqueName, $defaultTtl, $callbackUrl, $geoMatchLevel, $numberSelectionBehavior, $interceptCallbackUrl, $outOfSessionCallbackUrl, $chatInstanceSid);
    }
}

class CreateServiceOptions extends Options {
    /**
     * @param int $defaultTtl Default TTL for a Session, in seconds
     * @param string $callbackUrl The URL we should call when the interaction
     *                            status changes
     * @param string $geoMatchLevel Where a proxy number must be located relative
     *                              to the participant identifier
     * @param string $numberSelectionBehavior The preference for Proxy Number
     *                                        selection for the Service instance
     * @param string $interceptCallbackUrl The URL we call on each interaction
     * @param string $outOfSessionCallbackUrl The URL we call when an inbound call
     *                                        or SMS action occurs on a closed or
     *                                        non-existent Session
     * @param string $chatInstanceSid The SID of the Chat Service Instance
     */
    public function __construct(int $defaultTtl = Values::NONE, string $callbackUrl = Values::NONE, string $geoMatchLevel = Values::NONE, string $numberSelectionBehavior = Values::NONE, string $interceptCallbackUrl = Values::NONE, string $outOfSessionCallbackUrl = Values::NONE, string $chatInstanceSid = Values::NONE) {
        $this->options['defaultTtl'] = $defaultTtl;
        $this->options['callbackUrl'] = $callbackUrl;
        $this->options['geoMatchLevel'] = $geoMatchLevel;
        $this->options['numberSelectionBehavior'] = $numberSelectionBehavior;
        $this->options['interceptCallbackUrl'] = $interceptCallbackUrl;
        $this->options['outOfSessionCallbackUrl'] = $outOfSessionCallbackUrl;
        $this->options['chatInstanceSid'] = $chatInstanceSid;
    }

    /**
     * The default `ttl` value to set for Sessions created in the Service. The TTL (time to live) is measured in seconds after the Session's last create or last Interaction. The default value of `0` indicates an unlimited Session length. You can override a Session's default TTL value by setting its `ttl` value.
     *
     * @param int $defaultTtl Default TTL for a Session, in seconds
     * @return $this Fluent Builder
     */
    public function setDefaultTtl(int $defaultTtl): self {
        $this->options['defaultTtl'] = $defaultTtl;
        return $this;
    }

    /**
     * The URL we should call when the interaction status changes.
     *
     * @param string $callbackUrl The URL we should call when the interaction
     *                            status changes
     * @return $this Fluent Builder
     */
    public function setCallbackUrl(string $callbackUrl): self {
        $this->options['callbackUrl'] = $callbackUrl;
        return $this;
    }

    /**
     * Where a proxy number must be located relative to the participant identifier. Can be: `country`, `area-code`, or `extended-area-code`. The default value is `country` and more specific areas than `country` are only available in North America.
     *
     * @param string $geoMatchLevel Where a proxy number must be located relative
     *                              to the participant identifier
     * @return $this Fluent Builder
     */
    public function setGeoMatchLevel(string $geoMatchLevel): self {
        $this->options['geoMatchLevel'] = $geoMatchLevel;
        return $this;
    }

    /**
     * The preference for Proxy Number selection in the Service instance. Can be: `prefer-sticky` or `avoid-sticky` and the default is `prefer-sticky`. `prefer-sticky` means that we will try and select the same Proxy Number for a given participant if they have previous [Sessions](https://www.twilio.com/docs/proxy/api/session), but we will not fail if that Proxy Number cannot be used.  `avoid-sticky` means that we will try to use different Proxy Numbers as long as that is possible within a given pool rather than try and use a previously assigned number.
     *
     * @param string $numberSelectionBehavior The preference for Proxy Number
     *                                        selection for the Service instance
     * @return $this Fluent Builder
     */
    public function setNumberSelectionBehavior(string $numberSelectionBehavior): self {
        $this->options['numberSelectionBehavior'] = $numberSelectionBehavior;
        return $this;
    }

    /**
     * The URL we call on each interaction. If we receive a 403 status, we block the interaction; otherwise the interaction continues.
     *
     * @param string $interceptCallbackUrl The URL we call on each interaction
     * @return $this Fluent Builder
     */
    public function setInterceptCallbackUrl(string $interceptCallbackUrl): self {
        $this->options['interceptCallbackUrl'] = $interceptCallbackUrl;
        return $this;
    }

    /**
     * The URL we should call when an inbound call or SMS action occurs on a closed or non-existent Session. If your server (or a Twilio [function](https://www.twilio.com/functions)) responds with valid [TwiML](https://www.twilio.com/docs/voice/twiml), we will process it. This means it is possible, for example, to play a message for a call, send an automated text message response, or redirect a call to another Phone Number. See [Out-of-Session Callback Response Guide](https://www.twilio.com/docs/proxy/out-session-callback-response-guide) for more information.
     *
     * @param string $outOfSessionCallbackUrl The URL we call when an inbound call
     *                                        or SMS action occurs on a closed or
     *                                        non-existent Session
     * @return $this Fluent Builder
     */
    public function setOutOfSessionCallbackUrl(string $outOfSessionCallbackUrl): self {
        $this->options['outOfSessionCallbackUrl'] = $outOfSessionCallbackUrl;
        return $this;
    }

    /**
     * The SID of the Chat Service Instance managed by Proxy Service. The Chat Service enables Proxy to forward SMS and channel messages to this chat instance. This is a one-to-one relationship.
     *
     * @param string $chatInstanceSid The SID of the Chat Service Instance
     * @return $this Fluent Builder
     */
    public function setChatInstanceSid(string $chatInstanceSid): self {
        $this->options['chatInstanceSid'] = $chatInstanceSid;
        return $this;
    }

    /**
     * Provide a friendly representation
     *
     * @return string Machine friendly representation
     */
    public function __toString(): string {
        $options = \http_build_query(Values::of($this->options), '', ' ');
        return '[Twilio.Proxy.V1.CreateServiceOptions ' . $options . ']';
    }
}

class UpdateServiceOptions extends Options {
    /**
     * @param string $uniqueName An application-defined string that uniquely
     *                           identifies the resource
     * @param int $defaultTtl Default TTL for a Session, in seconds
     * @param string $callbackUrl The URL we should call when the interaction
     *                            status changes
     * @param string $geoMatchLevel Where a proxy number must be located relative
     *                              to the participant identifier
     * @param string $numberSelectionBehavior The preference for Proxy Number
     *                                        selection for the Service instance
     * @param string $interceptCallbackUrl The URL we call on each interaction
     * @param string $outOfSessionCallbackUrl The URL we call when an inbound call
     *                                        or SMS action occurs on a closed or
     *                                        non-existent Session
     * @param string $chatInstanceSid The SID of the Chat Service Instance
     */
    public function __construct(string $uniqueName = Values::NONE, int $defaultTtl = Values::NONE, string $callbackUrl = Values::NONE, string $geoMatchLevel = Values::NONE, string $numberSelectionBehavior = Values::NONE, string $interceptCallbackUrl = Values::NONE, string $outOfSessionCallbackUrl = Values::NONE, string $chatInstanceSid = Values::NONE) {
        $this->options['uniqueName'] = $uniqueName;
        $this->options['defaultTtl'] = $defaultTtl;
        $this->options['callbackUrl'] = $callbackUrl;
        $this->options['geoMatchLevel'] = $geoMatchLevel;
        $this->options['numberSelectionBehavior'] = $numberSelectionBehavior;
        $this->options['interceptCallbackUrl'] = $interceptCallbackUrl;
        $this->options['outOfSessionCallbackUrl'] = $outOfSessionCallbackUrl;
        $this->options['chatInstanceSid'] = $chatInstanceSid;
    }

    /**
     * An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. **This value should not have PII.**
     *
     * @param string $uniqueName An application-defined string that uniquely
     *                           identifies the resource
     * @return $this Fluent Builder
     */
    public function setUniqueName(string $uniqueName): self {
        $this->options['uniqueName'] = $uniqueName;
        return $this;
    }

    /**
     * The default `ttl` value to set for Sessions created in the Service. The TTL (time to live) is measured in seconds after the Session's last create or last Interaction. The default value of `0` indicates an unlimited Session length. You can override a Session's default TTL value by setting its `ttl` value.
     *
     * @param int $defaultTtl Default TTL for a Session, in seconds
     * @return $this Fluent Builder
     */
    public function setDefaultTtl(int $defaultTtl): self {
        $this->options['defaultTtl'] = $defaultTtl;
        return $this;
    }

    /**
     * The URL we should call when the interaction status changes.
     *
     * @param string $callbackUrl The URL we should call when the interaction
     *                            status changes
     * @return $this Fluent Builder
     */
    public function setCallbackUrl(string $callbackUrl): self {
        $this->options['callbackUrl'] = $callbackUrl;
        return $this;
    }

    /**
     * Where a proxy number must be located relative to the participant identifier. Can be: `country`, `area-code`, or `extended-area-code`. The default value is `country` and more specific areas than `country` are only available in North America.
     *
     * @param string $geoMatchLevel Where a proxy number must be located relative
     *                              to the participant identifier
     * @return $this Fluent Builder
     */
    public function setGeoMatchLevel(string $geoMatchLevel): self {
        $this->options['geoMatchLevel'] = $geoMatchLevel;
        return $this;
    }

    /**
     * The preference for Proxy Number selection in the Service instance. Can be: `prefer-sticky` or `avoid-sticky` and the default is `prefer-sticky`. `prefer-sticky` means that we will try and select the same Proxy Number for a given participant if they have previous [Sessions](https://www.twilio.com/docs/proxy/api/session), but we will not fail if that Proxy Number cannot be used.  `avoid-sticky` means that we will try to use different Proxy Numbers as long as that is possible within a given pool rather than try and use a previously assigned number.
     *
     * @param string $numberSelectionBehavior The preference for Proxy Number
     *                                        selection for the Service instance
     * @return $this Fluent Builder
     */
    public function setNumberSelectionBehavior(string $numberSelectionBehavior): self {
        $this->options['numberSelectionBehavior'] = $numberSelectionBehavior;
        return $this;
    }

    /**
     * The URL we call on each interaction. If we receive a 403 status, we block the interaction; otherwise the interaction continues.
     *
     * @param string $interceptCallbackUrl The URL we call on each interaction
     * @return $this Fluent Builder
     */
    public function setInterceptCallbackUrl(string $interceptCallbackUrl): self {
        $this->options['interceptCallbackUrl'] = $interceptCallbackUrl;
        return $this;
    }

    /**
     * The URL we should call when an inbound call or SMS action occurs on a closed or non-existent Session. If your server (or a Twilio [function](https://www.twilio.com/functions)) responds with valid [TwiML](https://www.twilio.com/docs/voice/twiml), we will process it. This means it is possible, for example, to play a message for a call, send an automated text message response, or redirect a call to another Phone Number. See [Out-of-Session Callback Response Guide](https://www.twilio.com/docs/proxy/out-session-callback-response-guide) for more information.
     *
     * @param string $outOfSessionCallbackUrl The URL we call when an inbound call
     *                                        or SMS action occurs on a closed or
     *                                        non-existent Session
     * @return $this Fluent Builder
     */
    public function setOutOfSessionCallbackUrl(string $outOfSessionCallbackUrl): self {
        $this->options['outOfSessionCallbackUrl'] = $outOfSessionCallbackUrl;
        return $this;
    }

    /**
     * The SID of the Chat Service Instance managed by Proxy Service. The Chat Service enables Proxy to forward SMS and channel messages to this chat instance. This is a one-to-one relationship.
     *
     * @param string $chatInstanceSid The SID of the Chat Service Instance
     * @return $this Fluent Builder
     */
    public function setChatInstanceSid(string $chatInstanceSid): self {
        $this->options['chatInstanceSid'] = $chatInstanceSid;
        return $this;
    }

    /**
     * Provide a friendly representation
     *
     * @return string Machine friendly representation
     */
    public function __toString(): string {
        $options = \http_build_query(Values::of($this->options), '', ' ');
        return '[Twilio.Proxy.V1.UpdateServiceOptions ' . $options . ']';
    }
}