@jaskrowo/xtb2sure 0.1.0 → 0.2.2

package/README.md

@@ -11,7 +11,7 @@ Convert XTB `.xlsx` exports into Sure-compatible CSV files.
 
 ## Requirements
 
-- Node.js 24
+- Node.js 24+
 
 ## Install
 
@@ -22,7 +22,7 @@ npm install
 ## Usage
 
 ```bash
-node --experimental-transform-types ./src/cli.ts convert <input.xlsx> --currency <CODE> --account "<ACCOUNT_NAME>"
+node ./src/cli.ts convert <input.xlsx> --currency <CODE> --account "<ACCOUNT_NAME>"
 ```
 
 Options:
@@ -37,11 +37,11 @@ Options:
 Examples:
 
 ```bash
-node --experimental-transform-types ./src/cli.ts convert sample_data/IKE/input.xlsx --currency USD --account "XTB IKE"
+node ./src/cli.ts convert sample_data/IKE/input.xlsx --currency USD --account "XTB IKE"
 ```
 
 ```bash
-node --experimental-transform-types ./src/cli.ts convert sample_data/PLN/input.xlsx --currency PLN --account "XTB PLN" --out-dir ./out
+node ./src/cli.ts convert sample_data/PLN/input.xlsx --currency PLN --account "XTB PLN" --out-dir ./out
 
 Or via npm script:
 

package/bin/xtb2sure.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../src/cli.ts";

package/package.json

@@ -1,30 +1,38 @@
 {
     "name": "@jaskrowo/xtb2sure",
-    "version": "0.1.0",
+    "version": "0.2.2",
     "description": "Convert XTB .xlsx exports into Sure-compatible CSV files",
     "main": "src/index.ts",
     "engines": {
-        "node": "24"
+        "node": ">=24"
     },
     "type": "module",
     "license": "MIT",
     "publishConfig": {
         "access": "public"
     },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/domeq/xtb2sure.git"
+    },
+    "files": [
+        "src",
+        "bin"
+    ],
     "bin": {
-        "xtb2sure": "./src/cli.ts"
+        "xtb2sure": "./bin/xtb2sure.js"
     },
     "scripts": {
-        "dev": "node --experimental-transform-types --watch src/index.ts",
-        "convert": "node --experimental-transform-types ./src/cli.ts convert",
+        "dev": "node --watch src/index.ts",
+        "convert": "node ./src/cli.ts convert",
         "format": "biome format --write .",
         "knip": "knip",
         "lint-fix": "biome check --write .",
         "lint": "biome check .",
         "prepare": "husky",
         "release": "release-it",
-        "start": "node --experimental-transform-types src/index.ts",
-        "test": "node --experimental-transform-types --test",
+        "start": "node src/index.ts",
+        "test": "node --test",
         "typecheck": "tsc --noEmit"
     },
     "lint-staged": {

package/src/cli.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S node --experimental-transform-types
+#!/usr/bin/env node
 
 import process from "node:process";
 import { Command, CommanderError } from "commander";

package/.editorconfig

@@ -1,30 +0,0 @@
-# EditorConfig helps developers define and maintain consistent coding styles between different editors and IDEs.
-# Requires EditorConfig JetBrains Plugin - http://github.com/editorconfig/editorconfig-jetbrains
-
-# Set this file as the topmost .editorconfig
-# (multiple files can be used, and are applied starting from current document location)
-root = true
-
-# Use bracketed regexp to target specific file types or file locations
-[*.{ts,js,tsx,json,yml,yaml}]
-
-# Use hard or soft tabs ["tab", "space"]
-indent_style = space
-
-# Size of a single indent [an integer, "tab"]
-indent_size = tab
-
-# Number of columns representing a tab character [an integer]
-tab_width = 4
-
-# Line breaks representation ["lf", "cr", "crlf"]
-end_of_line = lf
-
-# ["latin1", "utf-8", "utf-16be", "utf-16le"]
-charset = utf-8
-
-# Remove any whitespace characters preceding newline characters ["true", "false"]
-trim_trailing_whitespace = false
-
-# Ensure file ends with a newline when saving ["true", "false"]
-insert_final_newline = true

package/.github/actions/setup/action.yml

@@ -1,15 +0,0 @@
-name: Runtime & application setup
-description: Sets right node version, installs dependencies
-
-runs:
-    using: 'composite'
-    steps:
-        - name: Set correct node version
-          uses: actions/setup-node@v7
-          with:
-              node-version-file: package.json
-              cache: 'npm'
-              registry-url: 'https://registry.npmjs.org'
-        - name: Install dependencies
-          run: npm ci --quiet --no-audit --no-fund --ignore-scripts
-          shell: bash

package/.github/actions/validate-pr-title/action.yml

@@ -1,18 +0,0 @@
-name: Validate PR title
-description: Runs commitlint on the PR title
-
-runs:
-  using: composite
-  steps:
-    - name: Set correct node version
-      uses: actions/setup-node@v7
-      with:
-        node-version: 24.x
-    - name: Install commitlint
-      run: npm install -g @commitlint/cli @commitlint/config-conventional
-      shell: bash
-    - name: Validate PR title
-      env:
-        PR_TITLE: ${{ github.event.pull_request.title }}
-      run: echo "$PR_TITLE" | npx commitlint
-      shell: bash

package/.github/pull_request_template.md

@@ -1,3 +0,0 @@
-# Summary
-
-## Related issue(s)

package/.github/workflows/main.yml

@@ -1,51 +0,0 @@
-name: Main branch
-
-on:
-    workflow_dispatch:
-    push:
-        branches:
-            - main
-    merge_group:
-
-permissions:
-    id-token: write
-    contents: read
-
-env:
-    TZ: ${{ vars.TZ }}
-    FORCE_COLOR: 1
-
-jobs:
-    validate:
-        name: Validate
-        uses: ./.github/workflows/validate.yml
-        secrets: inherit
-
-    npm:
-        name: NPM audit
-        uses: ./.github/workflows/npm-audit.yml
-        secrets: inherit
-
-    release:
-        name: Release
-        needs: [validate]
-        runs-on: ubuntu-latest
-        concurrency: ${{ github.workflow }}-release
-        permissions:
-            contents: write
-            id-token: write
-        steps:
-        - uses: actions/checkout@v7
-          with:
-            fetch-depth: 0
-            token: ${{ secrets.RELEASE_TOKEN }}
-        - name: Select correct node version, install deps
-          uses: ./.github/actions/setup
-        - name: Configure git
-          run: |
-            git config user.name "domeq"
-            git config user.email "iskra.wojtek@gmail.com"
-        - name: Create a release
-          env:
-            GITHUB_TOKEN: ${{ secrets.RELEASE_TOKEN }}
-          run: npm run release -- --ci

package/.github/workflows/npm-audit.yml

@@ -1,23 +0,0 @@
-name: NPM
-
-on:
-  workflow_call:
-
-env:
-  TZ: Europe/Oslo
-
-jobs:
-  audit:
-    name: Audit
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    steps:
-      - uses: actions/checkout@v7
-      - name: Set correct node version
-        uses: actions/setup-node@v7
-        with:
-          node-version-file: package.json
-          cache: npm
-          registry-url: 'https://registry.npmjs.org'
-      - name: NPM Audit
-        run: npm audit --omit=dev --audit-level=high

package/.github/workflows/pr.yml

@@ -1,20 +0,0 @@
-name: PR
-
-on:
-    workflow_dispatch:
-    pull_request:
-
-permissions:
-    id-token: write
-    contents: read
-    pull-requests: write
-
-env:
-    TZ: ${{ vars.TZ }}
-    FORCE_COLOR: 1
-
-jobs:
-    validate:
-        name: Validate
-        uses: ./.github/workflows/validate.yml
-        secrets: inherit

package/.github/workflows/validate.yml

@@ -1,60 +0,0 @@
-name: Validate
-
-permissions:
-    id-token: write
-    contents: read
-
-on:
-    workflow_call:
-
-env:
-    TZ: ${{ vars.TZ }}
-
-jobs:
-    validate_pr_title:
-        runs-on: ubuntu-latest
-        name: Validate PR title
-        if: github.event.pull_request != null
-        timeout-minutes: 5
-        steps:
-            - uses: actions/checkout@v7
-            - name: Validate PR title
-              uses: ./.github/actions/validate-pr-title
-    linters:
-        name: Linters
-        runs-on: ubuntu-latest
-        timeout-minutes: 15
-        steps:
-            - uses: actions/checkout@v7
-            - uses: ./.github/actions/setup
-            - name: Lint
-              run: npm run lint
-    typecheck:
-        name: Typecheck
-        runs-on: ubuntu-latest
-        timeout-minutes: 15
-        steps:
-            - uses: actions/checkout@v7
-            - uses: ./.github/actions/setup
-            - name: Typecheck
-              run: npm run typecheck
-    knip:
-        name: Knip
-        runs-on: ubuntu-latest
-        timeout-minutes: 15
-        steps:
-            - uses: actions/checkout@v7
-            - uses: ./.github/actions/setup
-            - name: Knip
-              run: npm run knip
-            - name: Knip (production mode)
-              run: npm run knip -- --production
-    tests:
-        name: Tests
-        runs-on: ubuntu-latest
-        timeout-minutes: 15
-        steps:
-            - uses: actions/checkout@v7
-            - uses: ./.github/actions/setup
-            - name: Test
-              run: npm test

package/.husky/commit-msg

@@ -1 +0,0 @@
-npx --no -- commitlint --edit ${1}

package/.husky/pre-commit

@@ -1 +0,0 @@
-npx lint-staged

package/.release-it.cjs

@@ -1,41 +0,0 @@
-module.exports = {
-    git: {
-        // biome-ignore lint/suspicious/noTemplateCurlyInString: release-it placeholders
-        commitMessage: "chore: release ${version} \n\n${changelog}",
-        requireBranch: "main",
-        requireCleanWorkingDir: true,
-        // biome-ignore lint/suspicious/noTemplateCurlyInString: release-it placeholders
-        tagName: "v${version}",
-    },
-    github: {
-        release: true,
-        tokenRef: "GITHUB_TOKEN",
-    },
-    npm: {
-        publish: true,
-        skipChecks: true,
-    },
-    plugins: {
-        "@release-it/conventional-changelog": {
-            infile: "CHANGELOG.md",
-            preset: {
-                name: "conventionalcommits",
-                types: [
-                    { section: "Features", type: "feat" },
-                    { section: "Features", type: "feature" },
-                    { section: "Bug Fixes", type: "fix" },
-                    { section: "Performance Improvements", type: "perf" },
-                    { section: "Reverts", type: "revert" },
-                    { section: "Documentation", type: "docs" },
-                    { section: "Styles", type: "style" },
-                    { section: "Miscellaneous Chores", type: "chore" },
-                    { section: "Code Refactoring", type: "refactor" },
-                    { section: "Tests", type: "test" },
-                    { section: "Build System", type: "build" },
-                    { section: "Continuous Integration", type: "ci" },
-                    { section: "Configuration changes", type: "config" },
-                ],
-            },
-        },
-    },
-};

package/CODE_OF_CONDUCT.md

@@ -1,23 +0,0 @@
-# Code of Conduct
-
-## Our Pledge
-
-We are committed to providing a friendly, safe, and welcoming environment for everyone.
-
-## Our Standards
-
-Examples of positive behavior:
-
-- Being respectful and constructive
-- Accepting and giving feedback gracefully
-- Prioritizing collaboration and empathy
-
-Examples of unacceptable behavior:
-
-- Harassment, discrimination, or abusive language
-- Personal attacks or trolling
-- Publishing private information without consent
-
-## Enforcement
-
-Project maintainers are responsible for clarifying and enforcing this code of conduct.

package/CONTRIBUTING.md

@@ -1,26 +0,0 @@
-# Contributing
-
-Thanks for your interest in contributing to `xtb2sure`.
-
-## Setup
-
-1. Install Node.js 22+.
-2. Install dependencies:
-
-```bash
-npm install
-```
-
-## Validate changes
-
-Run the test suite before opening a pull request:
-
-```bash
-npm test
-```
-
-## Guidelines
-
-- Keep behavior deterministic and fixture-driven.
-- Add tests for every functional change.
-- Prefer small, focused pull requests.

package/SECURITY.md

@@ -1,11 +0,0 @@
-# Security Policy
-
-If you discover a security issue, please report it privately to the maintainers.
-
-Please include:
-
-- A clear description of the issue
-- Steps to reproduce
-- Potential impact
-
-Do not open public issues for security vulnerabilities.

package/biome.json

@@ -1,20 +0,0 @@
-{
-    "$schema": "https://biomejs.dev/schemas/2.2.6/schema.json",
-    "vcs": {
-        "enabled": true,
-        "clientKind": "git",
-        "useIgnoreFile": true
-    },
-    "formatter": {
-        "enabled": true,
-        "indentStyle": "space",
-        "indentWidth": 4,
-        "lineWidth": 120
-    },
-    "linter": {
-        "enabled": true,
-        "rules": {
-            "recommended": true
-        }
-    }
-}

package/commitlint.config.cjs

@@ -1,12 +0,0 @@
-module.exports = {
-    extends: ["@commitlint/config-conventional"],
-    rules: {
-        "body-max-line-length": [2, "always", Infinity],
-        "footer-max-line-length": [2, "always", Infinity],
-        "type-enum": [
-            2,
-            "always",
-            ["build", "chore", "ci", "config", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test"],
-        ],
-    },
-};

package/config/default.mjs

@@ -1,11 +0,0 @@
-const NAME = process.env.DD_SERVICE || "xtb2sure";
-const ENVIRONMENT = process.env.NODE_ENV || "development";
-const VERSION = process.env.npm_package_version || "dev";
-
-export default {
-    application: {
-        env: ENVIRONMENT,
-        name: NAME,
-        version: VERSION,
-    },
-};

package/docs/PRD.md

@@ -1,141 +0,0 @@
-# xtb2sure PRD
-
-## Goal
-
-Build an open-source TypeScript CLI that converts XTB `.xlsx` exports into two Sure-compatible CSV files:
-
-1. transactions CSV (for Sure Transactions import)
-2. investments CSV (for Sure Trades import)
-
-Target runtime is current Node LTS, executed directly via Node strip-types.
-
-## Confirmed Decisions
-
-- Input format: `.xlsx`
-- Source data: only `Cash Operations` sheet
-- Output: two CSVs per input file
-- Date output format: `YYYY-MM-DD`
-- Currency: required CLI parameter
-- Account: account-level label provided by CLI (e.g. `XTB PLN`, `XTB IKE`)
-- Include tax rows (`Free funds interest tax`, `Withholding tax`)
-- Ignore summary `Total` row
-- Trade ticker uses XTB input as-is (e.g. `EIMI.UK`, `IUSQ.DE`)
-
-## Input Schema (XTB Cash Operations)
-
-Relevant columns:
-- `Type`
-- `Instrument`
-- `Ticker`
-- `Time`
-- `Amount`
-- `ID`
-- `Comment`
-- `Product`
-- `Position ID`
-
-## Output A: Transactions CSV
-
-Header:
-- `date,amount,name,account,notes`
-
-Includes operation types:
-- `Deposit`
-- `IKE deposit`
-- `IKZE deposit`
-- `Free funds interest`
-- `Free funds interest tax`
-- `Withholding tax`
-
-Mapping:
-- `date` from `Time` (Excel serial UTC) -> `YYYY-MM-DD`
-- `amount` from `Amount` (signed as-is)
-- `name` from `Type` (or normalized label if fixture requires)
-- `account` from CLI account label
-- `notes` as traceable text including `XTB <ID>` and source comment
-
-## Output B: Investments CSV
-
-Header:
-- `date,ticker,currency,qty,price,account,name`
-
-Includes operation types:
-- `Stock purchase`
-- `Stock sell`
-
-Mapping:
-- `date` from `Time` -> `YYYY-MM-DD`
-- `ticker` from XTB `Ticker` as-is (e.g. `IPOL.UK`, `SXRV.DE`)
-- `currency` from CLI currency argument
-- `qty` parsed from `Comment` (sell rows negative where reflected in fixture)
-- `price` parsed from `Comment` (`@ <price>`)
-- `account` from CLI account label
-- `name` fixture-compatible human-readable label including `XTB <ID>`
-
-## CLI (v1)
-
-Command:
-- `xtb2sure convert <input.xlsx> --currency <CODE> --account "<ACCOUNT_NAME>"`
-
-Options:
-- `--out-dir <dir>`
-- `--transactions-out <file>`
-- `--investments-out <file>`
-- `--strict`
-- `--dry-run`
-- `--report <file>`
-
-Exit codes:
-- `0` success
-- `1` conversion/validation failure
-- `2` usage/config error
-
-## TDD Plan
-
-### Unit tests
-- Excel serial date conversion
-- operation classification (transaction/investment/ignored)
-- qty/price parser from comment text
-- per-row mapping by type
-
-### Integration tests (fixture exact)
-- `sample_data/IKE/input.xlsx` -> exact match:
-  - `sample_data/IKE/output_transactions.csv`
-  - `sample_data/IKE/output_investments.csv`
-- `sample_data/PLN/input.xlsx` -> exact match:
-  - `sample_data/PLN/output_transactions.csv`
-  - `sample_data/PLN/output_investments.csv`
-- investments schema regression checks:
-  - `ticker` equals source `Cash Operations.Ticker` value for the matching XTB operation ID
-
-### CLI tests
-- required args validation (`--currency`, `--account`)
-- output file generation
-- `--dry-run` behavior
-- strict-mode failure behavior
-- summary counters and exit codes
-
-## Open Source Baseline
-
-Include in repo from the beginning:
-- `README.md`
-- `LICENSE` (permissive and inclusive; MIT recommended unless you choose otherwise)
-- `CONTRIBUTING.md`
-- `CODE_OF_CONDUCT.md`
-- optional but recommended: `SECURITY.md`, CI workflow, issue templates
-
-## Non-goals (v1)
-
-- `Closed Positions` / `Open Positions` parsing
-- Sure API upload automation
-- FX conversion logic
-- Data enrichment beyond deterministic mapping
-
-## Fixture Status
-
-Current fixtures are aligned and usable for TDD:
-- `sample_data/IKE`
-- `sample_data/PLN`
-
-Investments outputs now use:
-- ticker from input as-is

package/knip.config.js

@@ -1,5 +0,0 @@
-const config = {
-    project: ["src/**!", "test/**!"],
-};
-
-export default config;

package/renovate.json

@@ -1,10 +0,0 @@
-{
-    "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-    "extends": ["config:recommended"],
-    "packageRules": [
-        {
-            "automerge": true,
-            "matchUpdateTypes": ["minor", "patch"]
-        }
-    ]
-}

package/test/cli.test.ts

@@ -1,148 +0,0 @@
-import assert from "node:assert/strict";
-import { spawn } from "node:child_process";
-import { access, mkdtemp, readFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import test from "node:test";
-import { fileURLToPath } from "node:url";
-import xlsx from "xlsx";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.resolve(__dirname, "..");
-const cliPath = path.join(rootDir, "src", "cli.ts");
-
-test("CLI validates required --currency and --account args", async () => {
-    const result = await runCli([
-        "convert",
-        path.join(rootDir, "test", "fixtures", "IKE", "input.xlsx"),
-        "--currency",
-        "USD",
-    ]);
-
-    assert.equal(result.code, 2);
-    assert.match(result.stderr, /required option/);
-});
-
-test("CLI generates output files", async () => {
-    const tmpDir = await mkdtemp(path.join(os.tmpdir(), "xtb2sure-cli-"));
-    const txPath = path.join(tmpDir, "tx.csv");
-    const invPath = path.join(tmpDir, "inv.csv");
-
-    const result = await runCli([
-        "convert",
-        path.join(rootDir, "test", "fixtures", "IKE", "input.xlsx"),
-        "--currency",
-        "USD",
-        "--account",
-        "XTB IKE",
-        "--transactions-out",
-        txPath,
-        "--investments-out",
-        invPath,
-    ]);
-
-    assert.equal(result.code, 0);
-    await access(txPath);
-    await access(invPath);
-});
-
-test("CLI dry-run does not create output files", async () => {
-    const tmpDir = await mkdtemp(path.join(os.tmpdir(), "xtb2sure-dry-"));
-    const txPath = path.join(tmpDir, "tx.csv");
-    const invPath = path.join(tmpDir, "inv.csv");
-
-    const result = await runCli([
-        "convert",
-        path.join(rootDir, "test", "fixtures", "IKE", "input.xlsx"),
-        "--currency",
-        "USD",
-        "--account",
-        "XTB IKE",
-        "--transactions-out",
-        txPath,
-        "--investments-out",
-        invPath,
-        "--dry-run",
-    ]);
-
-    assert.equal(result.code, 0);
-    await assert.rejects(() => access(txPath));
-    await assert.rejects(() => access(invPath));
-});
-
-test("CLI strict mode fails when mapping issue is encountered", async () => {
-    const tmpDir = await mkdtemp(path.join(os.tmpdir(), "xtb2sure-strict-"));
-    const inputPath = path.join(tmpDir, "bad.xlsx");
-    const reportPath = path.join(tmpDir, "report.json");
-    await writeInvalidTradeWorkbook(inputPath);
-
-    const strictResult = await runCli([
-        "convert",
-        inputPath,
-        "--currency",
-        "USD",
-        "--account",
-        "XTB TEST",
-        "--strict",
-        "--report",
-        reportPath,
-    ]);
-
-    assert.equal(strictResult.code, 1);
-
-    const relaxedResult = await runCli([
-        "convert",
-        inputPath,
-        "--currency",
-        "USD",
-        "--account",
-        "XTB TEST",
-        "--report",
-        reportPath,
-    ]);
-
-    assert.equal(relaxedResult.code, 0);
-    const report = JSON.parse(await readFile(reportPath, "utf8"));
-    assert.equal(report.totals.issues, 1);
-});
-
-function runCli(args: string[]): Promise<{ code: number | null; stdout: string; stderr: string }> {
-    return new Promise((resolve, reject) => {
-        const child = spawn(process.execPath, ["--experimental-transform-types", cliPath, ...args], {
-            cwd: rootDir,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-
-        let stdout = "";
-        let stderr = "";
-
-        child.stdout.on("data", (chunk) => {
-            stdout += String(chunk);
-        });
-
-        child.stderr.on("data", (chunk) => {
-            stderr += String(chunk);
-        });
-
-        child.on("error", reject);
-        child.on("close", (code) => {
-            resolve({ code, stdout, stderr });
-        });
-    });
-}
-
-async function writeInvalidTradeWorkbook(outPath: string): Promise<void> {
-    const worksheet = xlsx.utils.aoa_to_sheet([
-        ["Account number", "123"],
-        ["Cash Operations"],
-        ["Date from (UTC)", 46000],
-        ["Date to (UTC)", 46001],
-        ["Type", "Instrument", "Ticker", "Category", "Time", "Amount", "ID", "Comment", "Product", "Position ID"],
-        ["Stock purchase", "Test instrument", "TEST.UK", "", 46000.5, 123.45, "1", "BROKEN COMMENT", "My Trades", ""],
-    ]);
-
-    const workbook = xlsx.utils.book_new();
-    xlsx.utils.book_append_sheet(workbook, worksheet, "Cash Operations");
-    xlsx.writeFile(workbook, outPath);
-}

package/test/date.test.ts

@@ -1,8 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { excelSerialToYYYYMMDD } from "../src/date.ts";
-
-test("excelSerialToYYYYMMDD converts known fixture serials", () => {
-    assert.equal(excelSerialToYYYYMMDD(46266.43755445602), "2026-09-01");
-    assert.equal(excelSerialToYYYYMMDD(46079.041666666664), "2026-02-26");
-});

package/test/fixtures/IKE/output_investments.csv

@@ -1,3 +0,0 @@
-date,ticker,currency,qty,price,account,name
-2026-04-30,EIMI.UK,USD,24,51.81,XTB IKE,XTB 900000003: Stock purchase
-2026-04-30,IPOL.UK,USD,0.6747,35.68993627,XTB IKE,XTB 900000004: Stock purchase

package/test/fixtures/IKE/output_transactions.csv

@@ -1,3 +0,0 @@
-date,amount,name,account,notes
-2026-09-01,0.11,Free funds interest,XTB IKE,XTB 900000001: Mock interest period 2026-08
-2026-04-30,14556.14,IKE deposit,XTB IKE,XTB 900000002: Mock transfer in from account 100001

package/test/fixtures/PLN/output_investments.csv

@@ -1,5 +0,0 @@
-date,ticker,currency,qty,price,account,name
-2026-01-05,IUSQ.DE,PLN,1.0,93.88,XTB PLN,MSCI ACWI - Stock purchase (XTB 910000005)
-2026-01-06,IPOL.UK,PLN,3.0,34.04666667,XTB PLN,MSCI Poland - Stock purchase (XTB 910000007)
-2026-01-09,SXR8.DE,PLN,-0.1019,637.68400393,XTB PLN,Core S&P 500 - Stock sell (XTB 910000006)
-2026-01-21,EIMI.UK,PLN,114.0,47.33,XTB PLN,Core MSCI EM IMI - Stock purchase (XTB 910000008)

package/test/fixtures/PLN/output_transactions.csv

@@ -1,6 +0,0 @@
-date,amount,name,account,notes
-2026-09-04,5000.00,Deposit,XTB PLN,XTB 910000001: Mock bank deposit txn=MOCK-TXN-001 [subaccount: Investment Plans]
-2026-03-05,0.01,Free funds interest,XTB PLN,XTB 910000002: Mock free-funds interest 2026-02 [subaccount: My Trades]
-2026-03-05,-0.01,Free funds interest tax,XTB PLN,XTB 910000003: Mock free-funds interest tax 2026-02 [subaccount: My Trades]
-2026-01-02,0.93,Withholding tax,XTB PLN,XTB 910000004: mock WHT correction [subaccount: Investment Plans]
-2026-02-26,-11304.00,IKZE deposit,XTB PLN,XTB 910000009: Mock transfer out to IKZE 200002 [subaccount: My Trades]

package/test/integration.test.ts

@@ -1,171 +0,0 @@
-import assert from "node:assert/strict";
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import test from "node:test";
-import { fileURLToPath } from "node:url";
-import { readCashOperationsSheet } from "../src/excel.ts";
-import { convertFile } from "../src/index.ts";
-import { classifyOperation } from "../src/operations.ts";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.resolve(__dirname, "..");
-
-test("IKE fixture conversion matches expected outputs", async () => {
-    const result = await convertFile({
-        account: "XTB IKE",
-        currency: "USD",
-        dryRun: true,
-        inputPath: path.join(rootDir, "test", "fixtures", "IKE", "input.xlsx"),
-    });
-
-    const expectedTransactions = await readExpected("test/fixtures/IKE/output_transactions.csv");
-    const expectedInvestments = await readExpected("test/fixtures/IKE/output_investments.csv");
-
-    assert.equal(normalizeEol(result.transactionsCsv), expectedTransactions);
-    assert.equal(normalizeEol(result.investmentsCsv), expectedInvestments);
-});
-
-test("PLN fixture conversion matches expected outputs", async () => {
-    const result = await convertFile({
-        account: "XTB PLN",
-        currency: "PLN",
-        dryRun: true,
-        inputPath: path.join(rootDir, "test", "fixtures", "PLN", "input.xlsx"),
-    });
-
-    const expectedTransactions = await readExpected("test/fixtures/PLN/output_transactions.csv");
-    const expectedInvestments = await readExpected("test/fixtures/PLN/output_investments.csv");
-
-    assert.equal(normalizeEol(result.transactionsCsv), expectedTransactions);
-    assert.equal(normalizeEol(result.investmentsCsv), expectedInvestments);
-});
-
-test("investment ticker regression: output ticker equals source ticker by XTB operation ID", async () => {
-    const inputPath = path.join(rootDir, "test", "fixtures", "PLN", "input.xlsx");
-    const result = await convertFile({
-        account: "XTB PLN",
-        currency: "PLN",
-        dryRun: true,
-        inputPath,
-    });
-
-    const rows = readCashOperationsSheet(inputPath);
-    const byId = new Map<string, string>();
-
-    for (const row of rows) {
-        if (classifyOperation(row.Type) === "investment") {
-            byId.set(row.ID, row.Ticker);
-        }
-    }
-
-    for (const line of normalizeEol(result.investmentsCsv).split("\n").slice(1)) {
-        if (!line.trim()) {
-            continue;
-        }
-
-        const cells = parseCsvLine(line);
-        const ticker = cells[1];
-        const name = cells[6];
-        assert.ok(typeof ticker === "string" && ticker.length > 0);
-        assert.ok(typeof name === "string" && name.length > 0);
-        const idMatch = name.match(/XTB\s+(\d+)/);
-        assert.ok(idMatch, `Missing XTB ID in row: ${line}`);
-        const id = idMatch[1];
-        assert.ok(id);
-        assert.equal(ticker, byId.get(id));
-    }
-});
-
-test("investment currency is always taken from CLI argument", async () => {
-    const result = await convertFile({
-        account: "XTB PLN",
-        currency: "PLN",
-        dryRun: true,
-        inputPath: path.join(rootDir, "test", "fixtures", "PLN", "input.xlsx"),
-    });
-
-    for (const line of normalizeEol(result.investmentsCsv).split("\n").slice(1)) {
-        if (!line.trim()) {
-            continue;
-        }
-
-        const cells = parseCsvLine(line);
-        assert.equal(cells[2], "PLN");
-    }
-});
-
-test("investment price is derived from Amount and qty", async () => {
-    const inputPath = path.join(rootDir, "test", "fixtures", "PLN", "input.xlsx");
-    const result = await convertFile({
-        account: "XTB PLN",
-        currency: "PLN",
-        dryRun: true,
-        inputPath,
-    });
-
-    const rows = readCashOperationsSheet(inputPath);
-    const amountById = new Map<string, number>();
-
-    for (const row of rows) {
-        if (classifyOperation(row.Type) === "investment") {
-            amountById.set(row.ID, Math.abs(row.Amount));
-        }
-    }
-
-    for (const line of normalizeEol(result.investmentsCsv).split("\n").slice(1)) {
-        if (!line.trim()) {
-            continue;
-        }
-
-        const cells = parseCsvLine(line);
-        const qty = Math.abs(Number(cells[3]));
-        const price = Number(cells[4]);
-        const name = cells[6] ?? "";
-        const idMatch = name.match(/XTB\s+(\d+)/);
-        assert.ok(idMatch, `Missing XTB ID in row: ${line}`);
-        const id = idMatch[1];
-        assert.ok(id);
-        const expectedAmount = amountById.get(id);
-        assert.ok(typeof expectedAmount === "number", `No amount found for ID ${id}`);
-
-        const actualAmount = qty * price;
-        assert.ok(Math.abs(actualAmount - expectedAmount) < 0.02, `Amount mismatch for ${id}`);
-    }
-});
-
-async function readExpected(relativePath: string): Promise<string> {
-    const value = await readFile(path.join(rootDir, relativePath), "utf8");
-    return normalizeEol(value);
-}
-
-function normalizeEol(value: string): string {
-    return value.replace(/\r\n/g, "\n");
-}
-
-function parseCsvLine(line: string): string[] {
-    const cells: string[] = [];
-    let current = "";
-    let inQuotes = false;
-
-    for (let i = 0; i < line.length; i += 1) {
-        const char = line[i];
-        if (char === '"') {
-            if (inQuotes && line[i + 1] === '"') {
-                current += '"';
-                i += 1;
-            } else {
-                inQuotes = !inQuotes;
-            }
-        } else if (char === "," && !inQuotes) {
-            cells.push(current);
-            current = "";
-        } else {
-            current += char;
-        }
-    }
-
-    cells.push(current);
-
-    return cells;
-}

package/test/operations.test.ts

@@ -1,23 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { classifyOperation, parseTradeValues } from "../src/operations.ts";
-
-test("classifyOperation maps supported operation groups", () => {
-    assert.equal(classifyOperation("Deposit"), "transaction");
-    assert.equal(classifyOperation("Stock purchase"), "investment");
-    assert.equal(classifyOperation("Total"), "ignored");
-});
-
-test("parseTradeValues parses BUY format with split quantity", () => {
-    const parsed = parseTradeValues("OPEN BUY 7/7.7575 @ 42.750");
-    assert.equal(parsed.qty, "7");
-    assert.equal(parsed.price, "42.75");
-    assert.equal(parsed.qtyHadExplicitDecimal, false);
-});
-
-test("parseTradeValues parses SELL format with decimal-preserving integer price", () => {
-    const parsed = parseTradeValues("CLOSE SELL 0.9179 @ 1233.0");
-    assert.equal(parsed.qty, "0.9179");
-    assert.equal(parsed.price, "1233.0");
-    assert.equal(parsed.qtyHadExplicitDecimal, true);
-});

package/tsconfig.json

@@ -1,24 +0,0 @@
-{
-    "compilerOptions": {
-        "skipLibCheck": true,
-        "target": "esnext",
-        "resolveJsonModule": true,
-        "verbatimModuleSyntax": true,
-        "rootDir": ".",
-        "allowImportingTsExtensions": true,
-        "noEmit": true,
-        "module": "NodeNext",
-        "esModuleInterop": true,
-        "strict": true,
-        "noUncheckedIndexedAccess": true,
-        "noImplicitOverride": true,
-        "forceConsistentCasingInFileNames": true,
-        "allowJs": false,
-        "baseUrl": "./",
-        "paths": {
-            "#*": ["./src/*"]
-        }
-    },
-    "include": ["**/*"],
-    "exclude": ["node_modules", "dist"]
-}