new: subdivision activity description

Author: gboudreau

README.md

@@ -135,7 +135,11 @@ foreach ($accounts as $account) {
         if ($act->type === 'DIY_BUY') {
             $act->amountSign = 'negative';
         }
-        echo "  - [" . date("Y-m-d H:i:s", strtotime($act->occurredAt)) . "] [$act->canonicalId] $act->description = " . ($act->amountSign === 'positive' ? "+" : "-") . "$act->amount $act->currency\n";
+        echo "  - [" . date("Y-m-d H:i:s", strtotime($act->occurredAt)) . "] [$act->canonicalId] $act->description";
+        if ($act->currency) {
+            echo " = " . ($act->amountSign === 'positive' ? "+" : "-") . "$act->amount $act->currency";
+        }
+        echo "\n";
         if ($act->description === "$act->type: $act->subType") {
             // This is an "unknown" transaction, for which description is generic; please open an issue on https://github.com/gboudreau/ws-api-php/issues and include the following:
             echo "    Unknown activity: " . json_encode($act) . "\n";

src/WealthsimpleAPI.php

@@ -197,6 +197,8 @@ private function _activityAddDescription(&$act) {
             } else {
                 $act->description = "$verb: $action " . ((float) $act->assetQuantity) . " x $security @ " . ($act->amount / $act->assetQuantity);
             }
+        } elseif ($act->type === 'CORPORATE_ACTION' && $act->subType === 'SUBDIVISION') {
+            $act->description = "Subdivision: Received $act->amount shares of $act->assetSymbol";
         } elseif (($act->type === 'DEPOSIT' || $act->type === 'WITHDRAWAL') && ($act->subType === 'E_TRANSFER' || $act->subType === 'E_TRANSFER_FUNDING')) {
             $direction = $act->type === 'WITHDRAWAL' ? 'to' : 'from';
             $act->description = ucfirst(strtolower($act->type)) . ": Interac e-transfer $direction $act->eTransferName $act->eTransferEmail";