n8n-nodes-actual-budget-category 0.1.0

package/actual/CreateExpense.cjs

@@ -0,0 +1,38 @@
+const { createExpense, initActual, shutdownActual } = require('../actual/CreateExpense.cjs');
+
+class ActualBudget {
+	async execute() {
+		const items = this.getInputData();
+		const creds = await this.getCredentials('actualBudgetApi');
+		const results = [];
+
+		// ✅ INIT ONCE
+		await initActual({
+			serverURL: creds.serverUrl,
+			password: creds.password,
+			syncId: creds.syncId,
+		});
+
+		try {
+			for (let i = 0; i < items.length; i++) {
+				const result = await createExpense({
+					amount: this.getNodeParameter('amount', i),
+					categoryName: this.getNodeParameter('categoryName', i),
+					accountName: this.getNodeParameter('accountName', i),
+					payee: this.getNodeParameter('payee', i),
+					notes: this.getNodeParameter('notes', i),
+					importedId: `n8n-${Date.now()}-${i}`,
+				});
+
+				results.push({ json: { success: true, ...result } });
+			}
+		} finally {
+			// ✅ SHUTDOWN ONCE
+			await shutdownActual();
+		}
+
+		return [results];
+	}
+}
+
+module.exports = { ActualBudget };

package/credentials/ActualBudgetApi.credentials.js

@@ -0,0 +1,32 @@
+class ActualBudgetApi {
+	constructor() {
+		this.name = 'actualBudgetApi';
+		this.displayName = 'Actual Budget API';
+
+		this.properties = [
+			{
+				displayName: 'Server URL',
+				name: 'serverUrl',
+				type: 'string',
+				required: true,
+				placeholder: 'https://actual.example.com',
+			},
+			{
+				displayName: 'Password',
+				name: 'password',
+				type: 'string',
+				typeOptions: { password: true },
+				required: true,
+			},
+			{
+				displayName: 'Sync ID',
+				name: 'syncId',
+				type: 'string',
+				required: true,
+				description: 'Found in Settings → Advanced → Sync ID',
+			},
+		];
+	}
+}
+
+module.exports = { ActualBudgetApi };

package/nodes/ActualBudget.node.js

@@ -0,0 +1,108 @@
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+const { init, shutdown, downloadBudget, getAccounts, getCategories, addTransactions } = require('@actual-app/api');
+
+function normalize(s) {
+	return s.toLowerCase().trim();
+}
+
+class ActualBudget {
+	constructor() {
+		this.description = {
+			displayName: 'Actual Budget',
+			name: 'actualBudget',
+			group: ['finance'],
+			version: 1,
+			description: 'Create a transaction in Actual Budget',
+			defaults: { name: 'Actual Budget' },
+			inputs: ['main'],
+			outputs: ['main'],
+			credentials: [{ name: 'actualBudgetApi', required: true }],
+			properties: [
+				{ displayName: 'Amount', name: 'amount', type: 'number', required: true },
+				{ displayName: 'Category Name', name: 'categoryName', type: 'string', required: true },
+				{ displayName: 'Account Name', name: 'accountName', type: 'string', required: true },
+				{ displayName: 'Payee', name: 'payee', type: 'string' },
+				{ displayName: 'Notes', name: 'notes', type: 'string' },
+			],
+		};
+	}
+
+	async execute() {
+		const items = this.getInputData();
+		const creds = await this.getCredentials('actualBudgetApi');
+		const results = [];
+
+		// 🔑 FIX: ensure syncId is a string
+		const syncId = typeof creds.syncId === 'string' ? creds.syncId : creds.syncId?.value;
+
+		if (!syncId) {
+			throw new Error(`Invalid syncId: ${JSON.stringify(creds.syncId)}`);
+		}
+
+		// same behavior you already had
+		const dataDir = path.join(os.tmpdir(), 'actual-budget', syncId);
+		fs.mkdirSync(dataDir, { recursive: true });
+
+		// INIT ONCE
+		await init({
+			serverURL: creds.serverUrl,
+			password: creds.password,
+			dataDir,
+		});
+
+		try {
+			// open budget once
+			await downloadBudget({ syncId });
+
+			const accounts = await getAccounts();
+			const categories = await getCategories();
+
+			for (let i = 0; i < items.length; i++) {
+				const amount = this.getNodeParameter('amount', i);
+				const categoryName = this.getNodeParameter('categoryName', i);
+				const accountName = this.getNodeParameter('accountName', i);
+				const payee = this.getNodeParameter('payee', i);
+				const notes = this.getNodeParameter('notes', i);
+
+				const account = accounts.find(a => normalize(a.name) === normalize(accountName));
+				if (!account) {
+					throw new Error(`Account not found: ${accountName}`);
+				}
+
+				const category = categories.find(c => normalize(c.name) === normalize(categoryName));
+				if (!category) {
+					throw new Error(`Category not found: ${categoryName}`);
+				}
+
+				await addTransactions(account.id, [
+					{
+						amount: -Math.round(amount * 100),
+						category: category.id,
+						payee_name: payee,
+						notes: notes || '',
+						date: new Date().toISOString().slice(0, 10),
+						imported_id: `n8n-${Date.now()}-${i}`,
+					},
+				]);
+
+				results.push({
+					json: {
+						success: true,
+						accountId: account.id,
+						categoryId: category.id,
+					},
+				});
+			}
+		} finally {
+			// SHUTDOWN ONCE
+			await shutdown();
+		}
+
+		return [results];
+	}
+}
+
+module.exports = { ActualBudget };

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "n8n-nodes-actual-budget-category",
+  "version": "0.1.0",
+  "description": "n8n community node for Actual Budget",
+  "license": "MIT",
+  "keywords": [
+    "n8n-community-node",
+    "actual-budget",
+    "finance"
+  ],
+  "author": "Sebastian Larrieu",
+  "main": "index.js",
+  "files": [
+    "nodes",
+    "credentials",
+    "actual"
+  ],
+  "scripts": {
+    "test": "node test/actual-budget-test.cjs"
+  },
+  "dependencies": {
+    "@actual-app/api": "^25.12.0"
+  },
+  "n8n": {
+    "nodes": [
+      "nodes/ActualBudget.node.js"
+    ],
+    "credentials": [
+      "credentials/ActualBudgetApi.credentials.js"
+    ]
+  }
+}