From 53f7f38e2358a8135dc08cd540898af80b26aad3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C4=B1dvan=20Akca?= <akca.ridvann@gmail.com>
Date: Thu, 18 Jan 2024 15:42:28 +0300
Subject: [PATCH 1/5] feat(ynab): add low account balance trigger

---
 .../src/apps/you-need-a-budget/index.js       |  2 +
 .../apps/you-need-a-budget/triggers/index.js  |  3 ++
 .../triggers/low-account-balance/index.js     | 39 +++++++++++++++++++
 packages/docs/pages/.vitepress/config.js      |  1 +
 .../pages/apps/you-need-a-budget/triggers.md  | 12 ++++++
 packages/docs/pages/guide/available-apps.md   |  1 +
 6 files changed, 58 insertions(+)
 create mode 100644 packages/backend/src/apps/you-need-a-budget/triggers/index.js
 create mode 100644 packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js
 create mode 100644 packages/docs/pages/apps/you-need-a-budget/triggers.md

diff --git a/packages/backend/src/apps/you-need-a-budget/index.js b/packages/backend/src/apps/you-need-a-budget/index.js
index 62aad3fb..1e4fe2b0 100644
--- a/packages/backend/src/apps/you-need-a-budget/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/index.js
@@ -1,6 +1,7 @@
 import defineApp from '../../helpers/define-app.js';
 import addAuthHeader from './common/add-auth-header.js';
 import auth from './auth/index.js';
+import triggers from './triggers/index.js';
 
 export default defineApp({
   name: 'You Need A Budget',
@@ -13,4 +14,5 @@ export default defineApp({
   supportsConnections: true,
   beforeRequest: [addAuthHeader],
   auth,
+  triggers,
 });
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
new file mode 100644
index 00000000..2da56b9a
--- /dev/null
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
@@ -0,0 +1,3 @@
+import lowAccountBalance from './low-account-balance/index.js';
+
+export default [lowAccountBalance];
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js
new file mode 100644
index 00000000..68382bec
--- /dev/null
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js
@@ -0,0 +1,39 @@
+import defineTrigger from '../../../../helpers/define-trigger.js';
+
+export default defineTrigger({
+  name: 'Low account balance',
+  key: 'lowAccountBalance',
+  pollInterval: 15,
+  description:
+    'Triggers when the balance of a Checking or Savings account falls below a specified amount within a given month.',
+  arguments: [
+    {
+      label: 'Balance Below Amount',
+      key: 'balanceBelowAmount',
+      type: 'string',
+      required: true,
+      description: 'Account balance falls below this amount (e.g. "250.00")',
+      variables: true,
+    },
+  ],
+
+  async run($) {
+    const balanceBelowAmount = $.step.parameters.balanceBelowAmount;
+    const formattedBalance = balanceBelowAmount * 1000;
+
+    const response = await $.http.get('/budgets/last-used/accounts');
+
+    if (response.data?.data?.accounts?.length) {
+      for (const account of response.data.data.accounts) {
+        if (account.balance < formattedBalance) {
+          $.pushTriggerItem({
+            raw: account,
+            meta: {
+              internalId: account.id,
+            },
+          });
+        }
+      }
+    }
+  },
+});
diff --git a/packages/docs/pages/.vitepress/config.js b/packages/docs/pages/.vitepress/config.js
index d877a163..daef33d3 100644
--- a/packages/docs/pages/.vitepress/config.js
+++ b/packages/docs/pages/.vitepress/config.js
@@ -480,6 +480,7 @@ export default defineConfig({
           collapsible: true,
           collapsed: true,
           items: [
+            { text: 'Triggers', link: '/apps/you-need-a-budget/triggers' },
             { text: 'Connection', link: '/apps/you-need-a-budget/connection' },
           ],
         },
diff --git a/packages/docs/pages/apps/you-need-a-budget/triggers.md b/packages/docs/pages/apps/you-need-a-budget/triggers.md
new file mode 100644
index 00000000..be7d5712
--- /dev/null
+++ b/packages/docs/pages/apps/you-need-a-budget/triggers.md
@@ -0,0 +1,12 @@
+---
+favicon: /favicons/you-need-a-budget.svg
+items:
+  - name: Low account balance
+    desc: Triggers when the balance of a Checking or Savings account falls below a specified amount within a given month.
+---
+
+<script setup>
+  import CustomListing from '../../components/CustomListing.vue'
+</script>
+
+<CustomListing />
diff --git a/packages/docs/pages/guide/available-apps.md b/packages/docs/pages/guide/available-apps.md
index 90f8ba0a..c7229006 100644
--- a/packages/docs/pages/guide/available-apps.md
+++ b/packages/docs/pages/guide/available-apps.md
@@ -50,5 +50,6 @@ The following integrations are currently supported by Automatisch.
 - [Webhooks](/apps/webhooks/triggers)
 - [WordPress](/apps/wordpress/triggers)
 - [Xero](/apps/xero/triggers)
+- [You Need A Budget](/apps/you-need-a-budget/triggers)
 - [Youtube](/apps/youtube/triggers)
 - [Zendesk](/apps/zendesk/actions)

From 1428bf8ffa93b6bf52e6ce26de8c4489515d4ea1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C4=B1dvan=20Akca?= <akca.ridvann@gmail.com>
Date: Thu, 18 Jan 2024 17:31:53 +0300
Subject: [PATCH 2/5] feat(ynab): add category overspent trigger

---
 .../triggers/category-overspent/index.js      | 35 +++++++++++++++++++
 .../apps/you-need-a-budget/triggers/index.js  |  3 +-
 .../pages/apps/you-need-a-budget/triggers.md  |  2 ++
 3 files changed, 39 insertions(+), 1 deletion(-)
 create mode 100644 packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js

diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js
new file mode 100644
index 00000000..9d4df8f7
--- /dev/null
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js
@@ -0,0 +1,35 @@
+import defineTrigger from '../../../../helpers/define-trigger.js';
+
+export default defineTrigger({
+  name: 'Category overspent',
+  key: 'categoryOverspent',
+  pollInterval: 15,
+  description:
+    'Triggers when a category exceeds its budget, resulting in a negative balance.',
+
+  async run($) {
+    const categoryWithNegativeBalance = [];
+
+    const response = await $.http.get('/budgets/last-used/categories');
+    const categoryGroups = response.data.data.category_groups;
+
+    categoryGroups.forEach((group) => {
+      group.categories.forEach((category) => {
+        if (category.balance < 0) {
+          categoryWithNegativeBalance.push(category);
+        }
+      });
+    });
+
+    if (categoryWithNegativeBalance?.length) {
+      for (const category of categoryWithNegativeBalance) {
+        $.pushTriggerItem({
+          raw: category,
+          meta: {
+            internalId: category.id,
+          },
+        });
+      }
+    }
+  },
+});
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
index 2da56b9a..ff64d17c 100644
--- a/packages/backend/src/apps/you-need-a-budget/triggers/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
@@ -1,3 +1,4 @@
+import categoryOverspent from './category-overspent/index.js';
 import lowAccountBalance from './low-account-balance/index.js';
 
-export default [lowAccountBalance];
+export default [categoryOverspent, lowAccountBalance];
diff --git a/packages/docs/pages/apps/you-need-a-budget/triggers.md b/packages/docs/pages/apps/you-need-a-budget/triggers.md
index be7d5712..31313794 100644
--- a/packages/docs/pages/apps/you-need-a-budget/triggers.md
+++ b/packages/docs/pages/apps/you-need-a-budget/triggers.md
@@ -1,6 +1,8 @@
 ---
 favicon: /favicons/you-need-a-budget.svg
 items:
+  - name: Category overspent
+    desc: Triggers when a category exceeds its budget, resulting in a negative balance.
   - name: Low account balance
     desc: Triggers when the balance of a Checking or Savings account falls below a specified amount within a given month.
 ---

From ab811daba794125f0ba503ed719817f49e9c6aae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C4=B1dvan=20Akca?= <akca.ridvann@gmail.com>
Date: Thu, 18 Jan 2024 18:00:48 +0300
Subject: [PATCH 3/5] feat(ynab): add goal completed trigger

---
 .../triggers/goal-completed/index.js          | 34 +++++++++++++++++++
 .../apps/you-need-a-budget/triggers/index.js  |  3 +-
 .../pages/apps/you-need-a-budget/triggers.md  |  2 ++
 3 files changed, 38 insertions(+), 1 deletion(-)
 create mode 100644 packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js

diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js
new file mode 100644
index 00000000..edc5ce51
--- /dev/null
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js
@@ -0,0 +1,34 @@
+import defineTrigger from '../../../../helpers/define-trigger.js';
+
+export default defineTrigger({
+  name: 'Goal completed',
+  key: 'goalCompleted',
+  pollInterval: 15,
+  description: 'Triggers when a goal is completed.',
+
+  async run($) {
+    const goalCompletedCategories = [];
+
+    const response = await $.http.get('/budgets/last-used/categories');
+    const categoryGroups = response.data.data.category_groups;
+
+    categoryGroups.forEach((group) => {
+      group.categories.forEach((category) => {
+        if (category.goal_percentage_complete === 100) {
+          goalCompletedCategories.push(category);
+        }
+      });
+    });
+
+    if (goalCompletedCategories?.length) {
+      for (const category of goalCompletedCategories) {
+        $.pushTriggerItem({
+          raw: category,
+          meta: {
+            internalId: category.id,
+          },
+        });
+      }
+    }
+  },
+});
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
index ff64d17c..8dabee8d 100644
--- a/packages/backend/src/apps/you-need-a-budget/triggers/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
@@ -1,4 +1,5 @@
 import categoryOverspent from './category-overspent/index.js';
+import goalCompleted from './goal-completed/index.js';
 import lowAccountBalance from './low-account-balance/index.js';
 
-export default [categoryOverspent, lowAccountBalance];
+export default [categoryOverspent, goalCompleted, lowAccountBalance];
diff --git a/packages/docs/pages/apps/you-need-a-budget/triggers.md b/packages/docs/pages/apps/you-need-a-budget/triggers.md
index 31313794..090f255e 100644
--- a/packages/docs/pages/apps/you-need-a-budget/triggers.md
+++ b/packages/docs/pages/apps/you-need-a-budget/triggers.md
@@ -3,6 +3,8 @@ favicon: /favicons/you-need-a-budget.svg
 items:
   - name: Category overspent
     desc: Triggers when a category exceeds its budget, resulting in a negative balance.
+  - name: Goal completed
+    desc: Triggers when a goal is completed.
   - name: Low account balance
     desc: Triggers when the balance of a Checking or Savings account falls below a specified amount within a given month.
 ---

From 0f39007f92e733dfead43ae17159e956d12cadb6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C4=B1dvan=20Akca?= <akca.ridvann@gmail.com>
Date: Thu, 18 Jan 2024 18:08:42 +0300
Subject: [PATCH 4/5] feat(ynab): add new transactions trigger

---
 .../apps/you-need-a-budget/triggers/index.js  |  8 ++++++-
 .../triggers/new-transactions/index.js        | 24 +++++++++++++++++++
 .../pages/apps/you-need-a-budget/triggers.md  |  2 ++
 3 files changed, 33 insertions(+), 1 deletion(-)
 create mode 100644 packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js

diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
index 8dabee8d..81ac9694 100644
--- a/packages/backend/src/apps/you-need-a-budget/triggers/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/index.js
@@ -1,5 +1,11 @@
 import categoryOverspent from './category-overspent/index.js';
 import goalCompleted from './goal-completed/index.js';
 import lowAccountBalance from './low-account-balance/index.js';
+import newTransactions from './new-transactions/index.js';
 
-export default [categoryOverspent, goalCompleted, lowAccountBalance];
+export default [
+  categoryOverspent,
+  goalCompleted,
+  lowAccountBalance,
+  newTransactions,
+];
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js
new file mode 100644
index 00000000..55d8bb5a
--- /dev/null
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js
@@ -0,0 +1,24 @@
+import defineTrigger from '../../../../helpers/define-trigger.js';
+
+export default defineTrigger({
+  name: 'New transactions',
+  key: 'newTransactions',
+  pollInterval: 15,
+  description: 'Triggers when a new transaction is created.',
+
+  async run($) {
+    const response = await $.http.get('/budgets/last-used/transactions');
+    const transactions = response.data.data?.transactions;
+
+    if (transactions?.length) {
+      for (const transaction of transactions) {
+        $.pushTriggerItem({
+          raw: transaction,
+          meta: {
+            internalId: transaction.id,
+          },
+        });
+      }
+    }
+  },
+});
diff --git a/packages/docs/pages/apps/you-need-a-budget/triggers.md b/packages/docs/pages/apps/you-need-a-budget/triggers.md
index 090f255e..4394dd0b 100644
--- a/packages/docs/pages/apps/you-need-a-budget/triggers.md
+++ b/packages/docs/pages/apps/you-need-a-budget/triggers.md
@@ -7,6 +7,8 @@ items:
     desc: Triggers when a goal is completed.
   - name: Low account balance
     desc: Triggers when the balance of a Checking or Savings account falls below a specified amount within a given month.
+  - name: New transactions
+    desc: Triggers when a new transaction is created.
 ---
 
 <script setup>

From 8eaf775ef29276e69275f7977558d24e3fb2b699 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C4=B1dvan=20Akca?= <akca.ridvann@gmail.com>
Date: Tue, 7 May 2024 17:20:59 +0200
Subject: [PATCH 5/5] refactor(ynab): specify a budget when creating a
 connection

---
 .../triggers/category-overspent/index.js              |  2 +-
 .../triggers/goal-completed/index.js                  |  2 +-
 .../triggers/low-account-balance/index.js             |  2 +-
 .../triggers/new-transactions/index.js                |  2 +-
 .../docs/pages/apps/you-need-a-budget/connection.md   | 11 ++++++-----
 5 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js
index 9d4df8f7..be49a65a 100644
--- a/packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/category-overspent/index.js
@@ -10,7 +10,7 @@ export default defineTrigger({
   async run($) {
     const categoryWithNegativeBalance = [];
 
-    const response = await $.http.get('/budgets/last-used/categories');
+    const response = await $.http.get('/budgets/default/categories');
     const categoryGroups = response.data.data.category_groups;
 
     categoryGroups.forEach((group) => {
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js
index edc5ce51..4ffb4124 100644
--- a/packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/goal-completed/index.js
@@ -9,7 +9,7 @@ export default defineTrigger({
   async run($) {
     const goalCompletedCategories = [];
 
-    const response = await $.http.get('/budgets/last-used/categories');
+    const response = await $.http.get('/budgets/default/categories');
     const categoryGroups = response.data.data.category_groups;
 
     categoryGroups.forEach((group) => {
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js
index 68382bec..b7886cc5 100644
--- a/packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/low-account-balance/index.js
@@ -21,7 +21,7 @@ export default defineTrigger({
     const balanceBelowAmount = $.step.parameters.balanceBelowAmount;
     const formattedBalance = balanceBelowAmount * 1000;
 
-    const response = await $.http.get('/budgets/last-used/accounts');
+    const response = await $.http.get('/budgets/default/accounts');
 
     if (response.data?.data?.accounts?.length) {
       for (const account of response.data.data.accounts) {
diff --git a/packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js b/packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js
index 55d8bb5a..00aa4c02 100644
--- a/packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js
+++ b/packages/backend/src/apps/you-need-a-budget/triggers/new-transactions/index.js
@@ -7,7 +7,7 @@ export default defineTrigger({
   description: 'Triggers when a new transaction is created.',
 
   async run($) {
-    const response = await $.http.get('/budgets/last-used/transactions');
+    const response = await $.http.get('/budgets/default/transactions');
     const transactions = response.data.data?.transactions;
 
     if (transactions?.length) {
diff --git a/packages/docs/pages/apps/you-need-a-budget/connection.md b/packages/docs/pages/apps/you-need-a-budget/connection.md
index 21f35a41..be7307d2 100644
--- a/packages/docs/pages/apps/you-need-a-budget/connection.md
+++ b/packages/docs/pages/apps/you-need-a-budget/connection.md
@@ -11,8 +11,9 @@ connection in Automatisch. If any of the steps are outdated, please let us know!
 4. Click on the **New Application** under the **OAuth Applications** section.
 5. Fill the new application form.
 6. Copy **OAuth Redirect URL** from Automatisch and paste it in **Redirect URI(s)** section.
-7. Click on the **Save Application** button.
-8. Copy the **Client ID** value to the **Client ID** field on Automatisch.
-9. Copy the **Client Secret** value to the **Client Secret** field on Automatisch.
-10. Fill the **Screen Name** field on Automatisch.
-11. Congrats! Start using your new You Need A Budget connection within the flows.
+7. Enable the option **Enable default budget selection when users authorize this application**.
+8. Click on the **Save Application** button.
+9. Copy the **Client ID** value to the **Client ID** field on Automatisch.
+10. Copy the **Client Secret** value to the **Client Secret** field on Automatisch.
+11. Fill the **Screen Name** field on Automatisch.
+12. Congrats! Start using your new You Need A Budget connection within the flows.