@namespace("Switchboard")

protocol Package {

  /** The main class for this protocol */
  record Package {
    /** The primary key */
    int id;
    string name;
    string short_description;
    boolean call;
    int call_duration_in_minutes;
    boolean document;
    int max_document_length_in_pages;
    boolean claim_game;
    boolean offline;
    int specialty_id;
    string micro_description;
  }

  record PackageFetchOption {
    /** Which page of records to fetch */
    int page = 1;

    /** How many records per page */
    int per_page = 10;

    int specialty_id;
  }

  /** Returns a list of Packages */
  array<Package> index(PackageFetchOption options);

  /** Return a single Package */
  array<Package> show(int id);
}