assignedAddOnExtension.ts

/*
 * This code was generated by
 * ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
 *  |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
 *  |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
 *
 * Twilio - Api
 * This is the public Twilio REST API.
 *
 * NOTE: This class is auto generated by OpenAPI Generator.
 * https://openapi-generator.tech
 * Do not edit the class manually.
 */

import { inspect, InspectOptions } from "util";
import Page, { TwilioResponsePayload } from "../../../../../../base/Page";
import Response from "../../../../../../http/response";
import V2010 from "../../../../V2010";
const deserialize = require("../../../../../../base/deserialize");
const serialize = require("../../../../../../base/serialize");
import { isValidPathParam } from "../../../../../../base/utility";

/**
 * Options to pass to each
 */
export interface AssignedAddOnExtensionListInstanceEachOptions {
  /** How many resources to return in each list page. The default is 50, and the maximum is 1000. */
  pageSize?: number;
  /** Function to process each record. If this and a positional callback are passed, this one will be used */
  callback?: (
    item: AssignedAddOnExtensionInstance,
    done: (err?: Error) => void
  ) => void;
  /** Function to be called upon completion of streaming */
  done?: Function;
  /** Upper limit for the number of records to return. each() guarantees never to return more than limit. Default is no limit */
  limit?: number;
}

/**
 * Options to pass to list
 */
export interface AssignedAddOnExtensionListInstanceOptions {
  /** How many resources to return in each list page. The default is 50, and the maximum is 1000. */
  pageSize?: number;
  /** Upper limit for the number of records to return. list() guarantees never to return more than limit. Default is no limit */
  limit?: number;
}

/**
 * Options to pass to page
 */
export interface AssignedAddOnExtensionListInstancePageOptions {
  /** How many resources to return in each list page. The default is 50, and the maximum is 1000. */
  pageSize?: number;
  /** Page Number, this value is simply for client state */
  pageNumber?: number;
  /** PageToken provided by the API */
  pageToken?: string;
}

export interface AssignedAddOnExtensionContext {
  /**
   * Fetch a AssignedAddOnExtensionInstance
   *
   * @param callback - Callback to handle processed record
   *
   * @returns Resolves to processed AssignedAddOnExtensionInstance
   */
  fetch(
    callback?: (
      error: Error | null,
      item?: AssignedAddOnExtensionInstance
    ) => any
  ): Promise<AssignedAddOnExtensionInstance>;

  /**
   * Provide a user-friendly representation
   */
  toJSON(): any;
  [inspect.custom](_depth: any, options: InspectOptions): any;
}

export interface AssignedAddOnExtensionContextSolution {
  accountSid: string;
  resourceSid: string;
  assignedAddOnSid: string;
  sid: string;
}

export class AssignedAddOnExtensionContextImpl
  implements AssignedAddOnExtensionContext
{
  protected _solution: AssignedAddOnExtensionContextSolution;
  protected _uri: string;

  constructor(
    protected _version: V2010,
    accountSid: string,
    resourceSid: string,
    assignedAddOnSid: string,
    sid: string
  ) {
    if (!isValidPathParam(accountSid)) {
      throw new Error("Parameter 'accountSid' is not valid.");
    }

    if (!isValidPathParam(resourceSid)) {
      throw new Error("Parameter 'resourceSid' is not valid.");
    }

    if (!isValidPathParam(assignedAddOnSid)) {
      throw new Error("Parameter 'assignedAddOnSid' is not valid.");
    }

    if (!isValidPathParam(sid)) {
      throw new Error("Parameter 'sid' is not valid.");
    }

    this._solution = { accountSid, resourceSid, assignedAddOnSid, sid };
    this._uri = `/Accounts/${accountSid}/IncomingPhoneNumbers/${resourceSid}/AssignedAddOns/${assignedAddOnSid}/Extensions/${sid}.json`;
  }

  fetch(
    callback?: (
      error: Error | null,
      item?: AssignedAddOnExtensionInstance
    ) => any
  ): Promise<AssignedAddOnExtensionInstance> {
    const instance = this;
    let operationVersion = instance._version,
      operationPromise = operationVersion.fetch({
        uri: instance._uri,
        method: "get",
      });

    operationPromise = operationPromise.then(
      (payload) =>
        new AssignedAddOnExtensionInstance(
          operationVersion,
          payload,
          instance._solution.accountSid,
          instance._solution.resourceSid,
          instance._solution.assignedAddOnSid,
          instance._solution.sid
        )
    );

    operationPromise = instance._version.setPromiseCallback(
      operationPromise,
      callback
    );
    return operationPromise;
  }

  /**
   * Provide a user-friendly representation
   *
   * @returns Object
   */
  toJSON() {
    return this._solution;
  }

  [inspect.custom](_depth: any, options: InspectOptions) {
    return inspect(this.toJSON(), options);
  }
}

interface AssignedAddOnExtensionPayload extends TwilioResponsePayload {
  extensions: AssignedAddOnExtensionResource[];
}

interface AssignedAddOnExtensionResource {
  sid: string;
  account_sid: string;
  resource_sid: string;
  assigned_add_on_sid: string;
  friendly_name: string;
  product_name: string;
  unique_name: string;
  uri: string;
  enabled: boolean;
}

export class AssignedAddOnExtensionInstance {
  protected _solution: AssignedAddOnExtensionContextSolution;
  protected _context?: AssignedAddOnExtensionContext;

  constructor(
    protected _version: V2010,
    payload: AssignedAddOnExtensionResource,
    accountSid: string,
    resourceSid: string,
    assignedAddOnSid: string,
    sid?: string
  ) {
    this.sid = payload.sid;
    this.accountSid = payload.account_sid;
    this.resourceSid = payload.resource_sid;
    this.assignedAddOnSid = payload.assigned_add_on_sid;
    this.friendlyName = payload.friendly_name;
    this.productName = payload.product_name;
    this.uniqueName = payload.unique_name;
    this.uri = payload.uri;
    this.enabled = payload.enabled;

    this._solution = {
      accountSid,
      resourceSid,
      assignedAddOnSid,
      sid: sid || this.sid,
    };
  }

  /**
   * The unique string that that we created to identify the resource.
   */
  sid: string;
  /**
   * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the resource.
   */
  accountSid: string;
  /**
   * The SID of the Phone Number to which the Add-on is assigned.
   */
  resourceSid: string;
  /**
   * The SID that uniquely identifies the assigned Add-on installation.
   */
  assignedAddOnSid: string;
  /**
   * The string that you assigned to describe the resource.
   */
  friendlyName: string;
  /**
   * A string that you assigned to describe the Product this Extension is used within.
   */
  productName: string;
  /**
   * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource.
   */
  uniqueName: string;
  /**
   * The URI of the resource, relative to `https://api.twilio.com`.
   */
  uri: string;
  /**
   * Whether the Extension will be invoked.
   */
  enabled: boolean;

  private get _proxy(): AssignedAddOnExtensionContext {
    this._context =
      this._context ||
      new AssignedAddOnExtensionContextImpl(
        this._version,
        this._solution.accountSid,
        this._solution.resourceSid,
        this._solution.assignedAddOnSid,
        this._solution.sid
      );
    return this._context;
  }

  /**
   * Fetch a AssignedAddOnExtensionInstance
   *
   * @param callback - Callback to handle processed record
   *
   * @returns Resolves to processed AssignedAddOnExtensionInstance
   */
  fetch(
    callback?: (
      error: Error | null,
      item?: AssignedAddOnExtensionInstance
    ) => any
  ): Promise<AssignedAddOnExtensionInstance> {
    return this._proxy.fetch(callback);
  }

  /**
   * Provide a user-friendly representation
   *
   * @returns Object
   */
  toJSON() {
    return {
      sid: this.sid,
      accountSid: this.accountSid,
      resourceSid: this.resourceSid,
      assignedAddOnSid: this.assignedAddOnSid,
      friendlyName: this.friendlyName,
      productName: this.productName,
      uniqueName: this.uniqueName,
      uri: this.uri,
      enabled: this.enabled,
    };
  }

  [inspect.custom](_depth: any, options: InspectOptions) {
    return inspect(this.toJSON(), options);
  }
}

export interface AssignedAddOnExtensionSolution {
  accountSid: string;
  resourceSid: string;
  assignedAddOnSid: string;
}

export interface AssignedAddOnExtensionListInstance {
  _version: V2010;
  _solution: AssignedAddOnExtensionSolution;
  _uri: string;

  (sid: string): AssignedAddOnExtensionContext;
  get(sid: string): AssignedAddOnExtensionContext;

  /**
   * Streams AssignedAddOnExtensionInstance records from the API.
   *
   * This operation lazily loads records as efficiently as possible until the limit
   * is reached.
   *
   * The results are passed into the callback function, so this operation is memory
   * efficient.
   *
   * If a function is passed as the first argument, it will be used as the callback
   * function.
   *
   * @param { AssignedAddOnExtensionListInstanceEachOptions } [params] - Options for request
   * @param { function } [callback] - Function to process each record
   */
  each(
    callback?: (
      item: AssignedAddOnExtensionInstance,
      done: (err?: Error) => void
    ) => void
  ): void;
  each(
    params: AssignedAddOnExtensionListInstanceEachOptions,
    callback?: (
      item: AssignedAddOnExtensionInstance,
      done: (err?: Error) => void
    ) => void
  ): void;
  /**
   * Retrieve a single target page of AssignedAddOnExtensionInstance records from the API.
   *
   * The request is executed immediately.
   *
   * @param { string } [targetUrl] - API-generated URL for the requested results page
   * @param { function } [callback] - Callback to handle list of records
   */
  getPage(
    targetUrl: string,
    callback?: (error: Error | null, items: AssignedAddOnExtensionPage) => any
  ): Promise<AssignedAddOnExtensionPage>;
  /**
   * Lists AssignedAddOnExtensionInstance records from the API as a list.
   *
   * If a function is passed as the first argument, it will be used as the callback
   * function.
   *
   * @param { AssignedAddOnExtensionListInstanceOptions } [params] - Options for request
   * @param { function } [callback] - Callback to handle list of records
   */
  list(
    callback?: (
      error: Error | null,
      items: AssignedAddOnExtensionInstance[]
    ) => any
  ): Promise<AssignedAddOnExtensionInstance[]>;
  list(
    params: AssignedAddOnExtensionListInstanceOptions,
    callback?: (
      error: Error | null,
      items: AssignedAddOnExtensionInstance[]
    ) => any
  ): Promise<AssignedAddOnExtensionInstance[]>;
  /**
   * Retrieve a single page of AssignedAddOnExtensionInstance records from the API.
   *
   * The request is executed immediately.
   *
   * If a function is passed as the first argument, it will be used as the callback
   * function.
   *
   * @param { AssignedAddOnExtensionListInstancePageOptions } [params] - Options for request
   * @param { function } [callback] - Callback to handle list of records
   */
  page(
    callback?: (error: Error | null, items: AssignedAddOnExtensionPage) => any
  ): Promise<AssignedAddOnExtensionPage>;
  page(
    params: AssignedAddOnExtensionListInstancePageOptions,
    callback?: (error: Error | null, items: AssignedAddOnExtensionPage) => any
  ): Promise<AssignedAddOnExtensionPage>;

  /**
   * Provide a user-friendly representation
   */
  toJSON(): any;
  [inspect.custom](_depth: any, options: InspectOptions): any;
}

export function AssignedAddOnExtensionListInstance(
  version: V2010,
  accountSid: string,
  resourceSid: string,
  assignedAddOnSid: string
): AssignedAddOnExtensionListInstance {
  if (!isValidPathParam(accountSid)) {
    throw new Error("Parameter 'accountSid' is not valid.");
  }

  if (!isValidPathParam(resourceSid)) {
    throw new Error("Parameter 'resourceSid' is not valid.");
  }

  if (!isValidPathParam(assignedAddOnSid)) {
    throw new Error("Parameter 'assignedAddOnSid' is not valid.");
  }

  const instance = ((sid) =>
    instance.get(sid)) as AssignedAddOnExtensionListInstance;

  instance.get = function get(sid): AssignedAddOnExtensionContext {
    return new AssignedAddOnExtensionContextImpl(
      version,
      accountSid,
      resourceSid,
      assignedAddOnSid,
      sid
    );
  };

  instance._version = version;
  instance._solution = { accountSid, resourceSid, assignedAddOnSid };
  instance._uri = `/Accounts/${accountSid}/IncomingPhoneNumbers/${resourceSid}/AssignedAddOns/${assignedAddOnSid}/Extensions.json`;

  instance.page = function page(
    params?:
      | AssignedAddOnExtensionListInstancePageOptions
      | ((error: Error | null, items: AssignedAddOnExtensionPage) => any),
    callback?: (error: Error | null, items: AssignedAddOnExtensionPage) => any
  ): Promise<AssignedAddOnExtensionPage> {
    if (params instanceof Function) {
      callback = params;
      params = {};
    } else {
      params = params || {};
    }

    let data: any = {};

    if (params["pageSize"] !== undefined) data["PageSize"] = params["pageSize"];

    if (params.pageNumber !== undefined) data["Page"] = params.pageNumber;
    if (params.pageToken !== undefined) data["PageToken"] = params.pageToken;

    const headers: any = {};

    let operationVersion = version,
      operationPromise = operationVersion.page({
        uri: instance._uri,
        method: "get",
        params: data,
        headers,
      });

    operationPromise = operationPromise.then(
      (payload) =>
        new AssignedAddOnExtensionPage(
          operationVersion,
          payload,
          instance._solution
        )
    );

    operationPromise = instance._version.setPromiseCallback(
      operationPromise,
      callback
    );
    return operationPromise;
  };
  instance.each = instance._version.each;
  instance.list = instance._version.list;

  instance.getPage = function getPage(
    targetUrl: string,
    callback?: (error: Error | null, items: AssignedAddOnExtensionPage) => any
  ): Promise<AssignedAddOnExtensionPage> {
    const operationPromise = instance._version._domain.twilio.request({
      method: "get",
      uri: targetUrl,
    });

    let pagePromise = operationPromise.then(
      (payload) =>
        new AssignedAddOnExtensionPage(
          instance._version,
          payload,
          instance._solution
        )
    );
    pagePromise = instance._version.setPromiseCallback(pagePromise, callback);
    return pagePromise;
  };

  instance.toJSON = function toJSON() {
    return instance._solution;
  };

  instance[inspect.custom] = function inspectImpl(
    _depth: any,
    options: InspectOptions
  ) {
    return inspect(instance.toJSON(), options);
  };

  return instance;
}

export class AssignedAddOnExtensionPage extends Page<
  V2010,
  AssignedAddOnExtensionPayload,
  AssignedAddOnExtensionResource,
  AssignedAddOnExtensionInstance
> {
  /**
   * Initialize the AssignedAddOnExtensionPage
   *
   * @param version - Version of the resource
   * @param response - Response from the API
   * @param solution - Path solution
   */
  constructor(
    version: V2010,
    response: Response<string>,
    solution: AssignedAddOnExtensionSolution
  ) {
    super(version, response, solution);
  }

  /**
   * Build an instance of AssignedAddOnExtensionInstance
   *
   * @param payload - Payload response from the API
   */
  getInstance(
    payload: AssignedAddOnExtensionResource
  ): AssignedAddOnExtensionInstance {
    return new AssignedAddOnExtensionInstance(
      this._version,
      payload,
      this._solution.accountSid,
      this._solution.resourceSid,
      this._solution.assignedAddOnSid
    );
  }

  [inspect.custom](depth: any, options: InspectOptions) {
    return inspect(this.toJSON(), options);
  }
}