arek-e-docsnap 0.1.0

package/dist/index.js

@@ -0,0 +1,312 @@
+// src/domain/models.ts
+import * as S from "effect/Schema";
+
+class Partner extends S.Class("Partner")({
+  id: S.String,
+  name: S.String.pipe(S.minLength(1)),
+  color: S.optional(S.String)
+}) {
+}
+
+class RawTransaction extends S.Class("RawTransaction")({
+  dateStr: S.String,
+  description: S.String.pipe(S.minLength(1)),
+  amountStr: S.String,
+  cardholder: S.optional(S.String),
+  ocrConfidence: S.optional(S.Number.pipe(S.between(0, 1)))
+}) {
+}
+
+class Transaction extends S.Class("Transaction")({
+  id: S.String,
+  date: S.Date,
+  description: S.String.pipe(S.minLength(1), S.maxLength(500)),
+  amount: S.Number.pipe(S.int(), S.positive()),
+  currency: S.Literal("SEK", "EUR", "USD", "CHF"),
+  category: S.String,
+  confidence: S.Number.pipe(S.between(0, 1))
+}) {
+}
+
+class ExpenseItem extends S.Class("ExpenseItem")({
+  id: S.String,
+  date: S.Date,
+  description: S.String.pipe(S.minLength(1), S.maxLength(500)),
+  amount: S.Number.pipe(S.int(), S.positive()),
+  currency: S.Literal("SEK", "EUR", "USD", "CHF"),
+  category: S.String,
+  confidence: S.Number.pipe(S.between(0, 1)),
+  partner: S.String,
+  isShared: S.Boolean,
+  notes: S.optional(S.String)
+}) {
+}
+
+class ExpenseDocument extends S.Class("ExpenseDocument")({
+  id: S.String,
+  date: S.Date,
+  source: S.String,
+  items: S.Array(ExpenseItem),
+  partners: S.Array(Partner)
+}) {
+}
+
+class Settlement extends S.Class("Settlement")({
+  from: S.String,
+  to: S.String,
+  amount: S.Number.pipe(S.int(), S.positive()),
+  reason: S.String
+}) {
+}
+
+class ItemSummary extends S.Class("ItemSummary")({
+  byPartner: S.Record({
+    key: S.String,
+    value: S.Struct({
+      count: S.Number,
+      total: S.Number
+    })
+  }),
+  byCategory: S.Record({
+    key: S.String,
+    value: S.Struct({
+      count: S.Number,
+      total: S.Number
+    })
+  })
+}) {
+}
+
+class ExpenseReport extends S.Class("ExpenseReport")({
+  document: ExpenseDocument,
+  itemsSummary: ItemSummary,
+  settlements: S.Array(Settlement)
+}) {
+}
+
+class AppConfig extends S.Class("AppConfig")({
+  defaultPartners: S.Array(S.String),
+  defaultCategories: S.Array(S.String),
+  language: S.Literal("en", "sv", "de", "fr"),
+  currency: S.Literal("SEK", "EUR", "USD", "CHF"),
+  outputFormat: S.Literal("xlsx", "csv", "json"),
+  autoOpenExcel: S.Boolean,
+  debug: S.optional(S.Boolean)
+}) {
+}
+
+class StatementMetadata extends S.Class("StatementMetadata")({
+  statementDate: S.Date,
+  source: S.String,
+  totalTransactions: S.Number.pipe(S.int(), S.positive()),
+  downloadDate: S.Date,
+  currency: S.Literal("SEK", "EUR", "USD", "CHF"),
+  language: S.String
+}) {
+}
+// src/domain/errors.ts
+class FileError extends Error {
+  _tag = "FileError";
+  path;
+  message;
+  constructor(path, message) {
+    super(message);
+    this.name = "FileError";
+    this.path = path;
+    this.message = message;
+  }
+}
+var isParseError = (error) => error._tag === "ParseError";
+var isOCRError = (error) => error._tag === "OCRError";
+var isValidationError = (error) => error._tag === "ValidationError";
+var isClassificationError = (error) => error._tag === "ClassificationError";
+var isFileError = (error) => error._tag === "FileError";
+var isUserCancelled = (error) => error._tag === "UserCancelled";
+var isUnknownError = (error) => error._tag === "UnknownError";
+var errorMessage = (error) => {
+  switch (error._tag) {
+    case "ParseError":
+      return `Parse Error${error.line ? ` (line ${error.line})` : ""}: ${error.reason}`;
+    case "OCRError":
+      return `OCR Error (page ${error.pageNumber}, confidence ${(error.confidence * 100).toFixed(0)}%): ${error.reason}`;
+    case "ValidationError":
+      return `Validation Error (${error.field}): ${error.reason}`;
+    case "ClassificationError":
+      return `Classification Error (item ${error.itemId}): ${error.reason}`;
+    case "FileError":
+      return `File Error (${error.path}): ${error.message}`;
+    case "UserCancelled":
+      return `Operation Cancelled: ${error.message}`;
+    case "UnknownError":
+      return `Unknown Error: ${error.message}`;
+    default:
+      return "Unknown error occurred";
+  }
+};
+// src/domain/settlement.ts
+var calculateSettlement = (items, partners) => {
+  const balances = new Map;
+  for (const partner of partners) {
+    balances.set(partner.id, 0);
+  }
+  for (const item of items) {
+    if (item.isShared) {
+      const sharePerPerson = item.amount / partners.length;
+      for (const partner of partners) {
+        if (partner.id === item.partner) {
+          const currentBalance = balances.get(partner.id) ?? 0;
+          balances.set(partner.id, currentBalance + (item.amount - sharePerPerson));
+        } else {
+          const currentBalance = balances.get(partner.id) ?? 0;
+          balances.set(partner.id, currentBalance - sharePerPerson);
+        }
+      }
+    }
+  }
+  const settlements = [];
+  const creditors = Array.from(balances.entries()).filter(([, balance]) => balance > 0);
+  const debtorsArray = Array.from(balances.entries()).filter(([, balance]) => balance < 0);
+  for (const [creditorId, owed] of creditors) {
+    let remaining = owed;
+    for (let i = 0;i < debtorsArray.length && remaining > 0; i++) {
+      const debtor = debtorsArray[i];
+      if (!debtor)
+        break;
+      const [debtorId, debt] = debtor;
+      const amount = Math.min(remaining, Math.abs(debt));
+      const creditor = partners.find((p) => p.id === creditorId);
+      const debtorPartner = partners.find((p) => p.id === debtorId);
+      if (creditor && debtorPartner) {
+        settlements.push({
+          from: debtorId,
+          to: creditorId,
+          amount,
+          reason: "Shared expenses settlement"
+        });
+      }
+      remaining -= amount;
+      if (debtor) {
+        debtorsArray[i] = [debtorId, debt + amount];
+      }
+    }
+  }
+  return { balances, settlements };
+};
+var formatSettlementAmount = (amountCents, currency = "SEK") => {
+  const amount = (amountCents / 100).toFixed(2);
+  return `${amount} ${currency}`;
+};
+var settlementSummary = (settlements, partners, currency = "SEK") => {
+  if (settlements.length === 0) {
+    return "No settlements needed - expenses are balanced!";
+  }
+  const lines = ["Settlement Summary:", ""];
+  for (const settlement of settlements) {
+    const from = partners.get(settlement.from);
+    const to = partners.get(settlement.to);
+    if (from && to) {
+      const amount = formatSettlementAmount(settlement.amount, currency);
+      lines.push(`  ✓ ${from.name} owes ${to.name}: ${amount}`);
+    }
+  }
+  return lines.join(`
+`);
+};
+// src/layers/logger.ts
+import { Context, Effect, Layer } from "effect";
+var Logger = Context.GenericTag("Logger");
+var ConsoleLogger = Layer.succeed(Logger, {
+  debug: (message) => Effect.sync(() => {
+    if (process.env.DEBUG) {
+      console.log(`[DEBUG] ${message}`);
+    }
+  }),
+  info: (message) => Effect.sync(() => {
+    console.log(`[INFO] ${message}`);
+  }),
+  warn: (message) => Effect.sync(() => {
+    console.warn(`[WARN] ${message}`);
+  }),
+  error: (message, error) => Effect.sync(() => {
+    console.error(`[ERROR] ${message}`);
+    if (error) {
+      console.error(error.stack);
+    }
+  })
+});
+var LoggerLive = ConsoleLogger;
+// src/layers/filesystem.ts
+import { Context as Context2, Effect as Effect2, Layer as Layer2 } from "effect";
+var FileSystem = Context2.GenericTag("FileSystem");
+var NativeFileSystem = Layer2.succeed(FileSystem, {
+  readFile: (path) => Effect2.tryPromise({
+    try: () => Bun.file(path).arrayBuffer().then((b) => Buffer.from(b)),
+    catch: (error) => new FileError(path, `Failed to read file: ${String(error)}`)
+  }),
+  writeFile: (path, content) => Effect2.tryPromise({
+    try: () => {
+      const file = Bun.file(path);
+      return Bun.write(file, content);
+    },
+    catch: (error) => new FileError(path, `Failed to write file: ${String(error)}`)
+  }).pipe(Effect2.map(() => {
+    return;
+  })),
+  exists: (path) => Effect2.sync(() => {
+    try {
+      return Bun.file(path).size > 0;
+    } catch {
+      return false;
+    }
+  })
+});
+// src/layers/config.ts
+import { Context as Context3, Effect as Effect3, Layer as Layer3 } from "effect";
+var ConfigService = Context3.GenericTag("ConfigService");
+var DEFAULT_CONFIG = {
+  defaultPartners: ["Person A", "Person B"],
+  defaultCategories: [
+    "Groceries",
+    "Utilities",
+    "Transport",
+    "Dining",
+    "Entertainment",
+    "Personal",
+    "Other"
+  ],
+  language: "en",
+  currency: "SEK",
+  outputFormat: "xlsx",
+  autoOpenExcel: true,
+  debug: false
+};
+var DefaultConfigService = Layer3.succeed(ConfigService, {
+  getConfig: () => Effect3.sync(() => DEFAULT_CONFIG)
+});
+var provideConfigService = Layer3.provide(DefaultConfigService);
+export {
+  settlementSummary,
+  isValidationError,
+  isUserCancelled,
+  isUnknownError,
+  isParseError,
+  isOCRError,
+  isFileError,
+  isClassificationError,
+  formatSettlementAmount,
+  errorMessage,
+  calculateSettlement,
+  Transaction as TransactionClass,
+  StatementMetadata as StatementMetadataClass,
+  Settlement as SettlementClass,
+  RawTransaction as RawTransactionClass,
+  Partner as PartnerClass,
+  Logger as LoggerTag,
+  LoggerLive,
+  FileSystem as FileSystemTag,
+  ExpenseReport as ExpenseReportClass,
+  ExpenseItem as ExpenseItemClass,
+  ExpenseDocument as ExpenseDocumentClass,
+  ConfigService as ConfigServiceTag,
+  AppConfig as AppConfigClass
+};

package/dist/layers/config.d.ts

@@ -0,0 +1,14 @@
+import { Context, Effect, Layer } from "effect";
+import { AppConfig } from "../domain/models";
+/**
+ * Config Service Layer
+ *
+ * Manages application configuration
+ * Loads from ~/.docsnap/config.json or uses defaults
+ */
+export interface ConfigService {
+    readonly getConfig: () => Effect.Effect<AppConfig>;
+}
+export declare const ConfigService: Context.Tag<ConfigService, ConfigService>;
+export declare const provideConfigService: <RIn2, E2, ROut2>(self: Layer.Layer<ROut2, E2, RIn2>) => Layer.Layer<ROut2, E2, Exclude<RIn2, ConfigService>>;
+//# sourceMappingURL=config.d.ts.map

package/dist/layers/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/layers/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,aAAa,2CAAqD,CAAC;AAiChF,eAAO,MAAM,oBAAoB,+GAAsC,CAAC"}

package/dist/layers/filesystem.d.ts

@@ -0,0 +1,16 @@
+import { Context, Effect, Layer } from "effect";
+import { FileError } from "../domain/errors";
+/**
+ * FileSystem Service Layer
+ *
+ * Abstraction for file I/O operations
+ * Integrates with Effect's dependency injection
+ */
+export interface FileSystem {
+    readonly readFile: (path: string) => Effect.Effect<Buffer, FileError>;
+    readonly writeFile: (path: string, content: Buffer | string) => Effect.Effect<void, FileError>;
+    readonly exists: (path: string) => Effect.Effect<boolean>;
+}
+export declare const FileSystem: Context.Tag<FileSystem, FileSystem>;
+export declare const Live: Layer.Layer<FileSystem, never, never>;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/layers/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/layers/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,MAAM,KACrB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,UAAU,qCAA+C,CAAC;AAkCvE,eAAO,MAAM,IAAI,uCAAmB,CAAC"}

package/dist/layers/logger.d.ts

@@ -0,0 +1,16 @@
+import { Context, Effect, Layer } from "effect";
+/**
+ * Logger Service Layer
+ *
+ * Provides structured logging with different levels (debug, info, warn, error)
+ * Integrates with Effect's dependency injection system
+ */
+export interface Logger {
+    readonly debug: (message: string) => Effect.Effect<void>;
+    readonly info: (message: string) => Effect.Effect<void>;
+    readonly warn: (message: string) => Effect.Effect<void>;
+    readonly error: (message: string, error?: Error) => Effect.Effect<void>;
+}
+export declare const Logger: Context.Tag<Logger, Logger>;
+export declare const LoggerLive: Layer.Layer<Logger, never, never>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/layers/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/layers/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD;;;;;GAKG;AAEH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,eAAO,MAAM,MAAM,6BAAuC,CAAC;AAmC3D,eAAO,MAAM,UAAU,mCAAgB,CAAC"}