0.0.5

API/Client.php

@@ -8,19 +8,18 @@
 abstract class Client extends \Df\API\Client {
 	/**
 	 * 2017-07-06
-	 * @return S
+	 * @override
+	 * @see \Df\API\Client::_construct()
+	 * @used-by \Df\API\Client::__construct()
+	 * @see \Df\ZohoBI\API\Client::_construct()
 	 */
-	final protected function ss() {return S::convention($this, S::class);}
+	protected function _construct() {parent::_construct(); $this->addFilterJsonDecode();}
 
 	/**
-	 * 2017-07-05
-	 * @override
-	 * @see \Df\API\Client::responseFilterC()
-	 * @used-by \Df\API\Client::p()
-	 * @used-by p()
-	 * @return string
+	 * 2017-07-06
+	 * @return S
 	 */
-	protected function responseFilterC() {return \Df\API\Response\Filter\JSON::class;}
+	final protected function ss() {return S::convention($this, S::class);}
 
 	/**
 	 * 2017-07-06

App.php

@@ -0,0 +1,41 @@
+<?php
+namespace Df\Zoho;
+/**
+ * 2017-07-06
+ * @see \Df\ZohoBI\App
+ * @see \Dfe\ZohoCRM\App
+ */
+abstract class App {
+	/**
+	 * 2017-07-06
+	 * @final I do not use the PHP «final» keyword here to allow refine the return type using PHPDoc.
+	 * @return Settings
+	 */
+	function ss() {return Settings::convention($this);}
+
+	/**
+	 * 2017-07-06 It returns one of the following strings: «Books», «CRM», «Inventory».
+	 * @used-by titleLc()
+	 * @used-by \Df\ZohoBI\API\Validator::title()
+	 * @return string
+	 */
+	final function title() {return dfc($this, function() {return df_assert_in(df_result_sne(
+		df_trim_text_left(df_class_second($this), 'Zoho')
+	), ['Books', 'CRM', 'Inventory']);});}
+
+	/**
+	 * 2017-07-06 It returns one of the following strings: «books», «crm», «inventory»
+	 * @used-by \Df\ZohoBI\API\Client::uriBase()
+	 * @used-by \Df\Zoho\Settings::prefix()
+	 * @return string
+	 */
+	final function titleLc() {return strtolower($this->title());}
+
+	/**
+	 * 2017-07-06.
+	 * @used-by df_zoho_app()
+	 * @param string|object $c
+	 * @return self
+	 */
+	final static function s($c) {return dfcf(function($c) {return df_new(df_con_heir($c, __CLASS__));}, [$c]);}
+}

Settings.php

@@ -2,15 +2,15 @@
 namespace Df\Zoho;
 /**
  * 2017-07-05
+ * @see \Df\ZohoBI\Settings
  * @see \Dfe\ZohoBooks\Settings
- * @see \Dfe\ZohoCRM\Settings
- * @see \Dfe\ZohoInventory\Settings
  * @method static Settings s()
  */
 abstract class Settings extends \Df\Config\Settings {
 	/**
 	 * 2017-07-05 «Authentication Token
 	 * @used-by \Df\ZohoBI\API\Client::headers()
+	 * @used-by \Df\ZohoBI\Source\Organization::isRequirementMet()
 	 * @return string
 	 */
 	final function token() {return $this->p();}
@@ -23,6 +23,6 @@ final function token() {return $this->p();}
 	 * @return string
 	 */
 	final protected function prefix() {return dfc($this, function() {return
-		'df_zoho/' . df_zoho_app_lc($this)
+		'df_zoho/' . df_zoho_app($this)->titleLc()
 	;});}
 }

composer.json

@@ -1,6 +1,6 @@
 {
 	"name": "mage2pro/zoho"
-	,"version": "0.0.4"
+	,"version": "0.0.5"
 	,"description": "A common Zoho applications library for my «Zoho CRM», «Zoho Inventory», and «Zoho Books» Magento 2 extensions."
 	,"type": "magento2-module"
 	,"homepage": "https://mage2.pro/tags/zoho"
@@ -11,7 +11,7 @@
 		"homepage": "https://mage2.pro/users/dmitry_fedyuk",
 		"role": "Developer"
 	}]
-	,"require": {"mage2pro/core": ">=2.7.38"}
+	,"require": {"mage2pro/core": ">=2.7.40"}
 	,"autoload": {"files": ["registration.php"], "psr-4": {"Df\\Zoho\\": ""}}
 	,"keywords": [
 		"Zoho"

lib/app.php

@@ -0,0 +1,10 @@
+<?php
+use Df\Zoho\App;
+/**
+ * 2017-07-06
+ * @used-by \Df\ZohoBI\API\Validator::title()
+ * @used-by \Df\ZohoBI\Source\Organization::app()
+ * @param string|object $c
+ * @return App
+ */
+function df_zoho_app($c) {return App::s($c);}