financeops-mcp 0.1.0

package/README.md

@@ -0,0 +1,390 @@
+<div align="center">
+
+<img src=".github/assets/banner.svg" alt="FinanceOps MCP" width="800">
+
+<br/>
+<br/>
+
+[![npm version](https://img.shields.io/npm/v/financeops-mcp?style=flat-square&color=10b981&label=npm)](https://npmjs.com/package/financeops-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-10b981.svg?style=flat-square)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-62%20passing-brightgreen?style=flat-square)]()
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.4+-3178c6?style=flat-square&logo=typescript&logoColor=white)]()
+[![Node](https://img.shields.io/badge/Node.js-20+-339933?style=flat-square&logo=node.js&logoColor=white)]()
+[![MCP](https://img.shields.io/badge/MCP-compatible-10b981?style=flat-square)]()
+
+**Financial intelligence for AI coding agents.**
+<br/>
+Connect Stripe and Xero, then ask your AI agent anything about your business finances — health checks, P&L, cash flow forecasts, reconciliation, and anomaly detection.
+
+[Quick Start](#-quick-start) · [Tools](#-tools) · [Pro Features](#-pro-features) · [Security](#-security) · [Architecture](#-architecture)
+
+<br/>
+
+</div>
+
+---
+
+## See it in action
+
+```
+ Agent     "What's our financial health right now?"
+
+ FinanceOps  financial_health({ providers: ["stripe", "xero"] })
+
+ Result:
+
+ Financial Health Report
+ ──────────────────────────────────────────────────
+ MRR              $12,450.00     ▲ +8.3% vs last month
+ ARR              $149,400.00
+ Burn Rate        $4,200.00/mo
+ Runway           29.6 months
+ Churn Rate       2.1%
+ Active Customers 187
+
+ Stripe balance:  $8,320.50 (available)
+ Xero balance:    $41,200.00 (bank)
+
+ Status: HEALTHY  ✓
+ Generated in 340ms
+```
+
+```
+ Agent     "Generate a P&L for this quarter"
+
+ FinanceOps  generate_pnl({
+               providers: ["stripe", "xero"],
+               period: "quarter",
+               date_from: "2026-01-01",
+               date_to: "2026-03-31"
+             })
+
+ Result:
+
+ Profit & Loss — Q1 2026
+ ──────────────────────────────────────────────────
+ Revenue
+   Stripe Payments     $34,210.00
+   Xero Invoices       $18,940.00
+   Total Revenue       $53,150.00
+
+ Expenses
+   SaaS & Subscriptions  $1,840.00
+   Payroll               $9,000.00
+   Other                 $2,100.00
+   Total Expenses       $12,940.00
+
+ Net Profit             $40,210.00   (75.7% margin)
+```
+
+---
+
+## Architecture
+
+```mermaid
+graph LR
+    A["AI Agent<br/>(Claude, Cursor, Windsurf)"] -->|MCP Protocol| B["FinanceOps MCP"]
+    B --> C["Stripe API<br/>(Payments & Billing)"]
+    B --> D["Xero API<br/>(Accounting & Invoices)"]
+    B --> E["Analysis Engine<br/>(P&L · Cash Flow · Anomaly)"]
+    B --> F["Audit Trail<br/>(SQLite)"]
+
+    style A fill:#1f2937,stroke:#10b981,color:#f0f6fc
+    style B fill:#0d1117,stroke:#10b981,stroke-width:2px,color:#10b981
+    style C fill:#0a1f16,stroke:#635bff,color:#f0f6fc
+    style D fill:#0a1f16,stroke:#13b5ea,color:#f0f6fc
+    style E fill:#0a1f16,stroke:#10b981,color:#f0f6fc
+    style F fill:#161b22,stroke:#30363d,color:#8b949e
+```
+
+---
+
+## Quick Start
+
+```bash
+npx financeops-mcp
+```
+
+Set your provider credentials as environment variables:
+
+```bash
+# Stripe
+export STRIPE_SECRET_KEY=sk_live_...
+
+# Xero (OAuth2)
+export XERO_CLIENT_ID=...
+export XERO_CLIENT_SECRET=...
+export XERO_TENANT_ID=...
+```
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add to your `claude_desktop_config.json`:
+
+- **macOS / Linux:** `~/.config/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "financeops": {
+      "command": "npx",
+      "args": ["financeops-mcp"],
+      "env": {
+        "STRIPE_SECRET_KEY": "sk_live_...",
+        "XERO_CLIENT_ID": "...",
+        "XERO_CLIENT_SECRET": "...",
+        "XERO_TENANT_ID": "..."
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add to `.cursor/rules/mcp_servers.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "financeops": {
+      "command": "npx",
+      "args": ["financeops-mcp"],
+      "env": {
+        "STRIPE_SECRET_KEY": "sk_live_..."
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Open settings (`Cmd+Shift+P` / `Ctrl+Shift+P` then search "MCP") and add:
+
+```json
+{
+  "mcpServers": {
+    "financeops": {
+      "command": "npx",
+      "args": ["financeops-mcp"],
+      "env": {
+        "STRIPE_SECRET_KEY": "sk_live_..."
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>With Pro License</strong></summary>
+
+Set the `PRO_LICENSE` environment variable to unlock premium analysis tools:
+
+```json
+{
+  "mcpServers": {
+    "financeops": {
+      "command": "npx",
+      "args": ["financeops-mcp"],
+      "env": {
+        "STRIPE_SECRET_KEY": "sk_live_...",
+        "PRO_LICENSE": "your-license-key"
+      }
+    }
+  }
+}
+```
+
+Or from the command line:
+
+```bash
+PRO_LICENSE=your-license-key npx financeops-mcp
+```
+
+</details>
+
+---
+
+## Tools
+
+### Free Tools (6)
+
+| Tool | Description |
+|:-----|:------------|
+| **`list_transactions`** | Fetch paginated transactions from Stripe or Xero with date range and status filters |
+| **`get_balances`** | Get current account balances — Stripe available/pending, Xero bank accounts |
+| **`list_invoices`** | Fetch invoices with status filtering (paid, pending, overdue) and date range |
+| **`revenue_summary`** | Calculate revenue metrics for a period — total, average transaction, top customers |
+| **`expense_tracker`** | Categorize and summarize expenses by type with period filtering |
+| **`financial_health`** | Quick health check across providers — MRR, ARR, burn rate, runway, churn rate |
+
+### Pro Features (6)
+
+| Tool | Description |
+|:-----|:------------|
+| **`generate_pnl`** | Full Profit & Loss statement from Stripe + Xero data for any period (PRO) |
+| **`cash_flow_forecast`** | 3/6/12-month cash flow forecast — conservative, realistic, and optimistic scenarios (PRO) |
+| **`reconcile`** | Cross-reference Stripe payments with Xero records to find discrepancies (PRO) |
+| **`detect_anomalies`** | Statistical anomaly detection — flag unusual transactions, spikes, and drops (PRO) |
+| **`tax_summary`** | VAT/sales tax calculation and period summary by jurisdiction (PRO) |
+| **`multi_currency_report`** | Consolidated reporting across EUR, USD, GBP with live rate conversion (PRO) |
+
+---
+
+## Feature Comparison
+
+<table>
+<tr>
+<th>Capability</th>
+<th align="center">Free</th>
+<th align="center">Pro</th>
+</tr>
+<tr><td><strong>Transaction Listing</strong> (paginated, filtered)</td><td align="center">&#9989;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Account Balances</strong></td><td align="center">&#9989;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Invoice Management</strong></td><td align="center">&#9989;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Revenue Summary</strong></td><td align="center">&#9989;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Expense Tracking</strong></td><td align="center">&#9989;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Financial Health Check</strong></td><td align="center">&#9989;</td><td align="center">&#9989;</td></tr>
+<tr><td colspan="3"></td></tr>
+<tr><td><strong>P&amp;L Statement Generation</strong></td><td align="center">&#10060;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Cash Flow Forecasting</strong> (3 scenarios)</td><td align="center">&#10060;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Stripe ↔ Xero Reconciliation</strong></td><td align="center">&#10060;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Anomaly Detection</strong></td><td align="center">&#10060;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Tax Summary</strong> (VAT / sales tax)</td><td align="center">&#10060;</td><td align="center">&#9989;</td></tr>
+<tr><td><strong>Multi-Currency Reporting</strong></td><td align="center">&#10060;</td><td align="center">&#9989;</td></tr>
+</table>
+
+---
+
+## Analysis Algorithms
+
+### P&L Generation
+Aggregates income transactions from Stripe (charges, refunds) and Xero (invoices, credit notes), subtracts categorized expenses, and produces a structured statement with gross profit, operating expenses, and net profit with margin percentages.
+
+### Cash Flow Forecasting
+Uses a **weighted moving average** over the last 3 months of historical data (weights: 1, 2, 3 oldest to newest). Applies a linear trend multiplier derived from first-vs-last net cash flow change. Outputs three scenarios:
+
+| Scenario | Income Adjustment | Use Case |
+|:---------|:------------------|:---------|
+| **Conservative** | −20% | Worst-case planning, fundraising |
+| **Realistic** | Baseline trend | Default projection |
+| **Optimistic** | +20% | Best-case, growth planning |
+
+Minimum 3 months of historical data required.
+
+### Reconciliation
+Cross-references Stripe `payment_intent` IDs against Xero invoice references using fuzzy amount matching (±1% tolerance for currency conversion). Flags unmatched, duplicate, and reversed transactions.
+
+### Anomaly Detection
+Statistical Z-score analysis over rolling 30-day windows. Configurable sensitivity:
+- **Low** — flags transactions >3σ from mean
+- **Medium** — flags >2σ (default)
+- **High** — flags >1.5σ
+
+---
+
+## Supported Providers
+
+<table>
+<tr>
+<th>Feature</th>
+<th align="center">Stripe</th>
+<th align="center">Xero</th>
+</tr>
+<tr><td>Transactions</td><td align="center">&#9989; Balance transactions</td><td align="center">&#9989; Bank transactions</td></tr>
+<tr><td>Invoices</td><td align="center">&#9989; Stripe Invoicing</td><td align="center">&#9989; Xero Invoices</td></tr>
+<tr><td>Balances</td><td align="center">&#9989; Available + pending</td><td align="center">&#9989; Bank account balances</td></tr>
+<tr><td>Expenses</td><td align="center">&#9989; Payouts + fees</td><td align="center">&#9989; Bills + spend</td></tr>
+<tr><td>Multi-currency</td><td align="center">&#9989; Native</td><td align="center">&#9989; Native</td></tr>
+<tr><td>Auth method</td><td align="center">Secret key</td><td align="center">OAuth2</td></tr>
+</table>
+
+### Credentials
+
+```bash
+# Stripe — secret key from dashboard.stripe.com/apikeys
+STRIPE_SECRET_KEY=sk_live_...
+
+# Xero — OAuth2 app from developer.xero.com
+XERO_CLIENT_ID=...
+XERO_CLIENT_SECRET=...
+XERO_TENANT_ID=...           # Organisation ID from Xero connections
+```
+
+---
+
+## Security
+
+<div align="center">
+
+[![Read-Only Default](https://img.shields.io/badge/Default-Read%20Only-10b981?style=flat-square)]()
+[![No Stored Credentials](https://img.shields.io/badge/Credentials-Not%20Stored-10b981?style=flat-square)]()
+[![MIT License](https://img.shields.io/badge/License-MIT-10b981?style=flat-square)](LICENSE)
+[![Audit Trail](https://img.shields.io/badge/All%20Calls-Audit%20Trail-10b981?style=flat-square)]()
+
+</div>
+
+**FinanceOps MCP is read-only by design.** It calls provider APIs with read scopes only — it cannot move money, create invoices, or modify accounting records.
+
+| Principle | Details |
+|:----------|:--------|
+| **Read-only by default** | All tools only read data — no write operations, no fund transfers |
+| **No stored credentials** | API keys are passed via environment variables and never written to disk |
+| **No telemetry** | Zero analytics, zero phone-home. Your financial data stays local |
+| **Audit trail** | Every tool call is logged locally in SQLite with timestamp, tool name, provider, and success/failure |
+| **Least privilege** | Use restricted Stripe keys (read-only) and Xero connections with Reader scope |
+
+### Best Practices
+
+```bash
+# Use restricted Stripe keys — create at dashboard.stripe.com/apikeys
+# Toggle off all write permissions, keep only: Read balance, Read charges, Read invoices
+
+# Use environment variables — never hardcode API keys
+STRIPE_SECRET_KEY=sk_restricted_... npx financeops-mcp
+
+# Rotate credentials regularly
+# Xero OAuth tokens expire — implement refresh token rotation in production
+```
+
+---
+
+## Pro License
+
+Unlock P&L generation, cash flow forecasting, reconciliation, anomaly detection, tax summaries, and multi-currency reporting.
+
+**Get your license:**
+- [Gumroad](https://gumroad.com) — Instant delivery
+- [MCPize](https://mcpize.com/mcp/financeops-mcp) — MCP marketplace
+
+```bash
+# Activate
+export PRO_LICENSE=your-license-key
+npx financeops-mcp
+
+# Or inline
+PRO_LICENSE=your-license-key npx financeops-mcp
+```
+
+---
+
+<div align="center">
+
+**Built by [Craftpipe](https://craftpipe.dev)** — AI-powered developer tools
+
+[GitHub](https://github.com/AuditSite/financeops-mcp) · [npm](https://npmjs.com/package/financeops-mcp) · [Support](mailto:support@craftpipe.dev)
+
+<sub>MIT License &copy; 2026 Craftpipe</sub>
+
+</div>

package/SECURITY.md

@@ -0,0 +1,30 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| Latest  | Yes       |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in FinanceOps MCP — particularly anything related to credential handling, API key exposure, or data leakage — please report it responsibly:
+
+1. **Do NOT** open a public GitHub issue
+2. Email us at **security@heijnesdigital.com**
+3. Include a description of the vulnerability and steps to reproduce
+4. We will acknowledge receipt within 48 hours
+5. We will provide a fix or mitigation within 7 days
+
+## Scope
+
+This policy applies to the latest published version. We take all security reports seriously, especially those related to:
+
+- Exposure of Stripe secret keys or Xero OAuth tokens
+- Audit log bypass or tampering
+- Unintended write access to financial provider APIs
+- Credential leakage via error messages or logs
+
+## Security Model
+
+FinanceOps MCP is designed read-only. It does not store credentials, does not transmit data to third parties, and writes only to a local SQLite audit log. Provider credentials must be supplied via environment variables, not hardcoded in config files.

package/dist/adapters/stripe.d.ts

@@ -0,0 +1,15 @@
+import type { FinanceProvider, TransactionQuery, InvoiceQuery, ExpenseQuery } from './types.js';
+import type { Transaction, Invoice, Balance, Expense, Subscription, PaginatedResult } from '../types.js';
+export declare class StripeAdapter implements FinanceProvider {
+    private client;
+    constructor();
+    getTransactions(opts: TransactionQuery): Promise<PaginatedResult<Transaction>>;
+    getBalances(): Promise<Balance[]>;
+    getInvoices(opts: InvoiceQuery): Promise<PaginatedResult<Invoice>>;
+    getExpenses(opts: ExpenseQuery): Promise<PaginatedResult<Expense>>;
+    getSubscriptions(): Promise<Subscription[]>;
+    private mapStripeType;
+    private mapStripeInvoiceStatus;
+    private mapStripeSubStatus;
+}
+//# sourceMappingURL=stripe.d.ts.map

package/dist/adapters/stripe.js

@@ -0,0 +1,175 @@
+import Stripe from 'stripe';
+export class StripeAdapter {
+    client;
+    constructor() {
+        const key = process.env.STRIPE_SECRET_KEY;
+        if (!key) {
+            throw new Error('STRIPE_SECRET_KEY environment variable is required');
+        }
+        this.client = new Stripe(key, { apiVersion: '2023-10-16' });
+    }
+    async getTransactions(opts) {
+        const params = {
+            limit: Math.min(opts.limit ?? 100, 100),
+        };
+        if (opts.cursor)
+            params.starting_after = opts.cursor;
+        if (opts.date_from)
+            params.created = { gte: Math.floor(new Date(opts.date_from).getTime() / 1000) };
+        if (opts.date_to) {
+            params.created = {
+                ...(typeof params.created === 'object' && params.created !== null ? params.created : {}),
+                lte: Math.floor(new Date(opts.date_to).getTime() / 1000),
+            };
+        }
+        const result = await this.client.balanceTransactions.list(params);
+        const transactions = result.data.map((bt) => ({
+            id: bt.id,
+            date: new Date(bt.created * 1000).toISOString(),
+            amount: bt.amount, // Stripe already returns amounts in cents
+            currency: bt.currency,
+            description: bt.description ?? bt.type,
+            category: bt.type,
+            type: this.mapStripeType(bt.type),
+            provider: 'stripe',
+            metadata: undefined,
+        }));
+        return {
+            data: transactions,
+            has_more: result.has_more,
+            next_cursor: result.has_more ? result.data[result.data.length - 1]?.id : undefined,
+        };
+    }
+    async getBalances() {
+        const balance = await this.client.balance.retrieve();
+        const balances = [];
+        for (const available of balance.available) {
+            const pending = balance.pending.find((p) => p.currency === available.currency);
+            balances.push({
+                currency: available.currency,
+                available: available.amount, // Already in cents
+                pending: pending?.amount ?? 0,
+                provider: 'stripe',
+            });
+        }
+        return balances;
+    }
+    async getInvoices(opts) {
+        const params = {
+            limit: 100,
+        };
+        if (opts.cursor)
+            params.starting_after = opts.cursor;
+        if (opts.status) {
+            if (opts.status === 'paid')
+                params.status = 'paid';
+            else if (opts.status === 'pending')
+                params.status = 'open';
+            // 'overdue' = open past due_date; we post-filter below
+        }
+        const result = await this.client.invoices.list(params);
+        let invoices = result.data.map((inv) => ({
+            id: inv.id,
+            number: inv.number ?? '',
+            customer_name: typeof inv.customer_name === 'string' ? inv.customer_name : '',
+            customer_email: typeof inv.customer_email === 'string' ? inv.customer_email : undefined,
+            amount: inv.amount_due, // Already in cents
+            currency: inv.currency,
+            status: this.mapStripeInvoiceStatus(inv),
+            due_date: inv.due_date ? new Date(inv.due_date * 1000).toISOString() : '',
+            issued_date: new Date(inv.created * 1000).toISOString(),
+            paid_date: inv.status_transitions?.paid_at
+                ? new Date(inv.status_transitions.paid_at * 1000).toISOString()
+                : undefined,
+            provider: 'stripe',
+        }));
+        if (opts.date_from) {
+            const from = new Date(opts.date_from).getTime();
+            invoices = invoices.filter((inv) => new Date(inv.issued_date).getTime() >= from);
+        }
+        if (opts.date_to) {
+            const to = new Date(opts.date_to).getTime();
+            invoices = invoices.filter((inv) => new Date(inv.issued_date).getTime() <= to);
+        }
+        if (opts.status === 'overdue') {
+            const now = Date.now();
+            invoices = invoices.filter((inv) => inv.status !== 'paid' && inv.due_date && new Date(inv.due_date).getTime() < now);
+        }
+        return {
+            data: invoices,
+            has_more: result.has_more,
+            next_cursor: result.has_more ? result.data[result.data.length - 1]?.id : undefined,
+        };
+    }
+    async getExpenses(opts) {
+        // Stripe expenses = charges (fees), refunds, and payouts
+        const params = {
+            limit: 100,
+            type: 'payout',
+        };
+        if (opts.cursor)
+            params.starting_after = opts.cursor;
+        const result = await this.client.balanceTransactions.list(params);
+        const expenses = result.data.map((bt) => ({
+            id: bt.id,
+            date: new Date(bt.created * 1000).toISOString(),
+            amount: Math.abs(bt.amount), // Cents
+            currency: bt.currency,
+            description: bt.description ?? bt.type,
+            category: bt.type === 'payout' ? 'Payouts' : bt.type,
+            provider: 'stripe',
+        }));
+        return {
+            data: expenses,
+            has_more: result.has_more,
+            next_cursor: result.has_more ? result.data[result.data.length - 1]?.id : undefined,
+        };
+    }
+    async getSubscriptions() {
+        const result = await this.client.subscriptions.list({ limit: 100, status: 'all' });
+        return result.data.map((sub) => ({
+            id: sub.id,
+            customer_name: typeof sub.customer === 'string' ? sub.customer : sub.customer?.name ?? '',
+            amount: sub.items.data.reduce((sum, item) => sum + (item.price.unit_amount ?? 0), 0),
+            currency: sub.currency,
+            interval: (sub.items.data[0]?.price.recurring?.interval ?? 'month'),
+            status: this.mapStripeSubStatus(sub.status),
+            current_period_start: new Date(sub.current_period_start * 1000).toISOString(),
+            current_period_end: new Date(sub.current_period_end * 1000).toISOString(),
+            provider: 'stripe',
+        }));
+    }
+    mapStripeType(type) {
+        if (['charge', 'payment', 'adjustment'].includes(type))
+            return 'income';
+        if (['refund', 'payout', 'stripe_fee', 'application_fee'].includes(type))
+            return 'expense';
+        return 'transfer';
+    }
+    mapStripeInvoiceStatus(inv) {
+        if (inv.status === 'paid')
+            return 'paid';
+        if (inv.status === 'draft')
+            return 'draft';
+        if (inv.status === 'void')
+            return 'voided';
+        if (inv.status === 'open') {
+            if (inv.due_date && Date.now() > inv.due_date * 1000)
+                return 'overdue';
+            return 'pending';
+        }
+        return 'pending';
+    }
+    mapStripeSubStatus(status) {
+        if (status === 'active')
+            return 'active';
+        if (status === 'canceled')
+            return 'canceled';
+        if (status === 'past_due' || status === 'unpaid')
+            return 'past_due';
+        if (status === 'trialing')
+            return 'trialing';
+        return 'active';
+    }
+}
+//# sourceMappingURL=stripe.js.map

package/dist/adapters/types.d.ts

@@ -0,0 +1,30 @@
+import type { Transaction, Invoice, Balance, Expense, Subscription, PaginatedResult } from '../types.js';
+export type { Transaction, Invoice, Balance, Expense, Subscription, PaginatedResult };
+export interface TransactionQuery {
+    date_from?: string;
+    date_to?: string;
+    limit?: number;
+    cursor?: string;
+    status?: string;
+}
+export interface InvoiceQuery {
+    status?: 'paid' | 'pending' | 'overdue';
+    date_from?: string;
+    date_to?: string;
+    cursor?: string;
+}
+export interface ExpenseQuery {
+    period?: string;
+    categories?: string[];
+    date_from?: string;
+    date_to?: string;
+    cursor?: string;
+}
+export interface FinanceProvider {
+    getTransactions(opts: TransactionQuery): Promise<PaginatedResult<Transaction>>;
+    getBalances(): Promise<Balance[]>;
+    getInvoices(opts: InvoiceQuery): Promise<PaginatedResult<Invoice>>;
+    getExpenses(opts: ExpenseQuery): Promise<PaginatedResult<Expense>>;
+    getSubscriptions?(): Promise<Subscription[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/xero.d.ts

@@ -0,0 +1,19 @@
+import type { FinanceProvider, TransactionQuery, InvoiceQuery, ExpenseQuery } from './types.js';
+import type { Transaction, Invoice, Balance, Expense, PaginatedResult } from '../types.js';
+export declare class XeroAdapter implements FinanceProvider {
+    private tokens;
+    private tenantId;
+    constructor();
+    private loadTokens;
+    private saveTokens;
+    private refreshAccessToken;
+    private ensureFreshToken;
+    private request;
+    getTransactions(opts: TransactionQuery): Promise<PaginatedResult<Transaction>>;
+    getBalances(): Promise<Balance[]>;
+    getInvoices(opts: InvoiceQuery): Promise<PaginatedResult<Invoice>>;
+    getExpenses(opts: ExpenseQuery): Promise<PaginatedResult<Expense>>;
+    private mapXeroInvoice;
+    private mapXeroInvoiceStatus;
+}
+//# sourceMappingURL=xero.d.ts.map