@drosenthal/n8n-nodes-ynab 0.1.2 → 0.2.0

package/dist/nodes/Ynab/GenericFunctions.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ynabApiRequest = ynabApiRequest;
+exports.getPlans = getPlans;
+exports.getAccounts = getAccounts;
+exports.getCategories = getCategories;
+exports.getCategoryGroups = getCategoryGroups;
+const YNAB_BASE_URL = 'https://api.ynab.com/v1';
+async function ynabApiRequest(method, endpoint, body = {}, qs = {}) {
+    const options = {
+        method,
+        url: `${YNAB_BASE_URL}${endpoint}`,
+        qs,
+        body,
+        json: true,
+    };
+    if (Object.keys(body).length === 0) {
+        delete options.body;
+    }
+    return this.helpers.httpRequestWithAuthentication.call(this, 'ynabApi', options);
+}
+async function getPlans() {
+    var _a, _b;
+    const response = await ynabApiRequest.call(this, 'GET', '/plans');
+    const plans = ((_b = (_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.plans) !== null && _b !== void 0 ? _b : []);
+    const options = [
+        { name: 'Last Used', value: 'last-used' },
+        { name: 'Default', value: 'default' },
+    ];
+    for (const plan of plans) {
+        options.push({ name: plan.name, value: plan.id });
+    }
+    return options;
+}
+async function getAccounts() {
+    var _a, _b;
+    const planId = this.getCurrentNodeParameter('plan_id');
+    if (!planId)
+        return [];
+    const response = await ynabApiRequest.call(this, 'GET', `/plans/${planId}/accounts`);
+    const accounts = ((_b = (_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.accounts) !== null && _b !== void 0 ? _b : []);
+    return accounts
+        .filter((a) => !a.closed)
+        .map((a) => ({ name: a.name, value: a.id }));
+}
+async function getCategories() {
+    var _a, _b, _c;
+    const planId = this.getCurrentNodeParameter('plan_id');
+    if (!planId)
+        return [];
+    const response = await ynabApiRequest.call(this, 'GET', `/plans/${planId}/categories`);
+    const groups = ((_b = (_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.category_groups) !== null && _b !== void 0 ? _b : []);
+    const options = [];
+    for (const group of groups) {
+        if (group.hidden || group.deleted)
+            continue;
+        for (const cat of (_c = group.categories) !== null && _c !== void 0 ? _c : []) {
+            if (cat.hidden || cat.deleted)
+                continue;
+            options.push({ name: `${group.name}: ${cat.name}`, value: cat.id });
+        }
+    }
+    return options;
+}
+async function getCategoryGroups() {
+    var _a, _b;
+    const planId = this.getCurrentNodeParameter('plan_id');
+    if (!planId)
+        return [];
+    const response = await ynabApiRequest.call(this, 'GET', `/plans/${planId}/categories`);
+    const groups = ((_b = (_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.category_groups) !== null && _b !== void 0 ? _b : []);
+    return groups
+        .filter((g) => !g.hidden && !g.deleted)
+        .map((g) => ({ name: g.name, value: g.id }));
+}

package/dist/nodes/Ynab/Ynab.node.js

@@ -1,44 +1,8 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Ynab = void 0;
-const n8n_openapi_node_1 = require("@devlikeapro/n8n-openapi-node");
-const doc = __importStar(require("./openapi.json"));
-const config = {};
-const parser = new n8n_openapi_node_1.N8NPropertiesBuilder(doc, config);
-const properties = parser.build();
+const descriptions_1 = require("./descriptions");
+const GenericFunctions_1 = require("./GenericFunctions");
 class Ynab {
     constructor() {
         this.description = {
@@ -49,17 +13,10 @@ class Ynab {
             version: 1,
             subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
             description: 'Interact with the YNAB (You Need A Budget) API',
-            defaults: {
-                name: 'YNAB',
-            },
+            defaults: { name: 'YNAB' },
             inputs: ['main'],
             outputs: ['main'],
-            credentials: [
-                {
-                    name: 'ynabApi',
-                    required: true,
-                },
-            ],
+            credentials: [{ name: 'ynabApi', required: true }],
             requestDefaults: {
                 baseURL: 'https://api.ynab.com/v1',
                 headers: {
@@ -67,7 +24,15 @@ class Ynab {
                     'Content-Type': 'application/json',
                 },
             },
-            properties,
+            properties: descriptions_1.allProperties,
+        };
+        this.methods = {
+            loadOptions: {
+                getPlans: GenericFunctions_1.getPlans,
+                getAccounts: GenericFunctions_1.getAccounts,
+                getCategories: GenericFunctions_1.getCategories,
+                getCategoryGroups: GenericFunctions_1.getCategoryGroups,
+            },
         };
     }
 }

package/dist/nodes/Ynab/descriptions/AccountDescription.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.accountFields = exports.accountOperations = void 0;
+exports.accountOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: { show: { resource: ['account'] } },
+        options: [
+            {
+                name: 'Get All',
+                value: 'getAll',
+                action: 'Get all accounts',
+                routing: {
+                    request: { method: 'GET', url: '=/plans/{{$parameter.plan_id}}/accounts' },
+                },
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                action: 'Get an account',
+                routing: {
+                    request: {
+                        method: 'GET',
+                        url: '=/plans/{{$parameter.plan_id}}/accounts/{{$parameter.account_id}}',
+                    },
+                },
+            },
+            {
+                name: 'Create',
+                value: 'create',
+                action: 'Create an account',
+                routing: {
+                    request: { method: 'POST', url: '=/plans/{{$parameter.plan_id}}/accounts' },
+                },
+            },
+        ],
+        default: 'getAll',
+    },
+];
+exports.accountFields = [
+    {
+        displayName: 'Plan Name or ID',
+        name: 'plan_id',
+        type: 'options',
+        required: true,
+        default: '',
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+        typeOptions: { loadOptionsMethod: 'getPlans' },
+        displayOptions: { show: { resource: ['account'] } },
+    },
+    {
+        displayName: 'Account Name or ID',
+        name: 'account_id',
+        type: 'options',
+        required: true,
+        default: '',
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+        typeOptions: { loadOptionsMethod: 'getAccounts', loadOptionsDependsOn: ['plan_id'] },
+        displayOptions: { show: { resource: ['account'], operation: ['get'] } },
+    },
+    // getAll: last_knowledge_of_server
+    {
+        displayName: 'Last Knowledge of Server',
+        name: 'last_knowledge_of_server',
+        type: 'number',
+        default: 0,
+        description: 'Returns entities changed since this knowledge value. Use 0 to fetch everything.',
+        displayOptions: { show: { resource: ['account'], operation: ['getAll'] } },
+        routing: {
+            request: {
+                qs: { last_knowledge_of_server: '={{ $value > 0 ? $value : undefined }}' },
+            },
+        },
+    },
+    // create: body fields
+    {
+        displayName: 'Name',
+        name: 'name',
+        type: 'string',
+        default: '',
+        required: true,
+        description: 'The name of the account',
+        displayOptions: { show: { resource: ['account'], operation: ['create'] } },
+        routing: { send: { type: 'body', property: 'account.name' } },
+    },
+    {
+        displayName: 'Type',
+        name: 'type',
+        type: 'options',
+        default: 'checking',
+        required: true,
+        options: [
+            { name: 'Checking', value: 'checking' },
+            { name: 'Savings', value: 'savings' },
+            { name: 'Cash', value: 'cash' },
+            { name: 'Credit Card', value: 'creditCard' },
+            { name: 'Other Asset', value: 'otherAsset' },
+            { name: 'Other Liability', value: 'otherLiability' },
+        ],
+        displayOptions: { show: { resource: ['account'], operation: ['create'] } },
+        routing: { send: { type: 'body', property: 'account.type' } },
+    },
+    {
+        displayName: 'Balance (Milliunits)',
+        name: 'balance',
+        type: 'number',
+        default: 0,
+        required: true,
+        description: 'The current balance of the account in milliunits format (multiply dollars by 1000)',
+        displayOptions: { show: { resource: ['account'], operation: ['create'] } },
+        routing: { send: { type: 'body', property: 'account.balance' } },
+    },
+];

package/dist/nodes/Ynab/descriptions/CategoryDescription.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categoryFields = exports.categoryOperations = void 0;
+exports.categoryOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: { show: { resource: ['category'] } },
+        options: [
+            {
+                name: 'Get All',
+                value: 'getAll',
+                action: 'Get all categories',
+                routing: {
+                    request: { method: 'GET', url: '=/plans/{{$parameter.plan_id}}/categories' },
+                },
+            },
+            {
+                name: 'Get',
+                value: 'get',
+                action: 'Get a category',
+                routing: {
+                    request: {
+                        method: 'GET',
+                        url: '=/plans/{{$parameter.plan_id}}/categories/{{$parameter.category_id}}',
+                    },
+                },
+            },
+            {
+                name: 'Create',
+                value: 'create',
+                action: 'Create a category',
+                routing: {
+                    request: { method: 'POST', url: '=/plans/{{$parameter.plan_id}}/categories' },
+                },
+            },
+            {
+                name: 'Update',
+                value: 'update',
+                action: 'Update a category',
+                routing: {
+                    request: {
+                        method: 'PATCH',
+                        url: '=/plans/{{$parameter.plan_id}}/categories/{{$parameter.category_id}}',
+                    },
+                },
+            },
+            {
+                name: 'Get For Month',
+                value: 'getForMonth',
+                action: 'Get a category for a specific month',
+                routing: {
+                    request: {
+                        method: 'GET',
+                        url: '=/plans/{{$parameter.plan_id}}/months/{{$parameter.month}}/categories/{{$parameter.category_id}}',
+                    },
+                },
+            },
+            {
+                name: 'Update For Month',
+                value: 'updateForMonth',
+                action: 'Update a category for a specific month',
+                routing: {
+                    request: {
+                        method: 'PATCH',
+                        url: '=/plans/{{$parameter.plan_id}}/months/{{$parameter.month}}/categories/{{$parameter.category_id}}',
+                    },
+                },
+            },
+            {
+                name: 'Create Group',
+                value: 'createGroup',
+                action: 'Create a category group',
+                routing: {
+                    request: { method: 'POST', url: '=/plans/{{$parameter.plan_id}}/category_groups' },
+                },
+            },
+            {
+                name: 'Update Group',
+                value: 'updateGroup',
+                action: 'Update a category group',
+                routing: {
+                    request: {
+                        method: 'PATCH',
+                        url: '=/plans/{{$parameter.plan_id}}/category_groups/{{$parameter.category_group_id}}',
+                    },
+                },
+            },
+        ],
+        default: 'getAll',
+    },
+];
+exports.categoryFields = [
+    // plan_id for all
+    {
+        displayName: 'Plan Name or ID',
+        name: 'plan_id',
+        type: 'options',
+        required: true,
+        default: '',
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+        typeOptions: { loadOptionsMethod: 'getPlans' },
+        displayOptions: { show: { resource: ['category'] } },
+    },
+    // category_id (get, update, getForMonth, updateForMonth)
+    {
+        displayName: 'Category Name or ID',
+        name: 'category_id',
+        type: 'options',
+        required: true,
+        default: '',
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+        typeOptions: { loadOptionsMethod: 'getCategories', loadOptionsDependsOn: ['plan_id'] },
+        displayOptions: {
+            show: {
+                resource: ['category'],
+                operation: ['get', 'update', 'getForMonth', 'updateForMonth'],
+            },
+        },
+    },
+    // category_group_id (updateGroup)
+    {
+        displayName: 'Category Group Name or ID',
+        name: 'category_group_id',
+        type: 'options',
+        required: true,
+        default: '',
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+        typeOptions: { loadOptionsMethod: 'getCategoryGroups', loadOptionsDependsOn: ['plan_id'] },
+        displayOptions: { show: { resource: ['category'], operation: ['updateGroup'] } },
+    },
+    // month (getForMonth, updateForMonth)
+    {
+        displayName: 'Month',
+        name: 'month',
+        type: 'string',
+        required: true,
+        default: 'current',
+        placeholder: 'current or YYYY-MM-01',
+        description: 'ISO-formatted month (e.g. 2024-03-01) or "current"',
+        displayOptions: {
+            show: { resource: ['category'], operation: ['getForMonth', 'updateForMonth'] },
+        },
+    },
+    // getAll: last_knowledge_of_server
+    {
+        displayName: 'Last Knowledge of Server',
+        name: 'last_knowledge_of_server',
+        type: 'number',
+        default: 0,
+        description: 'Returns entities changed since this knowledge value. Use 0 to fetch everything.',
+        displayOptions: { show: { resource: ['category'], operation: ['getAll'] } },
+        routing: {
+            request: {
+                qs: { last_knowledge_of_server: '={{ $value > 0 ? $value : undefined }}' },
+            },
+        },
+    },
+    // create: NewCategory body (name + category_group_id required, others optional)
+    {
+        displayName: 'Name',
+        name: 'name',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { resource: ['category'], operation: ['create'] } },
+        routing: { send: { type: 'body', property: 'category.name' } },
+    },
+    {
+        displayName: 'Parent Category Group Name or ID',
+        name: 'parent_category_group_id',
+        type: 'options',
+        required: true,
+        default: '',
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+        typeOptions: { loadOptionsMethod: 'getCategoryGroups', loadOptionsDependsOn: ['plan_id'] },
+        displayOptions: { show: { resource: ['category'], operation: ['create'] } },
+        routing: { send: { type: 'body', property: 'category.category_group_id' } },
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        default: {},
+        placeholder: 'Add Field',
+        displayOptions: { show: { resource: ['category'], operation: ['create'] } },
+        options: [
+            {
+                displayName: 'Note',
+                name: 'note',
+                type: 'string',
+                default: '',
+                routing: { send: { type: 'body', property: 'category.note' } },
+            },
+            {
+                displayName: 'Goal Target (Milliunits)',
+                name: 'goal_target',
+                type: 'number',
+                default: 0,
+                description: 'Goal target amount in milliunits (multiply dollars by 1000)',
+                routing: { send: { type: 'body', property: 'category.goal_target' } },
+            },
+            {
+                displayName: 'Goal Target Date',
+                name: 'goal_target_date',
+                type: 'string',
+                default: '',
+                placeholder: 'YYYY-MM-DD',
+                routing: { send: { type: 'body', property: 'category.goal_target_date' } },
+            },
+        ],
+    },
+    // update: ExistingCategory body (all optional)
+    {
+        displayName: 'Update Fields',
+        name: 'updateFields',
+        type: 'collection',
+        default: {},
+        placeholder: 'Add Field',
+        displayOptions: { show: { resource: ['category'], operation: ['update'] } },
+        options: [
+            {
+                displayName: 'Name',
+                name: 'name',
+                type: 'string',
+                default: '',
+                routing: { send: { type: 'body', property: 'category.name' } },
+            },
+            {
+                displayName: 'Note',
+                name: 'note',
+                type: 'string',
+                default: '',
+                routing: { send: { type: 'body', property: 'category.note' } },
+            },
+            {
+                displayName: 'Category Group Name or ID',
+                name: 'category_group_id',
+                type: 'options',
+                default: '',
+                description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+                typeOptions: { loadOptionsMethod: 'getCategoryGroups', loadOptionsDependsOn: ['plan_id'] },
+                routing: { send: { type: 'body', property: 'category.category_group_id' } },
+            },
+            {
+                displayName: 'Goal Target (Milliunits)',
+                name: 'goal_target',
+                type: 'number',
+                default: 0,
+                routing: { send: { type: 'body', property: 'category.goal_target' } },
+            },
+            {
+                displayName: 'Goal Target Date',
+                name: 'goal_target_date',
+                type: 'string',
+                default: '',
+                placeholder: 'YYYY-MM-DD',
+                routing: { send: { type: 'body', property: 'category.goal_target_date' } },
+            },
+        ],
+    },
+    // updateForMonth: SaveMonthCategory (budgeted required)
+    {
+        displayName: 'Budgeted (Milliunits)',
+        name: 'budgeted',
+        type: 'number',
+        default: 0,
+        required: true,
+        description: 'The amount budgeted for the month in milliunits (multiply dollars by 1000)',
+        displayOptions: { show: { resource: ['category'], operation: ['updateForMonth'] } },
+        routing: { send: { type: 'body', property: 'category.budgeted' } },
+    },
+    // createGroup, updateGroup: name
+    {
+        displayName: 'Name',
+        name: 'group_name',
+        type: 'string',
+        default: '',
+        required: true,
+        description: 'Category group name (max 50 characters)',
+        displayOptions: { show: { resource: ['category'], operation: ['createGroup', 'updateGroup'] } },
+        routing: { send: { type: 'body', property: 'category_group.name' } },
+    },
+];

package/dist/nodes/Ynab/descriptions/MoneyMovementDescription.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moneyMovementFields = exports.moneyMovementOperations = void 0;
+exports.moneyMovementOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: { show: { resource: ['moneyMovement'] } },
+        options: [
+            {
+                name: 'Get All',
+                value: 'getAll',
+                action: 'Get all money movements',
+                routing: {
+                    request: { method: 'GET', url: '=/plans/{{$parameter.plan_id}}/money_movements' },
+                },
+            },
+            {
+                name: 'Get All By Month',
+                value: 'getAllByMonth',
+                action: 'Get money movements for a month',
+                routing: {
+                    request: {
+                        method: 'GET',
+                        url: '=/plans/{{$parameter.plan_id}}/months/{{$parameter.month}}/money_movements',
+                    },
+                },
+            },
+            {
+                name: 'Get All Groups',
+                value: 'getAllGroups',
+                action: 'Get all money movement groups',
+                routing: {
+                    request: { method: 'GET', url: '=/plans/{{$parameter.plan_id}}/money_movement_groups' },
+                },
+            },
+            {
+                name: 'Get All Groups By Month',
+                value: 'getAllGroupsByMonth',
+                action: 'Get money movement groups for a month',
+                routing: {
+                    request: {
+                        method: 'GET',
+                        url: '=/plans/{{$parameter.plan_id}}/months/{{$parameter.month}}/money_movement_groups',
+                    },
+                },
+            },
+        ],
+        default: 'getAll',
+    },
+];
+exports.moneyMovementFields = [
+    {
+        displayName: 'Plan Name or ID',
+        name: 'plan_id',
+        type: 'options',
+        required: true,
+        default: '',
+        description: 'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+        typeOptions: { loadOptionsMethod: 'getPlans' },
+        displayOptions: { show: { resource: ['moneyMovement'] } },
+    },
+    {
+        displayName: 'Month',
+        name: 'month',
+        type: 'string',
+        required: true,
+        default: 'current',
+        placeholder: 'current or YYYY-MM-01',
+        description: 'ISO-formatted month (e.g. 2024-03-01) or "current"',
+        displayOptions: {
+            show: {
+                resource: ['moneyMovement'],
+                operation: ['getAllByMonth', 'getAllGroupsByMonth'],
+            },
+        },
+    },
+];