arek-e-docsnap 0.1.0

package/dist/services/export.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Export Service
+ *
+ * Phase 4: Export expense data to multiple formats (Excel, CSV, JSON)
+ */
+import { Effect } from 'effect';
+import { ExpenseItem, Partner, Settlement } from '../domain/models.js';
+import { FileError } from '../domain/errors.js';
+import { Logger } from '../layers/logger.js';
+/**
+ * Export format options
+ */
+export type ExportFormat = 'xlsx' | 'csv' | 'json';
+/**
+ * Export configuration
+ */
+export interface ExportConfig {
+    format: ExportFormat;
+    outputPath: string;
+    includeSettlement?: boolean;
+    includeSummary?: boolean;
+}
+/**
+ * Export data structure
+ */
+export interface ExportData {
+    items: ExpenseItem[];
+    partners: Partner[];
+    settlements: Settlement[];
+    currency: string;
+}
+/**
+ * Export to Excel with formatting
+ *
+ * Phase 4.2: Creates a beautifully formatted Excel workbook
+ */
+export declare function exportToExcel(data: ExportData, outputPath: string): Effect.Effect<string, FileError, Logger>;
+/**
+ * Export to CSV
+ *
+ * Phase 4.3: Simple CSV format
+ */
+export declare function exportToCSV(data: ExportData, outputPath: string): Effect.Effect<string, FileError, Logger>;
+/**
+ * Export to JSON
+ *
+ * Phase 4.3: Structured JSON format
+ */
+export declare function exportToJSON(data: ExportData, outputPath: string): Effect.Effect<string, FileError, Logger>;
+/**
+ * Main export function - handles all formats
+ *
+ * Phase 4.3: Multi-format export
+ */
+export declare function exportExpenses(config: ExportConfig, data: ExportData): Effect.Effect<string, FileError, Logger>;
+//# sourceMappingURL=export.d.ts.map

package/dist/services/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/services/export.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAmM1C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAwC1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CA4D1C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GACf,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAmB1C"}

package/dist/services/ocr-tesseract.d.ts

@@ -0,0 +1,2 @@
+export declare function processPdfWithTesseract(pdfBuffer: Buffer): Promise<string[]>;
+//# sourceMappingURL=ocr-tesseract.d.ts.map

package/dist/services/ocr-tesseract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr-tesseract.d.ts","sourceRoot":"","sources":["../../src/services/ocr-tesseract.ts"],"names":[],"mappings":"AA0FA,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgDlF"}

package/dist/services/ocr.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OCR Service (Phase 2.1-2.6)
+ *
+ * Extracts text from PDF files and parses into transactions
+ * Uses pdf-parse for simple text-based PDFs
+ */
+import { Effect } from 'effect';
+import { OCRError } from '../domain/errors';
+import { Logger } from '../layers/logger';
+import { type ParseResult, type ParserConfig } from '../utils/transaction-parser';
+/**
+ * OCR Configuration
+ */
+export interface OCRConfig extends ParserConfig {
+    /** OCR engine to use */
+    engine?: 'pdf-parse' | 'tesseract';
+    /** Minimum OCR confidence (0-1) */
+    minOcrConfidence?: number;
+}
+/**
+ * Process a PDF buffer and extract transactions
+ *
+ * This is the main entry point for Phase 2 OCR functionality.
+ * It extracts text from PDF and then parses transactions.
+ */
+export declare function processPdfToTransactions(pdfBuffer: Buffer, config?: OCRConfig): Effect.Effect<ParseResult, OCRError, Logger>;
+/**
+ * Legacy function for backward compatibility
+ * @deprecated Use processPdfToTransactions instead
+ */
+export declare function processPdf(pdfBuffer: Buffer): Promise<string[]>;
+//# sourceMappingURL=ocr.d.ts.map

package/dist/services/ocr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.d.ts","sourceRoot":"","sources":["../../src/services/ocr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,wBAAwB;IACxB,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACnC,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,SAAc,GACrB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAsB9C;AAkDD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKrE"}

package/dist/utils/compression.d.ts

@@ -0,0 +1,31 @@
+/**
+ * File Compression Utilities
+ *
+ * Compress and decompress files using Bun's built-in streams
+ */
+export type CompressionFormat = 'gzip' | 'deflate';
+/**
+ * Compress a file using native streams
+ */
+export declare function compressFile(inputPath: string, outputPath: string, format?: CompressionFormat): Promise<void>;
+/**
+ * Decompress a file using native streams
+ */
+export declare function decompressFile(inputPath: string, outputPath: string, format?: CompressionFormat): Promise<void>;
+/**
+ * Compress data in memory using Web Streams API
+ */
+export declare function compressData(data: Buffer, format?: CompressionFormat): Promise<Buffer>;
+/**
+ * Decompress data in memory using Web Streams API
+ */
+export declare function decompressData(data: Buffer, format?: CompressionFormat): Promise<Buffer>;
+/**
+ * Get file size reduction ratio
+ */
+export declare function calculateCompressionRatio(originalSize: number, compressedSize: number): number;
+/**
+ * Get file size in bytes
+ */
+export declare function getFileSize(filePath: string): number;
+//# sourceMappingURL=compression.d.ts.map

package/dist/utils/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/utils/compression.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEnD;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,iBAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,iBAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,iBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBpG;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,iBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBtG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/utils/console.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Console Utilities
+ *
+ * Enhanced console utilities using Bun features
+ */
+export type LogLevel = 'info' | 'warn' | 'error' | 'success';
+/**
+ * Format console output with emoji and colors
+ */
+export declare function log(level: LogLevel, message: string, data?: unknown): void;
+/**
+ * Display an info message
+ */
+export declare const info: (message: string, data?: unknown) => void;
+/**
+ * Display a warning message
+ */
+export declare const warn: (message: string, data?: unknown) => void;
+/**
+ * Display an error message
+ */
+export declare const error: (message: string, data?: unknown) => void;
+/**
+ * Display a success message
+ */
+export declare const success: (message: string, data?: unknown) => void;
+//# sourceMappingURL=console.d.ts.map

package/dist/utils/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/utils/console.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAS7D;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,SAA+B,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,SAA+B,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,SAAgC,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,SAAkC,CAAC"}

package/dist/utils/progress.d.ts

@@ -0,0 +1,30 @@
+import cliProgress from 'cli-progress';
+/**
+ * Progress Bar Utilities
+ *
+ * CLI progress bars for long-running operations
+ */
+export type ProgressOptions = {
+    total: number;
+    format?: string;
+    barCompleteString?: string;
+    barIncompleteString?: string;
+    width?: number;
+};
+/**
+ * Create a progress bar
+ */
+export declare function createProgressBar(options: ProgressOptions): cliProgress.SingleBar;
+/**
+ * Update progress bar
+ */
+export declare function updateProgress(bar: cliProgress.SingleBar, current: number): void;
+/**
+ * Complete progress bar
+ */
+export declare function completeProgress(bar: cliProgress.SingleBar): void;
+/**
+ * Multi-bar progress for parallel operations
+ */
+export declare function createMultiBar(): cliProgress.MultiBar;
+//# sourceMappingURL=progress.d.ts.map

package/dist/utils/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAAC,SAAS,CAWjF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAAC,QAAQ,CAKrD"}

package/dist/utils/transaction-parser.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Generic Transaction Parser
+ *
+ * Phase 2.7: Parse OCR text into structured transactions
+ *
+ * This parser is designed to work with ANY invoice/receipt format,
+ * not just Amex statements. It uses multiple heuristic strategies
+ * to extract transaction data from unstructured text.
+ */
+import { Effect } from 'effect';
+import { RawTransaction } from '../domain/models';
+import { ParseError } from '../domain/errors';
+import { Logger } from '../layers/logger';
+/**
+ * Transaction parsing configuration
+ */
+export interface ParserConfig {
+    /** Default currency if not detected */
+    defaultCurrency?: 'SEK' | 'EUR' | 'USD' | 'CHF';
+    /** Minimum confidence threshold (0-1) */
+    minConfidence?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Parse result with confidence scoring
+ */
+export interface ParseResult {
+    transactions: RawTransaction[];
+    totalLines: number;
+    parsedLines: number;
+    confidence: number;
+}
+/**
+ * Parse raw OCR text into transactions
+ *
+ * This is a generic parser that works with various invoice formats.
+ * It uses multiple strategies to extract date, description, and amount.
+ */
+export declare function parseTransactions(text: string, config?: ParserConfig): Effect.Effect<ParseResult, ParseError, Logger>;
+//# sourceMappingURL=transaction-parser.d.ts.map

package/dist/utils/transaction-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-parser.d.ts","sourceRoot":"","sources":["../../src/utils/transaction-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,eAAe,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAChD,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,YAAiB,GACxB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CA8EhD"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "arek-e-docsnap",
+  "version": "0.1.0",
+  "description": "Parse invoices and split expenses between partners",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "docsnap": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "dev": "bun run --watch ./src/bin/cli.ts",
+    "build": "rm -rf dist && bun build ./src/bin/cli.ts --outdir ./dist --format esm --target node --external ink --external react --external effect --external exceljs --external 'ink-*' --external 'react-*' && bun build ./src/index.ts --outdir ./dist --format esm --target node --external effect --external exceljs && tsc --declaration --emitDeclarationOnly && chmod +x dist/cli.js && cp vendor/pdf.worker.min.mjs dist/pdf.worker.mjs",
+    "build:watch": "bun --watch run build",
+    "type-check": "tsc --noEmit",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "lint": "biome lint src tests --fix",
+    "format": "biome format src tests docs --write",
+    "format:check": "biome format src tests docs --check",
+    "lint:check": "biome lint src tests",
+    "prepublishOnly": "bun run build && bun run test && bun run lint:check",
+    "prepack": "bun run build",
+    "publish": "bun publish"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "keywords": [
+    "invoice",
+    "receipt",
+    "ocr",
+    "pdf",
+    "expense",
+    "splitting",
+    "partners",
+    "settlement",
+    "typescript",
+    "effect-ts",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arek-e/docsnap.git"
+  },
+  "bugs": {
+    "url": "https://github.com/arek-e/docsnap/issues"
+  },
+  "homepage": "https://github.com/arek-e/docsnap#readme",
+  "author": {
+    "name": "arek-e",
+    "url": "https://github.com/arek-e"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.3.0"
+  },
+  "dependencies": {
+    "cli-progress": "^3.12.0",
+    "date-fns": "^3.0.0",
+    "dommatrix": "^1.0.3",
+    "effect": "^3.0.0",
+    "exceljs": "^4.4.0",
+    "ink": "^6.6.0",
+    "ink-select-input": "^5.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "jsdom": "^27.4.0",
+    "pdf-parse": "^2.4.5",
+    "uuid": "^9.0.0"
+  },
+  "optionalDependencies": {
+    "sharp": "^0.33.0",
+    "tesseract.js": "^7.0.0",
+    "tesseract.js-core": "^6.1.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@types/uuid": "^11.0.0",
+    "biome": "latest",
+    "typescript": "^5"
+  }
+}