create-kvitton 0.4.0

package/dist/lib/env.js

@@ -0,0 +1,8 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export async function createEnvFile(repoPath, variables) {
+    const lines = Object.entries(variables)
+        .map(([key, value]) => `${key}=${value}`)
+        .join("\n");
+    await fs.writeFile(path.join(repoPath, ".env"), `${lines}\n`);
+}

package/dist/lib/git.js

@@ -0,0 +1,32 @@
+import simpleGit from "simple-git";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+const GITIGNORE = `# Environment files with secrets
+.env
+.env.*
+
+# CLI cache
+.kvitton/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+`;
+export async function initGitRepo(repoPath) {
+    const git = simpleGit(repoPath);
+    await git.init();
+    await fs.writeFile(path.join(repoPath, ".gitignore"), GITIGNORE);
+}
+export async function commitAll(repoPath, message) {
+    const git = simpleGit(repoPath);
+    await git.add(".");
+    const status = await git.status();
+    if (status.files.length > 0) {
+        await git.commit(message);
+    }
+}

package/dist/sync/bokio-sync.js

@@ -0,0 +1,142 @@
+import { FilesystemStorageService, mapBokioEntryToJournalEntry, journalEntryPath, journalEntryDirFromPath, toYaml, fiscalYearDirName, downloadFilesForEntry, } from "sync";
+/**
+ * Create a FileDownloader adapter for BokioClient
+ */
+function createBokioDownloader(client) {
+    return {
+        async getFilesForEntry(journalEntryId) {
+            // Bokio API requires query format: journalEntryId==UUID
+            const response = await client.getUploads({
+                query: `journalEntryId==${journalEntryId}`,
+            });
+            return response.data.map((upload) => ({
+                id: upload.id,
+                contentType: upload.contentType,
+                description: upload.description ?? undefined,
+            }));
+        },
+        async downloadFile(id) {
+            return client.downloadFile(id);
+        },
+    };
+}
+export async function syncJournalEntries(client, repoPath, options, onProgress) {
+    const storage = new FilesystemStorageService(repoPath);
+    // 1. Fetch fiscal years
+    const fiscalYearsResponse = await client.getFiscalYears();
+    const fiscalYears = fiscalYearsResponse.data;
+    // 2. Fetch total count first for progress display
+    const firstPage = await client.getJournalEntries({ page: 1, pageSize: 1 });
+    const totalEntries = firstPage.pagination.totalItems;
+    onProgress({ current: 0, total: totalEntries, message: "Starting sync..." });
+    if (totalEntries === 0) {
+        // Write fiscal years even if no entries
+        await writeFiscalYearsMetadata(storage, fiscalYears);
+        return {
+            entriesCount: 0,
+            fiscalYearsCount: fiscalYears.length,
+            entriesWithFilesDownloaded: 0,
+        };
+    }
+    // 3. Fetch all entries with pagination
+    const allEntries = [];
+    let page = 1;
+    const pageSize = 100;
+    while (true) {
+        const response = await client.getJournalEntries({ page, pageSize });
+        allEntries.push(...response.data);
+        onProgress({ current: allEntries.length, total: totalEntries });
+        if (!response.pagination.hasNextPage)
+            break;
+        page++;
+    }
+    // 4. Write each entry and download files
+    let entriesWithFilesDownloaded = 0;
+    const downloader = createBokioDownloader(client);
+    for (const entry of allEntries) {
+        const fiscalYear = findFiscalYear(entry.date, fiscalYears);
+        if (!fiscalYear)
+            continue;
+        const fyYear = parseInt(fiscalYear.startDate.slice(0, 4), 10);
+        const entryDir = await writeJournalEntry(storage, fyYear, entry);
+        // Download files for this entry if enabled
+        if (options.downloadFiles !== false && entryDir) {
+            const filesDownloaded = await downloadFilesForEntry({
+                storage,
+                repoPath,
+                entryDir,
+                journalEntryId: entry.id,
+                downloader,
+                sourceIntegration: "bokio",
+            });
+            if (filesDownloaded > 0) {
+                entriesWithFilesDownloaded++;
+            }
+        }
+    }
+    // 5. Write fiscal year metadata
+    await writeFiscalYearsMetadata(storage, fiscalYears);
+    return {
+        entriesCount: allEntries.length,
+        fiscalYearsCount: fiscalYears.length,
+        entriesWithFilesDownloaded,
+    };
+}
+function findFiscalYear(date, fiscalYears) {
+    return fiscalYears.find((fy) => date >= fy.startDate && date <= fy.endDate);
+}
+async function writeJournalEntry(storage, fyYear, entry) {
+    // Transform Bokio entry to unified format
+    const journalEntry = mapBokioEntryToJournalEntry({
+        id: entry.id,
+        journalEntryNumber: entry.journalEntryNumber,
+        date: entry.date,
+        title: entry.title,
+        items: entry.items.map((item) => ({
+            account: item.account,
+            debit: item.debit,
+            credit: item.credit,
+        })),
+    });
+    // Generate path
+    const entryPath = journalEntryPath(fyYear, journalEntry.series ?? null, journalEntry.entryNumber, journalEntry.entryDate, journalEntry.description);
+    // Write YAML
+    const yamlContent = toYaml(journalEntry);
+    await storage.writeFile(entryPath, yamlContent);
+    // Return directory path for file downloads
+    return journalEntryDirFromPath(entryPath);
+}
+async function writeFiscalYearsMetadata(storage, fiscalYears) {
+    for (const fy of fiscalYears) {
+        const fyDir = fiscalYearDirName({ start_date: fy.startDate });
+        const metadataPath = `journal-entries/${fyDir}/_fiscal-year.yaml`;
+        const metadata = {
+            id: fy.id,
+            startDate: fy.startDate,
+            endDate: fy.endDate,
+            status: fy.status,
+        };
+        const yamlContent = toYaml(metadata);
+        await storage.writeFile(metadataPath, yamlContent);
+    }
+}
+/**
+ * Sync chart of accounts from Bokio to accounts.yaml
+ */
+export async function syncChartOfAccounts(client, repoPath) {
+    const storage = new FilesystemStorageService(repoPath);
+    // Fetch chart of accounts
+    const bokioAccounts = await client.getChartOfAccounts();
+    // Sort by account number and transform to expected format
+    const accounts = [...bokioAccounts]
+        .sort((a, b) => a.account - b.account)
+        .map((account) => ({
+        code: account.account.toString(),
+        name: account.name,
+        description: account.name,
+    }));
+    // Write accounts.yaml
+    const yamlContent = toYaml({ accounts });
+    await storage.writeFile("accounts.yaml", yamlContent);
+    return { accountsCount: accounts.length };
+}

package/dist/templates/AGENTS.md

@@ -0,0 +1,95 @@
+# AGENTS.md
+
+This is an accounting data repository for {{COMPANY_NAME}} (Swedish company), storing financial records, journal entries, and documents. It integrates with {{PROVIDER}} (Swedish accounting software) for document management.
+
+## Repository Structure
+
+```
+/
+├── accounts.yaml           # Swedish chart of accounts (account codes 1000-9999)
+├── journal-entries/        # Main accounting data organized by fiscal year
+│   └── FY-YYYY/           # Fiscal year folders (FY-2014 through FY-2026)
+│       ├── _fiscal-year.yaml
+│       └── [SERIES]-[NUM]-[DATE]-[DESC]/
+│           ├── entry.yaml
+│           └── *.pdf      # Supporting documents
+│
+├── inbox/                 # Raw incoming documents (no entry yet)
+│   └── [DATE]-[NAME]/
+│       ├── document.yaml
+│       └── *.pdf
+└── drafts/                # Documents with entries, ready to post
+    └── [DATE] - [NAME]/   # e.g., "2025-12-24 - anthropic"
+        ├── document.yaml
+        ├── entry.yaml
+        └── *.pdf
+```
+
+## CLI Commands
+
+Use the `kvitton` CLI to interact with this repository:
+
+```bash
+kvitton sync-journal    # Sync journal entries from accounting provider
+kvitton sync-inbox      # Download inbox files from accounting provider
+kvitton company-info    # Display company information
+```
+
+## Entities
+
+### Journal Entry (entry.yaml)
+
+```yaml
+series: A              # A=Admin, B=Customer invoices, C=Customer payments,
+                       # D=Supplier invoices, E=Supplier payments, K=Salary
+entryNumber: 1
+entryDate: 2024-01-03
+description: Transaction description
+status: POSTED         # or DRAFT
+currency: SEK
+lines:
+  - account: "1930"    # Account code from accounts.yaml
+    debit: 1000.00     # or credit:
+    memo: Account description
+```
+
+### Document Metadata (document.yaml)
+
+```yaml
+kind: RECEIPT          # RECEIPT, INVOICE, BANK_FILE, etc.
+status: DRAFT
+fileName: document.pdf
+sourceIntegration: {{PROVIDER_LOWER}}
+sourceId: UUID
+```
+
+### Fiscal Year (_fiscal-year.yaml)
+
+```yaml
+name: FY 2024
+startDate: 2024-01-01
+endDate: 2024-12-31
+status: OPEN
+externalId: "12"       # Provider reference
+```
+
+## Account Codes
+
+Swedish BAS account codes are organized by ranges:
+
+- **1xxx** - Assets (Tillgångar)
+- **2xxx** - Liabilities & Equity (Skulder och eget kapital)
+- **3xxx** - Revenue (Intäkter)
+- **4xxx** - Cost of goods sold (Inköp)
+- **5xxx-6xxx** - Operating expenses (Kostnader)
+- **7xxx** - Personnel costs (Personalkostnader)
+- **8xxx** - Financial items (Finansiella poster)
+- **9xxx** - Year-end allocations (Bokslutsdispositioner)
+
+Common accounts:
+- `1930` - Business bank account
+- `2440` - Supplier payables
+- `2610` - Outgoing VAT 25%
+- `2640` - Incoming VAT
+- `4000` - Cost of goods sold
+- `6570` - Bank charges

package/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "create-kvitton",
+	"version": "0.4.0",
+	"description": "Create a new kvitton bookkeeping repository",
+	"type": "module",
+	"bin": {
+		"create-kvitton": "./dist/index.js"
+	},
+	"files": ["dist"],
+	"scripts": {
+		"build": "bun scripts/build.ts",
+		"dev": "tsc --watch",
+		"type-check": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@inquirer/prompts": "^7.0.0",
+		"@supabase/supabase-js": "^2.49.1",
+		"commander": "^12.1.0",
+		"ora": "^8.1.1",
+		"simple-git": "^3.27.0",
+		"yaml": "^2.8.2",
+		"zod": "^3.24.1"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"typescript": "^5.0.0",
+		"integrations-bokio": "workspace:*",
+		"sync": "workspace:*"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}