degiro-report 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * Module dependencies.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Module dependencies.
+ */
+import { generateReport, formatReport } from "./report.js";
+import { parseCsv } from "./parser.js";
+import { resolve } from "node:path";
+const filePath = process.argv[2];
+if (!filePath) {
+    console.error("Usage: degiro-report <path-to-degiro-csv>");
+    process.exit(1);
+}
+const transactions = parseCsv(resolve(filePath));
+const reports = generateReport(transactions);
+console.log(formatReport(reports));

package/dist/parser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Module dependencies.
+ */
+/**
+ * Export `Transaction` type.
+ */
+export interface Transaction {
+    date: string;
+    time: string;
+    product: string;
+    isin: string;
+    quantity: number;
+    price: number;
+    valueEur: number;
+    fees: number;
+    totalEur: number;
+}
+/**
+ * Parse CSV.
+ */
+export declare function parseCsv(filePath: string): Transaction[];

package/dist/parser.js

@@ -0,0 +1,80 @@
+/**
+ * Module dependencies.
+ */
+import { readFileSync } from "node:fs";
+/**
+ * Parse a European-format number string like "1.234,56" into a JS number.
+ */
+function parseEuNumber(raw) {
+    if (!raw || raw.trim() === "")
+        return 0;
+    const replacedSeparators = raw.replace(/\./g, '').replace(",", ".");
+    return parseFloat(replacedSeparators);
+}
+/**
+ * Parse a DEGIRO Transactions CSV that uses commas as field delimiters
+ * and European number format (commas as decimal separators inside quoted fields).
+ *
+ * Fields containing commas are wrapped in double-quotes by DEGIRO.
+ */
+function splitCsvLine(line) {
+    const fields = [];
+    let parsedField = "";
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const character = line[i];
+        if (character === '"') {
+            inQuotes = !inQuotes;
+        }
+        else if (character === "," && !inQuotes) {
+            fields.push(parsedField);
+            parsedField = "";
+        }
+        else {
+            parsedField += character;
+        }
+    }
+    fields.push(parsedField);
+    return fields;
+}
+/**
+ * Parse CSV.
+ */
+export function parseCsv(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    const lines = content.split("\n").filter((l) => l.trim().length > 0);
+    // Skip header
+    const dataLines = lines.slice(1);
+    return dataLines.map((line) => {
+        const cols = splitCsvLine(line);
+        // Columns:
+        //  0  Date
+        //  1  Time
+        //  2  Product
+        //  3  ISIN
+        //  4  Reference exchange
+        //  5  Venue
+        //  6  Quantity
+        //  7  Price
+        //  8  (price currency)
+        //  9  Local value
+        // 10  (local value currency)
+        // 11  Value EUR
+        // 12  Exchange rate
+        // 13  AutoFX Fee
+        // 14  Transaction and/or third party fees EUR
+        // 15  Total EUR
+        // 16  Order ID (sometimes empty before the UUID)
+        return {
+            date: cols[0],
+            time: cols[1],
+            product: cols[2],
+            isin: cols[3],
+            quantity: parseEuNumber(cols[6]),
+            price: parseEuNumber(cols[7]),
+            valueEur: parseEuNumber(cols[11]),
+            fees: parseEuNumber(cols[14]),
+            totalEur: parseEuNumber(cols[15]),
+        };
+    });
+}

package/dist/report.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Module dependencies.
+ */
+import type { Transaction } from "./parser.js";
+/**
+ * Export `AssetReport` type.
+ */
+export interface AssetReport {
+    product: string;
+    isin: string;
+    buyQuantity: number;
+    buyTotalEur: number;
+    sellQuantity: number;
+    sellTotalEur: number;
+    totalFees: number;
+    breakEvenPrice: number;
+    avgSellPrice: number;
+    remainingQuantity: number;
+    realizedPnl: number;
+}
+/**
+ * Generate report from transactions list.
+ */
+export declare function generateReport(transactions: Transaction[]): AssetReport[];
+export declare function formatReport(reports: AssetReport[]): string;

package/dist/report.js

@@ -0,0 +1,133 @@
+/**
+ * Module dependencies.
+ */
+import chalk from "chalk";
+/**
+ * Generate report from transactions list.
+ */
+export function generateReport(transactions) {
+    const transactionsByAsset = new Map();
+    for (const tx of transactions) {
+        const key = tx.isin;
+        if (!transactionsByAsset.has(key)) {
+            transactionsByAsset.set(key, []);
+        }
+        transactionsByAsset.get(key).push(tx);
+    }
+    const reports = [];
+    for (const [isin, txs] of transactionsByAsset) {
+        // Sort chronologically (oldest first) for FIFO cost basis
+        txs.sort((a, b) => {
+            const dateA = parseDate(a.date, a.time);
+            const dateB = parseDate(b.date, b.time);
+            return dateA.getTime() - dateB.getTime();
+        });
+        const product = txs[0].product;
+        let buyQuantity = 0;
+        let buyTotalEur = 0; // total cost (positive number)
+        let sellQuantity = 0;
+        let sellTotalEur = 0; // total proceeds (positive number)
+        let totalFees = 0;
+        // FIFO lot queue: each entry is { qty, pricePerUnit }
+        const lots = [];
+        let realizedPnl = 0;
+        for (const tx of txs) {
+            totalFees += Math.abs(tx.fees);
+            if (tx.quantity > 0) {
+                // Buy
+                const cost = Math.abs(tx.valueEur);
+                buyQuantity += tx.quantity;
+                buyTotalEur += cost;
+                lots.push({ qty: tx.quantity, pricePerUnit: tx.price });
+            }
+            else {
+                // Sell
+                const qty = Math.abs(tx.quantity);
+                const proceeds = Math.abs(tx.valueEur);
+                sellQuantity += qty;
+                sellTotalEur += proceeds;
+                const sellPrice = tx.price;
+                // Match against FIFO lots
+                let remaining = qty;
+                while (remaining > 0 && lots.length > 0) {
+                    const lot = lots[0];
+                    const matched = Math.min(remaining, lot.qty);
+                    realizedPnl += matched * (sellPrice - lot.pricePerUnit);
+                    lot.qty -= matched;
+                    remaining -= matched;
+                    if (lot.qty <= 0)
+                        lots.shift();
+                }
+            }
+        }
+        const remainingQuantity = buyQuantity - sellQuantity;
+        const breakEvenPrice = buyQuantity > 0 ? buyTotalEur / buyQuantity : 0;
+        const avgSellPrice = sellQuantity > 0 ? sellTotalEur / sellQuantity : 0;
+        reports.push({
+            product,
+            isin,
+            buyQuantity,
+            buyTotalEur,
+            sellQuantity,
+            sellTotalEur,
+            totalFees,
+            breakEvenPrice,
+            avgSellPrice,
+            remainingQuantity,
+            realizedPnl,
+        });
+    }
+    // Sort by product name
+    reports.sort((a, b) => a.product.localeCompare(b.product));
+    return reports;
+}
+/**
+ * Parse date.
+ */
+function parseDate(date, time) {
+    // date = "DD-MM-YYYY", time = "HH:MM"
+    const [d, m, y] = date.split("-");
+    return new Date(`${y}-${m}-${d}T${time}:00`);
+}
+export function formatReport(reports) {
+    const lines = [];
+    const eur = (n) => n.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+    const printPnL = (n, text) => (n >= 0 ? chalk.green(text) : chalk.red(text));
+    lines.push("=".repeat(80));
+    lines.push("  DEGIRO PORTFOLIO REPORT");
+    lines.push("=".repeat(80));
+    lines.push("");
+    let totalRealizedPnl = 0;
+    let totalFees = 0;
+    let totalBought = 0;
+    let totalSold = 0;
+    for (const r of reports) {
+        totalRealizedPnl += r.realizedPnl;
+        totalFees += r.totalFees;
+        totalBought += r.buyTotalEur;
+        totalSold += r.sellTotalEur;
+        const netPnl = r.realizedPnl - r.totalFees;
+        lines.push(`  ${r.product}`);
+        lines.push(`  ISIN: ${r.isin}`);
+        lines.push("-".repeat(80));
+        lines.push(`  Bought:           ${r.buyQuantity} units   @ avg ${eur(r.breakEvenPrice)} EUR   = ${eur(r.buyTotalEur)} EUR`);
+        lines.push(`  Sold:             ${r.sellQuantity} units   @ avg ${eur(r.avgSellPrice)} EUR   = ${eur(r.sellTotalEur)} EUR`);
+        lines.push(`  Remaining:        ${r.remainingQuantity} units`);
+        lines.push(`  Break-even price: ${eur(r.breakEvenPrice)} EUR`);
+        lines.push(`  Total fees:       ${chalk.yellow(`${eur(r.totalFees)} EUR`)}`);
+        lines.push(`  Realized P&L:     ${printPnL(r.realizedPnl, `${r.realizedPnl >= 0 ? "+" : ""}${eur(r.realizedPnl)} EUR`)}`);
+        lines.push(`  Net P&L (w/fees): ${printPnL(netPnl, `${netPnl >= 0 ? "+" : ""}${eur(netPnl)} EUR`)}`);
+        lines.push("");
+    }
+    const totalNetPnl = totalRealizedPnl - totalFees;
+    lines.push("=".repeat(80));
+    lines.push("  SUMMARY");
+    lines.push("=".repeat(80));
+    lines.push(`  Total bought:       ${eur(totalBought)} EUR`);
+    lines.push(`  Total sold:         ${eur(totalSold)} EUR`);
+    lines.push(`  Total fees:         ${chalk.yellow(`${eur(totalFees)} EUR`)}`);
+    lines.push(`  Total realized P&L: ${printPnL(totalRealizedPnl, `${totalRealizedPnl >= 0 ? "+" : ""}${eur(totalRealizedPnl)} EUR`)}`);
+    lines.push(`  Net P&L (w/fees):   ${printPnL(totalNetPnl, `${totalNetPnl >= 0 ? "+" : ""}${eur(totalNetPnl)} EUR`)}`);
+    lines.push("");
+    return lines.join("\n");
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "degiro-report",
+  "version": "1.0.0",
+  "description": "Parse Degiro transaction CSVs and generate portfolio reports",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "degiro-report": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "degiro",
+    "portfolio",
+    "transactions",
+    "report",
+    "csv"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2"
+  }
+}