@rv404/mcp-launchpad 1.0.0

package/dist/backends/quickbooks.js

@@ -0,0 +1,2183 @@
+// QuickBooks API configuration
+const IS_SANDBOX = process.env.QUICKBOOKS_SANDBOX === 'true';
+const BASE_URL = IS_SANDBOX
+    ? 'https://sandbox-quickbooks.api.intuit.com/v3/company'
+    : 'https://quickbooks.api.intuit.com/v3/company';
+const TOKEN_URL = 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer';
+// Environment variables
+const CLIENT_ID = process.env.QUICKBOOKS_CLIENT_ID || '';
+const CLIENT_SECRET = process.env.QUICKBOOKS_CLIENT_SECRET || '';
+const REALM_ID = process.env.QUICKBOOKS_REALM_ID || '';
+let refreshToken = process.env.QUICKBOOKS_REFRESH_TOKEN || '';
+// Token cache
+let accessToken = null;
+let tokenExpiry = 0;
+// API version
+const MINOR_VERSION = '70';
+// ============================================================================
+// AUTH & API HELPERS
+// ============================================================================
+/**
+ * Refresh the OAuth access token using the refresh token
+ */
+async function getAccessToken() {
+    if (accessToken && Date.now() < tokenExpiry - 60000) {
+        return accessToken;
+    }
+    if (!CLIENT_ID || !CLIENT_SECRET || !refreshToken) {
+        throw new Error('QuickBooks credentials not configured. Set QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, and QUICKBOOKS_REFRESH_TOKEN');
+    }
+    const credentials = Buffer.from(`${CLIENT_ID}:${CLIENT_SECRET}`).toString('base64');
+    const response = await fetch(TOKEN_URL, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Basic ${credentials}`,
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'Accept': 'application/json',
+        },
+        body: new URLSearchParams({
+            grant_type: 'refresh_token',
+            refresh_token: refreshToken,
+        }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        if (response.status === 400 || response.status === 401) {
+            throw new Error(`QuickBooks auth failed: Refresh token may be expired or invalid. Re-authenticate at developer.intuit.com/app/developer/playground. Details: ${errorText}`);
+        }
+        throw new Error(`QuickBooks token refresh failed (${response.status}): ${errorText}`);
+    }
+    const data = await response.json();
+    accessToken = data.access_token;
+    tokenExpiry = Date.now() + (data.expires_in * 1000);
+    if (data.refresh_token) {
+        refreshToken = data.refresh_token;
+    }
+    return accessToken;
+}
+/**
+ * Make an authenticated API request to QuickBooks
+ */
+async function qbRequest(endpoint, method = 'GET', body) {
+    const token = await getAccessToken();
+    if (!REALM_ID) {
+        throw new Error('QUICKBOOKS_REALM_ID not configured');
+    }
+    const url = `${BASE_URL}/${REALM_ID}/${endpoint}${endpoint.includes('?') ? '&' : '?'}minorversion=${MINOR_VERSION}`;
+    const response = await fetch(url, {
+        method,
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Accept': 'application/json',
+            'Content-Type': 'application/json',
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        if (response.status === 401) {
+            accessToken = null;
+            tokenExpiry = 0;
+            throw new Error(`QuickBooks auth error: ${errorText}`);
+        }
+        if (response.status === 429) {
+            throw new Error(`QuickBooks rate limit exceeded. Try again later.`);
+        }
+        throw new Error(`QuickBooks API error (${response.status}): ${errorText}`);
+    }
+    return response.json();
+}
+/**
+ * Run a query against QuickBooks
+ */
+async function qbQuery(query) {
+    return qbRequest(`query?query=${encodeURIComponent(query)}`);
+}
+// ============================================================================
+// ACTION DEFINITIONS
+// ============================================================================
+const actions = [
+    // --------------------------------------------------------------------------
+    // COMPANY
+    // --------------------------------------------------------------------------
+    {
+        name: 'get_company_info',
+        description: 'Get company information and settings',
+        params: [],
+    },
+    {
+        name: 'get_preferences',
+        description: 'Get company preferences and settings',
+        params: [],
+    },
+    // --------------------------------------------------------------------------
+    // CUSTOMERS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_customers',
+        description: 'List all customers',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results (default: 100, max: 1000)' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position for pagination' },
+            { name: 'active', type: 'boolean', required: false, description: 'Filter by active status' },
+        ],
+    },
+    {
+        name: 'get_customer',
+        description: 'Get a specific customer by ID',
+        params: [
+            { name: 'customerId', type: 'string', required: true, description: 'The customer ID' },
+        ],
+    },
+    {
+        name: 'create_customer',
+        description: 'Create a new customer',
+        params: [
+            { name: 'displayName', type: 'string', required: true, description: 'Display name (must be unique)' },
+            { name: 'companyName', type: 'string', required: false, description: 'Company name' },
+            { name: 'givenName', type: 'string', required: false, description: 'First name' },
+            { name: 'familyName', type: 'string', required: false, description: 'Last name' },
+            { name: 'email', type: 'string', required: false, description: 'Primary email address' },
+            { name: 'phone', type: 'string', required: false, description: 'Primary phone number' },
+            { name: 'billingAddress', type: 'object', required: false, description: 'Billing address {Line1, City, CountrySubDivisionCode, PostalCode}' },
+        ],
+    },
+    {
+        name: 'update_customer',
+        description: 'Update an existing customer',
+        params: [
+            { name: 'customerId', type: 'string', required: true, description: 'The customer ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token (from get_customer)' },
+            { name: 'displayName', type: 'string', required: false, description: 'Display name' },
+            { name: 'companyName', type: 'string', required: false, description: 'Company name' },
+            { name: 'givenName', type: 'string', required: false, description: 'First name' },
+            { name: 'familyName', type: 'string', required: false, description: 'Last name' },
+            { name: 'email', type: 'string', required: false, description: 'Primary email address' },
+            { name: 'phone', type: 'string', required: false, description: 'Primary phone number' },
+            { name: 'active', type: 'boolean', required: false, description: 'Active status' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // INVOICES
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_invoices',
+        description: 'List all invoices',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results (default: 100, max: 1000)' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position for pagination' },
+            { name: 'status', type: 'string', required: false, description: 'Filter by status: Paid, Unpaid, Overdue' },
+            { name: 'customerId', type: 'string', required: false, description: 'Filter by customer ID' },
+        ],
+    },
+    {
+        name: 'get_invoice',
+        description: 'Get a specific invoice by ID',
+        params: [
+            { name: 'invoiceId', type: 'string', required: true, description: 'The invoice ID' },
+        ],
+    },
+    {
+        name: 'create_invoice',
+        description: 'Create a new invoice',
+        params: [
+            { name: 'customerId', type: 'string', required: true, description: 'Customer ID' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of line items [{itemId, quantity, amount, description}]' },
+            { name: 'dueDate', type: 'string', required: false, description: 'Due date (YYYY-MM-DD)' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date (YYYY-MM-DD)' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note (not shown to customer)' },
+            { name: 'customerMemo', type: 'string', required: false, description: 'Customer-facing memo' },
+        ],
+    },
+    {
+        name: 'update_invoice',
+        description: 'Update an existing invoice',
+        params: [
+            { name: 'invoiceId', type: 'string', required: true, description: 'The invoice ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token (from get_invoice)' },
+            { name: 'lineItems', type: 'array', required: false, description: 'Array of line items' },
+            { name: 'dueDate', type: 'string', required: false, description: 'Due date (YYYY-MM-DD)' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+            { name: 'customerMemo', type: 'string', required: false, description: 'Customer-facing memo' },
+        ],
+    },
+    {
+        name: 'delete_invoice',
+        description: 'Delete an invoice',
+        params: [
+            { name: 'invoiceId', type: 'string', required: true, description: 'The invoice ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    {
+        name: 'send_invoice',
+        description: 'Send an invoice via email',
+        params: [
+            { name: 'invoiceId', type: 'string', required: true, description: 'The invoice ID' },
+            { name: 'email', type: 'string', required: false, description: 'Email address (uses customer email if not specified)' },
+        ],
+    },
+    {
+        name: 'void_invoice',
+        description: 'Void an invoice',
+        params: [
+            { name: 'invoiceId', type: 'string', required: true, description: 'The invoice ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // ESTIMATES
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_estimates',
+        description: 'List all estimates/quotes',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+            { name: 'customerId', type: 'string', required: false, description: 'Filter by customer ID' },
+        ],
+    },
+    {
+        name: 'get_estimate',
+        description: 'Get a specific estimate by ID',
+        params: [
+            { name: 'estimateId', type: 'string', required: true, description: 'The estimate ID' },
+        ],
+    },
+    {
+        name: 'create_estimate',
+        description: 'Create a new estimate/quote',
+        params: [
+            { name: 'customerId', type: 'string', required: true, description: 'Customer ID' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of line items' },
+            { name: 'expirationDate', type: 'string', required: false, description: 'Expiration date (YYYY-MM-DD)' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+            { name: 'customerMemo', type: 'string', required: false, description: 'Customer-facing memo' },
+        ],
+    },
+    {
+        name: 'update_estimate',
+        description: 'Update an existing estimate',
+        params: [
+            { name: 'estimateId', type: 'string', required: true, description: 'The estimate ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+            { name: 'lineItems', type: 'array', required: false, description: 'Array of line items' },
+            { name: 'expirationDate', type: 'string', required: false, description: 'Expiration date' },
+            { name: 'txnStatus', type: 'string', required: false, description: 'Status: Pending, Accepted, Closed, Rejected' },
+        ],
+    },
+    {
+        name: 'delete_estimate',
+        description: 'Delete an estimate',
+        params: [
+            { name: 'estimateId', type: 'string', required: true, description: 'The estimate ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    {
+        name: 'send_estimate',
+        description: 'Send an estimate via email',
+        params: [
+            { name: 'estimateId', type: 'string', required: true, description: 'The estimate ID' },
+            { name: 'email', type: 'string', required: false, description: 'Email address' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // PAYMENTS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_payments',
+        description: 'List all payments received',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+            { name: 'customerId', type: 'string', required: false, description: 'Filter by customer ID' },
+        ],
+    },
+    {
+        name: 'get_payment',
+        description: 'Get a specific payment by ID',
+        params: [
+            { name: 'paymentId', type: 'string', required: true, description: 'The payment ID' },
+        ],
+    },
+    {
+        name: 'create_payment',
+        description: 'Record a payment received',
+        params: [
+            { name: 'customerId', type: 'string', required: true, description: 'Customer ID' },
+            { name: 'totalAmt', type: 'number', required: true, description: 'Total payment amount' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Payment date (YYYY-MM-DD)' },
+            { name: 'paymentMethodId', type: 'string', required: false, description: 'Payment method ID' },
+            { name: 'depositToAccountId', type: 'string', required: false, description: 'Account to deposit to' },
+            { name: 'invoiceIds', type: 'array', required: false, description: 'Invoice IDs to apply payment to' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+        ],
+    },
+    {
+        name: 'update_payment',
+        description: 'Update a payment',
+        params: [
+            { name: 'paymentId', type: 'string', required: true, description: 'The payment ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+            { name: 'totalAmt', type: 'number', required: false, description: 'Total amount' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Payment date' },
+        ],
+    },
+    {
+        name: 'delete_payment',
+        description: 'Delete a payment',
+        params: [
+            { name: 'paymentId', type: 'string', required: true, description: 'The payment ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    {
+        name: 'void_payment',
+        description: 'Void a payment',
+        params: [
+            { name: 'paymentId', type: 'string', required: true, description: 'The payment ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // SALES RECEIPTS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_sales_receipts',
+        description: 'List all sales receipts (immediate payments)',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_sales_receipt',
+        description: 'Get a specific sales receipt',
+        params: [
+            { name: 'salesReceiptId', type: 'string', required: true, description: 'The sales receipt ID' },
+        ],
+    },
+    {
+        name: 'create_sales_receipt',
+        description: 'Create a sales receipt (sale with immediate payment)',
+        params: [
+            { name: 'customerId', type: 'string', required: false, description: 'Customer ID (optional for cash sales)' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of line items' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'paymentMethodId', type: 'string', required: false, description: 'Payment method ID' },
+            { name: 'depositToAccountId', type: 'string', required: false, description: 'Account to deposit to' },
+        ],
+    },
+    {
+        name: 'delete_sales_receipt',
+        description: 'Delete a sales receipt',
+        params: [
+            { name: 'salesReceiptId', type: 'string', required: true, description: 'The sales receipt ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // CREDIT MEMOS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_credit_memos',
+        description: 'List all credit memos',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_credit_memo',
+        description: 'Get a specific credit memo',
+        params: [
+            { name: 'creditMemoId', type: 'string', required: true, description: 'The credit memo ID' },
+        ],
+    },
+    {
+        name: 'create_credit_memo',
+        description: 'Create a credit memo',
+        params: [
+            { name: 'customerId', type: 'string', required: true, description: 'Customer ID' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of line items' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+        ],
+    },
+    {
+        name: 'delete_credit_memo',
+        description: 'Delete a credit memo',
+        params: [
+            { name: 'creditMemoId', type: 'string', required: true, description: 'The credit memo ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // REFUND RECEIPTS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_refund_receipts',
+        description: 'List all refund receipts',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_refund_receipt',
+        description: 'Get a specific refund receipt',
+        params: [
+            { name: 'refundReceiptId', type: 'string', required: true, description: 'The refund receipt ID' },
+        ],
+    },
+    {
+        name: 'create_refund_receipt',
+        description: 'Create a refund receipt',
+        params: [
+            { name: 'customerId', type: 'string', required: true, description: 'Customer ID' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of line items' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'depositToAccountId', type: 'string', required: false, description: 'Account to refund from' },
+        ],
+    },
+    {
+        name: 'delete_refund_receipt',
+        description: 'Delete a refund receipt',
+        params: [
+            { name: 'refundReceiptId', type: 'string', required: true, description: 'The refund receipt ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // VENDORS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_vendors',
+        description: 'List all vendors',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+            { name: 'active', type: 'boolean', required: false, description: 'Filter by active status' },
+        ],
+    },
+    {
+        name: 'get_vendor',
+        description: 'Get a specific vendor by ID',
+        params: [
+            { name: 'vendorId', type: 'string', required: true, description: 'The vendor ID' },
+        ],
+    },
+    {
+        name: 'create_vendor',
+        description: 'Create a new vendor',
+        params: [
+            { name: 'displayName', type: 'string', required: true, description: 'Display name (must be unique)' },
+            { name: 'companyName', type: 'string', required: false, description: 'Company name' },
+            { name: 'givenName', type: 'string', required: false, description: 'First name' },
+            { name: 'familyName', type: 'string', required: false, description: 'Last name' },
+            { name: 'email', type: 'string', required: false, description: 'Primary email' },
+            { name: 'phone', type: 'string', required: false, description: 'Primary phone' },
+        ],
+    },
+    {
+        name: 'update_vendor',
+        description: 'Update an existing vendor',
+        params: [
+            { name: 'vendorId', type: 'string', required: true, description: 'The vendor ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+            { name: 'displayName', type: 'string', required: false, description: 'Display name' },
+            { name: 'email', type: 'string', required: false, description: 'Email' },
+            { name: 'phone', type: 'string', required: false, description: 'Phone' },
+            { name: 'active', type: 'boolean', required: false, description: 'Active status' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // BILLS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_bills',
+        description: 'List all bills (vendor invoices)',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+            { name: 'vendorId', type: 'string', required: false, description: 'Filter by vendor ID' },
+            { name: 'status', type: 'string', required: false, description: 'Filter by status: Paid, Unpaid' },
+        ],
+    },
+    {
+        name: 'get_bill',
+        description: 'Get a specific bill by ID',
+        params: [
+            { name: 'billId', type: 'string', required: true, description: 'The bill ID' },
+        ],
+    },
+    {
+        name: 'create_bill',
+        description: 'Create a new bill (vendor invoice)',
+        params: [
+            { name: 'vendorId', type: 'string', required: true, description: 'Vendor ID' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of line items [{accountId, amount, description}]' },
+            { name: 'dueDate', type: 'string', required: false, description: 'Due date (YYYY-MM-DD)' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+        ],
+    },
+    {
+        name: 'update_bill',
+        description: 'Update an existing bill',
+        params: [
+            { name: 'billId', type: 'string', required: true, description: 'The bill ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+            { name: 'lineItems', type: 'array', required: false, description: 'Array of line items' },
+            { name: 'dueDate', type: 'string', required: false, description: 'Due date' },
+        ],
+    },
+    {
+        name: 'delete_bill',
+        description: 'Delete a bill',
+        params: [
+            { name: 'billId', type: 'string', required: true, description: 'The bill ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // BILL PAYMENTS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_bill_payments',
+        description: 'List all bill payments',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_bill_payment',
+        description: 'Get a specific bill payment',
+        params: [
+            { name: 'billPaymentId', type: 'string', required: true, description: 'The bill payment ID' },
+        ],
+    },
+    {
+        name: 'create_bill_payment',
+        description: 'Create a bill payment (pay a vendor bill)',
+        params: [
+            { name: 'vendorId', type: 'string', required: true, description: 'Vendor ID' },
+            { name: 'totalAmt', type: 'number', required: true, description: 'Total payment amount' },
+            { name: 'payType', type: 'string', required: true, description: 'Payment type: Check or CreditCard' },
+            { name: 'billIds', type: 'array', required: true, description: 'Bill IDs to pay' },
+            { name: 'bankAccountId', type: 'string', required: false, description: 'Bank account ID (for Check)' },
+            { name: 'creditCardAccountId', type: 'string', required: false, description: 'Credit card account ID (for CreditCard)' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Payment date' },
+        ],
+    },
+    {
+        name: 'delete_bill_payment',
+        description: 'Delete a bill payment',
+        params: [
+            { name: 'billPaymentId', type: 'string', required: true, description: 'The bill payment ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // EXPENSES / PURCHASES
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_purchases',
+        description: 'List all purchases/expenses',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_purchase',
+        description: 'Get a specific purchase/expense',
+        params: [
+            { name: 'purchaseId', type: 'string', required: true, description: 'The purchase ID' },
+        ],
+    },
+    {
+        name: 'create_expense',
+        description: 'Create an expense (cash/check/credit card purchase)',
+        params: [
+            { name: 'paymentType', type: 'string', required: true, description: 'Payment type: Cash, Check, or CreditCard' },
+            { name: 'accountId', type: 'string', required: true, description: 'Bank/Credit Card account ID' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of line items [{accountId, amount, description}]' },
+            { name: 'vendorId', type: 'string', required: false, description: 'Vendor ID' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+        ],
+    },
+    {
+        name: 'delete_purchase',
+        description: 'Delete a purchase/expense',
+        params: [
+            { name: 'purchaseId', type: 'string', required: true, description: 'The purchase ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // ITEMS (PRODUCTS/SERVICES)
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_items',
+        description: 'List products and services',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+            { name: 'type', type: 'string', required: false, description: 'Filter by type: Service, Inventory, NonInventory' },
+            { name: 'active', type: 'boolean', required: false, description: 'Filter by active status' },
+        ],
+    },
+    {
+        name: 'get_item',
+        description: 'Get a specific item by ID',
+        params: [
+            { name: 'itemId', type: 'string', required: true, description: 'The item ID' },
+        ],
+    },
+    {
+        name: 'create_item',
+        description: 'Create a new item (product or service)',
+        params: [
+            { name: 'name', type: 'string', required: true, description: 'Item name (must be unique)' },
+            { name: 'type', type: 'string', required: true, description: 'Item type: Service, Inventory, or NonInventory' },
+            { name: 'incomeAccountId', type: 'string', required: true, description: 'Income account ID' },
+            { name: 'expenseAccountId', type: 'string', required: false, description: 'Expense account ID (for inventory)' },
+            { name: 'unitPrice', type: 'number', required: false, description: 'Sales price' },
+            { name: 'purchaseCost', type: 'number', required: false, description: 'Purchase cost' },
+            { name: 'description', type: 'string', required: false, description: 'Sales description' },
+            { name: 'purchaseDesc', type: 'string', required: false, description: 'Purchase description' },
+            { name: 'qtyOnHand', type: 'number', required: false, description: 'Initial quantity (for inventory)' },
+            { name: 'assetAccountId', type: 'string', required: false, description: 'Asset account (for inventory)' },
+        ],
+    },
+    {
+        name: 'update_item',
+        description: 'Update an existing item',
+        params: [
+            { name: 'itemId', type: 'string', required: true, description: 'The item ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+            { name: 'name', type: 'string', required: false, description: 'Item name' },
+            { name: 'unitPrice', type: 'number', required: false, description: 'Sales price' },
+            { name: 'purchaseCost', type: 'number', required: false, description: 'Purchase cost' },
+            { name: 'description', type: 'string', required: false, description: 'Sales description' },
+            { name: 'active', type: 'boolean', required: false, description: 'Active status' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // ACCOUNTS (CHART OF ACCOUNTS)
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_accounts',
+        description: 'List chart of accounts',
+        params: [
+            { name: 'accountType', type: 'string', required: false, description: 'Filter by type: Bank, Expense, Income, etc.' },
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'active', type: 'boolean', required: false, description: 'Filter by active status' },
+        ],
+    },
+    {
+        name: 'get_account',
+        description: 'Get a specific account by ID',
+        params: [
+            { name: 'accountId', type: 'string', required: true, description: 'The account ID' },
+        ],
+    },
+    {
+        name: 'create_account',
+        description: 'Create a new account in chart of accounts',
+        params: [
+            { name: 'name', type: 'string', required: true, description: 'Account name (must be unique)' },
+            { name: 'accountType', type: 'string', required: true, description: 'Account type: Bank, Expense, Income, etc.' },
+            { name: 'accountSubType', type: 'string', required: false, description: 'Account sub-type' },
+            { name: 'description', type: 'string', required: false, description: 'Account description' },
+        ],
+    },
+    {
+        name: 'update_account',
+        description: 'Update an existing account',
+        params: [
+            { name: 'accountId', type: 'string', required: true, description: 'The account ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+            { name: 'name', type: 'string', required: false, description: 'Account name' },
+            { name: 'description', type: 'string', required: false, description: 'Description' },
+            { name: 'active', type: 'boolean', required: false, description: 'Active status' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // EMPLOYEES
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_employees',
+        description: 'List all employees',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+            { name: 'active', type: 'boolean', required: false, description: 'Filter by active status' },
+        ],
+    },
+    {
+        name: 'get_employee',
+        description: 'Get a specific employee by ID',
+        params: [
+            { name: 'employeeId', type: 'string', required: true, description: 'The employee ID' },
+        ],
+    },
+    {
+        name: 'create_employee',
+        description: 'Create a new employee',
+        params: [
+            { name: 'displayName', type: 'string', required: true, description: 'Display name' },
+            { name: 'givenName', type: 'string', required: false, description: 'First name' },
+            { name: 'familyName', type: 'string', required: false, description: 'Last name' },
+            { name: 'email', type: 'string', required: false, description: 'Email address' },
+            { name: 'phone', type: 'string', required: false, description: 'Phone number' },
+        ],
+    },
+    {
+        name: 'update_employee',
+        description: 'Update an existing employee',
+        params: [
+            { name: 'employeeId', type: 'string', required: true, description: 'The employee ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+            { name: 'displayName', type: 'string', required: false, description: 'Display name' },
+            { name: 'email', type: 'string', required: false, description: 'Email' },
+            { name: 'phone', type: 'string', required: false, description: 'Phone' },
+            { name: 'active', type: 'boolean', required: false, description: 'Active status' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // JOURNAL ENTRIES
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_journal_entries',
+        description: 'List all journal entries',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_journal_entry',
+        description: 'Get a specific journal entry',
+        params: [
+            { name: 'journalEntryId', type: 'string', required: true, description: 'The journal entry ID' },
+        ],
+    },
+    {
+        name: 'create_journal_entry',
+        description: 'Create a journal entry',
+        params: [
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of debit/credit lines [{accountId, amount, postingType: Debit|Credit, description}]' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+        ],
+    },
+    {
+        name: 'delete_journal_entry',
+        description: 'Delete a journal entry',
+        params: [
+            { name: 'journalEntryId', type: 'string', required: true, description: 'The journal entry ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // DEPOSITS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_deposits',
+        description: 'List all deposits',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_deposit',
+        description: 'Get a specific deposit',
+        params: [
+            { name: 'depositId', type: 'string', required: true, description: 'The deposit ID' },
+        ],
+    },
+    {
+        name: 'create_deposit',
+        description: 'Create a deposit',
+        params: [
+            { name: 'depositToAccountId', type: 'string', required: true, description: 'Bank account ID to deposit to' },
+            { name: 'lineItems', type: 'array', required: true, description: 'Array of deposit lines [{accountId, amount, description}]' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+        ],
+    },
+    {
+        name: 'delete_deposit',
+        description: 'Delete a deposit',
+        params: [
+            { name: 'depositId', type: 'string', required: true, description: 'The deposit ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // TRANSFERS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_transfers',
+        description: 'List all transfers between accounts',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+            { name: 'offset', type: 'number', required: false, description: 'Starting position' },
+        ],
+    },
+    {
+        name: 'get_transfer',
+        description: 'Get a specific transfer',
+        params: [
+            { name: 'transferId', type: 'string', required: true, description: 'The transfer ID' },
+        ],
+    },
+    {
+        name: 'create_transfer',
+        description: 'Create a transfer between accounts',
+        params: [
+            { name: 'fromAccountId', type: 'string', required: true, description: 'Source account ID' },
+            { name: 'toAccountId', type: 'string', required: true, description: 'Destination account ID' },
+            { name: 'amount', type: 'number', required: true, description: 'Transfer amount' },
+            { name: 'txnDate', type: 'string', required: false, description: 'Transaction date' },
+            { name: 'privateNote', type: 'string', required: false, description: 'Private note' },
+        ],
+    },
+    {
+        name: 'delete_transfer',
+        description: 'Delete a transfer',
+        params: [
+            { name: 'transferId', type: 'string', required: true, description: 'The transfer ID' },
+            { name: 'syncToken', type: 'string', required: true, description: 'Current sync token' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // TAX
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_tax_codes',
+        description: 'List all tax codes',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+        ],
+    },
+    {
+        name: 'list_tax_rates',
+        description: 'List all tax rates',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // PAYMENT METHODS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_payment_methods',
+        description: 'List all payment methods',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // TERMS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_terms',
+        description: 'List all payment terms (Net 30, Due on Receipt, etc.)',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // CLASSES / DEPARTMENTS
+    // --------------------------------------------------------------------------
+    {
+        name: 'list_classes',
+        description: 'List all classes (for tracking)',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+        ],
+    },
+    {
+        name: 'list_departments',
+        description: 'List all departments/locations',
+        params: [
+            { name: 'limit', type: 'number', required: false, description: 'Maximum number of results' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // REPORTS
+    // --------------------------------------------------------------------------
+    {
+        name: 'get_profit_loss_report',
+        description: 'Get Profit and Loss (Income Statement) report',
+        params: [
+            { name: 'startDate', type: 'string', required: false, description: 'Start date (YYYY-MM-DD)' },
+            { name: 'endDate', type: 'string', required: false, description: 'End date (YYYY-MM-DD)' },
+            { name: 'summarizeBy', type: 'string', required: false, description: 'Summarize by: Total, Month, Week, Days' },
+        ],
+    },
+    {
+        name: 'get_balance_sheet_report',
+        description: 'Get Balance Sheet report',
+        params: [
+            { name: 'startDate', type: 'string', required: false, description: 'Start date' },
+            { name: 'endDate', type: 'string', required: false, description: 'End date' },
+            { name: 'summarizeBy', type: 'string', required: false, description: 'Summarize by: Total, Month, Week, Days' },
+        ],
+    },
+    {
+        name: 'get_cash_flow_report',
+        description: 'Get Statement of Cash Flows report',
+        params: [
+            { name: 'startDate', type: 'string', required: false, description: 'Start date' },
+            { name: 'endDate', type: 'string', required: false, description: 'End date' },
+            { name: 'summarizeBy', type: 'string', required: false, description: 'Summarize by: Total, Month, Week, Days' },
+        ],
+    },
+    {
+        name: 'get_ar_aging_report',
+        description: 'Get Accounts Receivable Aging report',
+        params: [
+            { name: 'reportDate', type: 'string', required: false, description: 'Report date (YYYY-MM-DD)' },
+            { name: 'agingMethod', type: 'string', required: false, description: 'Aging method: Report_Date or Current' },
+        ],
+    },
+    {
+        name: 'get_ap_aging_report',
+        description: 'Get Accounts Payable Aging report',
+        params: [
+            { name: 'reportDate', type: 'string', required: false, description: 'Report date (YYYY-MM-DD)' },
+            { name: 'agingMethod', type: 'string', required: false, description: 'Aging method: Report_Date or Current' },
+        ],
+    },
+    {
+        name: 'get_customer_balance_report',
+        description: 'Get Customer Balance Summary report',
+        params: [
+            { name: 'reportDate', type: 'string', required: false, description: 'Report date' },
+        ],
+    },
+    {
+        name: 'get_vendor_balance_report',
+        description: 'Get Vendor Balance Summary report',
+        params: [
+            { name: 'reportDate', type: 'string', required: false, description: 'Report date' },
+        ],
+    },
+    {
+        name: 'get_general_ledger_report',
+        description: 'Get General Ledger report',
+        params: [
+            { name: 'startDate', type: 'string', required: false, description: 'Start date' },
+            { name: 'endDate', type: 'string', required: false, description: 'End date' },
+        ],
+    },
+    {
+        name: 'get_trial_balance_report',
+        description: 'Get Trial Balance report',
+        params: [
+            { name: 'startDate', type: 'string', required: false, description: 'Start date' },
+            { name: 'endDate', type: 'string', required: false, description: 'End date' },
+        ],
+    },
+    // --------------------------------------------------------------------------
+    // RAW QUERY
+    // --------------------------------------------------------------------------
+    {
+        name: 'query',
+        description: 'Run a SQL-like query against QuickBooks data. Example: "SELECT * FROM Customer WHERE DisplayName LIKE \'%Smith%\'"',
+        params: [
+            { name: 'query', type: 'string', required: true, description: 'SQL-like query string' },
+        ],
+    },
+];
+// ============================================================================
+// ACTION IMPLEMENTATIONS
+// ============================================================================
+// --------------------------------------------------------------------------
+// COMPANY
+// --------------------------------------------------------------------------
+async function getCompanyInfo() {
+    return qbRequest('companyinfo/' + REALM_ID);
+}
+async function getPreferences() {
+    return qbRequest('preferences');
+}
+// --------------------------------------------------------------------------
+// CUSTOMERS
+// --------------------------------------------------------------------------
+async function listCustomers(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const active = params.active;
+    let query = `SELECT * FROM Customer`;
+    if (active !== undefined) {
+        query += ` WHERE Active = ${active}`;
+    }
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getCustomer(params) {
+    const { customerId } = params;
+    if (!customerId)
+        throw new Error('customerId is required');
+    return qbRequest(`customer/${customerId}`);
+}
+async function createCustomer(params) {
+    const { displayName, companyName, givenName, familyName, email, phone, billingAddress } = params;
+    if (!displayName)
+        throw new Error('displayName is required');
+    const customer = { DisplayName: displayName };
+    if (companyName)
+        customer.CompanyName = companyName;
+    if (givenName)
+        customer.GivenName = givenName;
+    if (familyName)
+        customer.FamilyName = familyName;
+    if (email)
+        customer.PrimaryEmailAddr = { Address: email };
+    if (phone)
+        customer.PrimaryPhone = { FreeFormNumber: phone };
+    if (billingAddress)
+        customer.BillAddr = billingAddress;
+    return qbRequest('customer', 'POST', customer);
+}
+async function updateCustomer(params) {
+    const { customerId, syncToken, displayName, companyName, givenName, familyName, email, phone, active } = params;
+    if (!customerId || !syncToken)
+        throw new Error('customerId and syncToken are required');
+    const customer = { Id: customerId, SyncToken: syncToken, sparse: true };
+    if (displayName)
+        customer.DisplayName = displayName;
+    if (companyName)
+        customer.CompanyName = companyName;
+    if (givenName)
+        customer.GivenName = givenName;
+    if (familyName)
+        customer.FamilyName = familyName;
+    if (email)
+        customer.PrimaryEmailAddr = { Address: email };
+    if (phone)
+        customer.PrimaryPhone = { FreeFormNumber: phone };
+    if (active !== undefined)
+        customer.Active = active;
+    return qbRequest('customer', 'POST', customer);
+}
+// --------------------------------------------------------------------------
+// INVOICES
+// --------------------------------------------------------------------------
+async function listInvoices(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const status = params.status;
+    const customerId = params.customerId;
+    let query = `SELECT * FROM Invoice`;
+    const conditions = [];
+    if (status) {
+        if (status.toLowerCase() === 'paid')
+            conditions.push(`Balance = '0'`);
+        else if (status.toLowerCase() === 'unpaid')
+            conditions.push(`Balance > '0'`);
+    }
+    if (customerId)
+        conditions.push(`CustomerRef = '${customerId}'`);
+    if (conditions.length > 0)
+        query += ` WHERE ${conditions.join(' AND ')}`;
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getInvoice(params) {
+    const { invoiceId } = params;
+    if (!invoiceId)
+        throw new Error('invoiceId is required');
+    return qbRequest(`invoice/${invoiceId}`);
+}
+async function createInvoice(params) {
+    const { customerId, lineItems, dueDate, txnDate, privateNote, customerMemo } = params;
+    if (!customerId || !lineItems)
+        throw new Error('customerId and lineItems are required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        LineNum: idx + 1,
+        Amount: item.amount,
+        Description: item.description,
+        DetailType: 'SalesItemLineDetail',
+        SalesItemLineDetail: {
+            ItemRef: { value: item.itemId },
+            Qty: item.quantity || 1,
+        },
+    }));
+    const invoice = {
+        CustomerRef: { value: customerId },
+        Line: lines,
+    };
+    if (dueDate)
+        invoice.DueDate = dueDate;
+    if (txnDate)
+        invoice.TxnDate = txnDate;
+    if (privateNote)
+        invoice.PrivateNote = privateNote;
+    if (customerMemo)
+        invoice.CustomerMemo = { value: customerMemo };
+    return qbRequest('invoice', 'POST', invoice);
+}
+async function updateInvoice(params) {
+    const { invoiceId, syncToken, lineItems, dueDate, privateNote, customerMemo } = params;
+    if (!invoiceId || !syncToken)
+        throw new Error('invoiceId and syncToken are required');
+    const invoice = { Id: invoiceId, SyncToken: syncToken, sparse: true };
+    if (lineItems) {
+        invoice.Line = lineItems.map((item, idx) => ({
+            Id: String(idx + 1),
+            LineNum: idx + 1,
+            Amount: item.amount,
+            Description: item.description,
+            DetailType: 'SalesItemLineDetail',
+            SalesItemLineDetail: {
+                ItemRef: { value: item.itemId },
+                Qty: item.quantity || 1,
+            },
+        }));
+    }
+    if (dueDate)
+        invoice.DueDate = dueDate;
+    if (privateNote)
+        invoice.PrivateNote = privateNote;
+    if (customerMemo)
+        invoice.CustomerMemo = { value: customerMemo };
+    return qbRequest('invoice', 'POST', invoice);
+}
+async function deleteInvoice(params) {
+    const { invoiceId, syncToken } = params;
+    if (!invoiceId || !syncToken)
+        throw new Error('invoiceId and syncToken are required');
+    return qbRequest(`invoice?operation=delete`, 'POST', { Id: invoiceId, SyncToken: syncToken });
+}
+async function sendInvoice(params) {
+    const { invoiceId, email } = params;
+    if (!invoiceId)
+        throw new Error('invoiceId is required');
+    const endpoint = email ? `invoice/${invoiceId}/send?sendTo=${encodeURIComponent(String(email))}` : `invoice/${invoiceId}/send`;
+    return qbRequest(endpoint, 'POST');
+}
+async function voidInvoice(params) {
+    const { invoiceId, syncToken } = params;
+    if (!invoiceId || !syncToken)
+        throw new Error('invoiceId and syncToken are required');
+    return qbRequest(`invoice?operation=void`, 'POST', { Id: invoiceId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// ESTIMATES
+// --------------------------------------------------------------------------
+async function listEstimates(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const customerId = params.customerId;
+    let query = `SELECT * FROM Estimate`;
+    if (customerId)
+        query += ` WHERE CustomerRef = '${customerId}'`;
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getEstimate(params) {
+    const { estimateId } = params;
+    if (!estimateId)
+        throw new Error('estimateId is required');
+    return qbRequest(`estimate/${estimateId}`);
+}
+async function createEstimate(params) {
+    const { customerId, lineItems, expirationDate, txnDate, privateNote, customerMemo } = params;
+    if (!customerId || !lineItems)
+        throw new Error('customerId and lineItems are required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        LineNum: idx + 1,
+        Amount: item.amount,
+        Description: item.description,
+        DetailType: 'SalesItemLineDetail',
+        SalesItemLineDetail: {
+            ItemRef: { value: item.itemId },
+            Qty: item.quantity || 1,
+        },
+    }));
+    const estimate = {
+        CustomerRef: { value: customerId },
+        Line: lines,
+    };
+    if (expirationDate)
+        estimate.ExpirationDate = expirationDate;
+    if (txnDate)
+        estimate.TxnDate = txnDate;
+    if (privateNote)
+        estimate.PrivateNote = privateNote;
+    if (customerMemo)
+        estimate.CustomerMemo = { value: customerMemo };
+    return qbRequest('estimate', 'POST', estimate);
+}
+async function updateEstimate(params) {
+    const { estimateId, syncToken, lineItems, expirationDate, txnStatus } = params;
+    if (!estimateId || !syncToken)
+        throw new Error('estimateId and syncToken are required');
+    const estimate = { Id: estimateId, SyncToken: syncToken, sparse: true };
+    if (lineItems) {
+        estimate.Line = lineItems.map((item, idx) => ({
+            Id: String(idx + 1),
+            Amount: item.amount,
+            DetailType: 'SalesItemLineDetail',
+            SalesItemLineDetail: { ItemRef: { value: item.itemId }, Qty: item.quantity || 1 },
+        }));
+    }
+    if (expirationDate)
+        estimate.ExpirationDate = expirationDate;
+    if (txnStatus)
+        estimate.TxnStatus = txnStatus;
+    return qbRequest('estimate', 'POST', estimate);
+}
+async function deleteEstimate(params) {
+    const { estimateId, syncToken } = params;
+    if (!estimateId || !syncToken)
+        throw new Error('estimateId and syncToken are required');
+    return qbRequest(`estimate?operation=delete`, 'POST', { Id: estimateId, SyncToken: syncToken });
+}
+async function sendEstimate(params) {
+    const { estimateId, email } = params;
+    if (!estimateId)
+        throw new Error('estimateId is required');
+    const endpoint = email ? `estimate/${estimateId}/send?sendTo=${encodeURIComponent(String(email))}` : `estimate/${estimateId}/send`;
+    return qbRequest(endpoint, 'POST');
+}
+// --------------------------------------------------------------------------
+// PAYMENTS
+// --------------------------------------------------------------------------
+async function listPayments(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const customerId = params.customerId;
+    let query = `SELECT * FROM Payment`;
+    if (customerId)
+        query += ` WHERE CustomerRef = '${customerId}'`;
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getPayment(params) {
+    const { paymentId } = params;
+    if (!paymentId)
+        throw new Error('paymentId is required');
+    return qbRequest(`payment/${paymentId}`);
+}
+async function createPayment(params) {
+    const { customerId, totalAmt, txnDate, paymentMethodId, depositToAccountId, invoiceIds, privateNote } = params;
+    if (!customerId || totalAmt === undefined)
+        throw new Error('customerId and totalAmt are required');
+    const payment = {
+        CustomerRef: { value: customerId },
+        TotalAmt: totalAmt,
+    };
+    if (txnDate)
+        payment.TxnDate = txnDate;
+    if (paymentMethodId)
+        payment.PaymentMethodRef = { value: paymentMethodId };
+    if (depositToAccountId)
+        payment.DepositToAccountRef = { value: depositToAccountId };
+    if (privateNote)
+        payment.PrivateNote = privateNote;
+    if (invoiceIds && Array.isArray(invoiceIds)) {
+        payment.Line = invoiceIds.map(id => ({
+            Amount: totalAmt / invoiceIds.length,
+            LinkedTxn: [{ TxnId: id, TxnType: 'Invoice' }],
+        }));
+    }
+    return qbRequest('payment', 'POST', payment);
+}
+async function updatePayment(params) {
+    const { paymentId, syncToken, totalAmt, txnDate } = params;
+    if (!paymentId || !syncToken)
+        throw new Error('paymentId and syncToken are required');
+    const payment = { Id: paymentId, SyncToken: syncToken, sparse: true };
+    if (totalAmt !== undefined)
+        payment.TotalAmt = totalAmt;
+    if (txnDate)
+        payment.TxnDate = txnDate;
+    return qbRequest('payment', 'POST', payment);
+}
+async function deletePayment(params) {
+    const { paymentId, syncToken } = params;
+    if (!paymentId || !syncToken)
+        throw new Error('paymentId and syncToken are required');
+    return qbRequest(`payment?operation=delete`, 'POST', { Id: paymentId, SyncToken: syncToken });
+}
+async function voidPayment(params) {
+    const { paymentId, syncToken } = params;
+    if (!paymentId || !syncToken)
+        throw new Error('paymentId and syncToken are required');
+    return qbRequest(`payment?operation=void`, 'POST', { Id: paymentId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// SALES RECEIPTS
+// --------------------------------------------------------------------------
+async function listSalesReceipts(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM SalesReceipt MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getSalesReceipt(params) {
+    const { salesReceiptId } = params;
+    if (!salesReceiptId)
+        throw new Error('salesReceiptId is required');
+    return qbRequest(`salesreceipt/${salesReceiptId}`);
+}
+async function createSalesReceipt(params) {
+    const { customerId, lineItems, txnDate, paymentMethodId, depositToAccountId } = params;
+    if (!lineItems)
+        throw new Error('lineItems is required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        Amount: item.amount,
+        DetailType: 'SalesItemLineDetail',
+        SalesItemLineDetail: { ItemRef: { value: item.itemId }, Qty: item.quantity || 1 },
+    }));
+    const receipt = { Line: lines };
+    if (customerId)
+        receipt.CustomerRef = { value: customerId };
+    if (txnDate)
+        receipt.TxnDate = txnDate;
+    if (paymentMethodId)
+        receipt.PaymentMethodRef = { value: paymentMethodId };
+    if (depositToAccountId)
+        receipt.DepositToAccountRef = { value: depositToAccountId };
+    return qbRequest('salesreceipt', 'POST', receipt);
+}
+async function deleteSalesReceipt(params) {
+    const { salesReceiptId, syncToken } = params;
+    if (!salesReceiptId || !syncToken)
+        throw new Error('salesReceiptId and syncToken are required');
+    return qbRequest(`salesreceipt?operation=delete`, 'POST', { Id: salesReceiptId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// CREDIT MEMOS
+// --------------------------------------------------------------------------
+async function listCreditMemos(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM CreditMemo MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getCreditMemo(params) {
+    const { creditMemoId } = params;
+    if (!creditMemoId)
+        throw new Error('creditMemoId is required');
+    return qbRequest(`creditmemo/${creditMemoId}`);
+}
+async function createCreditMemo(params) {
+    const { customerId, lineItems, txnDate, privateNote } = params;
+    if (!customerId || !lineItems)
+        throw new Error('customerId and lineItems are required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        Amount: item.amount,
+        DetailType: 'SalesItemLineDetail',
+        SalesItemLineDetail: { ItemRef: { value: item.itemId }, Qty: item.quantity || 1 },
+    }));
+    const memo = { CustomerRef: { value: customerId }, Line: lines };
+    if (txnDate)
+        memo.TxnDate = txnDate;
+    if (privateNote)
+        memo.PrivateNote = privateNote;
+    return qbRequest('creditmemo', 'POST', memo);
+}
+async function deleteCreditMemo(params) {
+    const { creditMemoId, syncToken } = params;
+    if (!creditMemoId || !syncToken)
+        throw new Error('creditMemoId and syncToken are required');
+    return qbRequest(`creditmemo?operation=delete`, 'POST', { Id: creditMemoId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// REFUND RECEIPTS
+// --------------------------------------------------------------------------
+async function listRefundReceipts(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM RefundReceipt MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getRefundReceipt(params) {
+    const { refundReceiptId } = params;
+    if (!refundReceiptId)
+        throw new Error('refundReceiptId is required');
+    return qbRequest(`refundreceipt/${refundReceiptId}`);
+}
+async function createRefundReceipt(params) {
+    const { customerId, lineItems, txnDate, depositToAccountId } = params;
+    if (!customerId || !lineItems)
+        throw new Error('customerId and lineItems are required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        Amount: item.amount,
+        DetailType: 'SalesItemLineDetail',
+        SalesItemLineDetail: { ItemRef: { value: item.itemId }, Qty: item.quantity || 1 },
+    }));
+    const refund = { CustomerRef: { value: customerId }, Line: lines };
+    if (txnDate)
+        refund.TxnDate = txnDate;
+    if (depositToAccountId)
+        refund.DepositToAccountRef = { value: depositToAccountId };
+    return qbRequest('refundreceipt', 'POST', refund);
+}
+async function deleteRefundReceipt(params) {
+    const { refundReceiptId, syncToken } = params;
+    if (!refundReceiptId || !syncToken)
+        throw new Error('refundReceiptId and syncToken are required');
+    return qbRequest(`refundreceipt?operation=delete`, 'POST', { Id: refundReceiptId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// VENDORS
+// --------------------------------------------------------------------------
+async function listVendors(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const active = params.active;
+    let query = `SELECT * FROM Vendor`;
+    if (active !== undefined)
+        query += ` WHERE Active = ${active}`;
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getVendor(params) {
+    const { vendorId } = params;
+    if (!vendorId)
+        throw new Error('vendorId is required');
+    return qbRequest(`vendor/${vendorId}`);
+}
+async function createVendor(params) {
+    const { displayName, companyName, givenName, familyName, email, phone } = params;
+    if (!displayName)
+        throw new Error('displayName is required');
+    const vendor = { DisplayName: displayName };
+    if (companyName)
+        vendor.CompanyName = companyName;
+    if (givenName)
+        vendor.GivenName = givenName;
+    if (familyName)
+        vendor.FamilyName = familyName;
+    if (email)
+        vendor.PrimaryEmailAddr = { Address: email };
+    if (phone)
+        vendor.PrimaryPhone = { FreeFormNumber: phone };
+    return qbRequest('vendor', 'POST', vendor);
+}
+async function updateVendor(params) {
+    const { vendorId, syncToken, displayName, email, phone, active } = params;
+    if (!vendorId || !syncToken)
+        throw new Error('vendorId and syncToken are required');
+    const vendor = { Id: vendorId, SyncToken: syncToken, sparse: true };
+    if (displayName)
+        vendor.DisplayName = displayName;
+    if (email)
+        vendor.PrimaryEmailAddr = { Address: email };
+    if (phone)
+        vendor.PrimaryPhone = { FreeFormNumber: phone };
+    if (active !== undefined)
+        vendor.Active = active;
+    return qbRequest('vendor', 'POST', vendor);
+}
+// --------------------------------------------------------------------------
+// BILLS
+// --------------------------------------------------------------------------
+async function listBills(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const vendorId = params.vendorId;
+    const status = params.status;
+    let query = `SELECT * FROM Bill`;
+    const conditions = [];
+    if (vendorId)
+        conditions.push(`VendorRef = '${vendorId}'`);
+    if (status) {
+        if (status.toLowerCase() === 'paid')
+            conditions.push(`Balance = '0'`);
+        else if (status.toLowerCase() === 'unpaid')
+            conditions.push(`Balance > '0'`);
+    }
+    if (conditions.length > 0)
+        query += ` WHERE ${conditions.join(' AND ')}`;
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getBill(params) {
+    const { billId } = params;
+    if (!billId)
+        throw new Error('billId is required');
+    return qbRequest(`bill/${billId}`);
+}
+async function createBill(params) {
+    const { vendorId, lineItems, dueDate, txnDate, privateNote } = params;
+    if (!vendorId || !lineItems)
+        throw new Error('vendorId and lineItems are required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        Amount: item.amount,
+        Description: item.description,
+        DetailType: 'AccountBasedExpenseLineDetail',
+        AccountBasedExpenseLineDetail: { AccountRef: { value: item.accountId } },
+    }));
+    const bill = { VendorRef: { value: vendorId }, Line: lines };
+    if (dueDate)
+        bill.DueDate = dueDate;
+    if (txnDate)
+        bill.TxnDate = txnDate;
+    if (privateNote)
+        bill.PrivateNote = privateNote;
+    return qbRequest('bill', 'POST', bill);
+}
+async function updateBill(params) {
+    const { billId, syncToken, lineItems, dueDate } = params;
+    if (!billId || !syncToken)
+        throw new Error('billId and syncToken are required');
+    const bill = { Id: billId, SyncToken: syncToken, sparse: true };
+    if (lineItems) {
+        bill.Line = lineItems.map((item, idx) => ({
+            Id: String(idx + 1),
+            Amount: item.amount,
+            DetailType: 'AccountBasedExpenseLineDetail',
+            AccountBasedExpenseLineDetail: { AccountRef: { value: item.accountId } },
+        }));
+    }
+    if (dueDate)
+        bill.DueDate = dueDate;
+    return qbRequest('bill', 'POST', bill);
+}
+async function deleteBill(params) {
+    const { billId, syncToken } = params;
+    if (!billId || !syncToken)
+        throw new Error('billId and syncToken are required');
+    return qbRequest(`bill?operation=delete`, 'POST', { Id: billId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// BILL PAYMENTS
+// --------------------------------------------------------------------------
+async function listBillPayments(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM BillPayment MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getBillPayment(params) {
+    const { billPaymentId } = params;
+    if (!billPaymentId)
+        throw new Error('billPaymentId is required');
+    return qbRequest(`billpayment/${billPaymentId}`);
+}
+async function createBillPayment(params) {
+    const { vendorId, totalAmt, payType, billIds, bankAccountId, creditCardAccountId, txnDate } = params;
+    if (!vendorId || totalAmt === undefined || !payType || !billIds) {
+        throw new Error('vendorId, totalAmt, payType, and billIds are required');
+    }
+    const lines = billIds.map(billId => ({
+        Amount: totalAmt / billIds.length,
+        LinkedTxn: [{ TxnId: billId, TxnType: 'Bill' }],
+    }));
+    const payment = {
+        VendorRef: { value: vendorId },
+        TotalAmt: totalAmt,
+        PayType: payType,
+        Line: lines,
+    };
+    if (payType === 'Check' && bankAccountId) {
+        payment.CheckPayment = { BankAccountRef: { value: bankAccountId } };
+    }
+    else if (payType === 'CreditCard' && creditCardAccountId) {
+        payment.CreditCardPayment = { CCAccountRef: { value: creditCardAccountId } };
+    }
+    if (txnDate)
+        payment.TxnDate = txnDate;
+    return qbRequest('billpayment', 'POST', payment);
+}
+async function deleteBillPayment(params) {
+    const { billPaymentId, syncToken } = params;
+    if (!billPaymentId || !syncToken)
+        throw new Error('billPaymentId and syncToken are required');
+    return qbRequest(`billpayment?operation=delete`, 'POST', { Id: billPaymentId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// EXPENSES / PURCHASES
+// --------------------------------------------------------------------------
+async function listPurchases(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM Purchase MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getPurchase(params) {
+    const { purchaseId } = params;
+    if (!purchaseId)
+        throw new Error('purchaseId is required');
+    return qbRequest(`purchase/${purchaseId}`);
+}
+async function createExpense(params) {
+    const { paymentType, accountId, lineItems, vendorId, txnDate, privateNote } = params;
+    if (!paymentType || !accountId || !lineItems) {
+        throw new Error('paymentType, accountId, and lineItems are required');
+    }
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        Amount: item.amount,
+        Description: item.description,
+        DetailType: 'AccountBasedExpenseLineDetail',
+        AccountBasedExpenseLineDetail: { AccountRef: { value: item.accountId } },
+    }));
+    const expense = {
+        PaymentType: paymentType,
+        AccountRef: { value: accountId },
+        Line: lines,
+    };
+    if (vendorId)
+        expense.EntityRef = { value: vendorId, type: 'Vendor' };
+    if (txnDate)
+        expense.TxnDate = txnDate;
+    if (privateNote)
+        expense.PrivateNote = privateNote;
+    return qbRequest('purchase', 'POST', expense);
+}
+async function deletePurchase(params) {
+    const { purchaseId, syncToken } = params;
+    if (!purchaseId || !syncToken)
+        throw new Error('purchaseId and syncToken are required');
+    return qbRequest(`purchase?operation=delete`, 'POST', { Id: purchaseId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// ITEMS
+// --------------------------------------------------------------------------
+async function listItems(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const type = params.type;
+    const active = params.active;
+    let query = `SELECT * FROM Item`;
+    const conditions = [];
+    if (type)
+        conditions.push(`Type = '${type}'`);
+    if (active !== undefined)
+        conditions.push(`Active = ${active}`);
+    if (conditions.length > 0)
+        query += ` WHERE ${conditions.join(' AND ')}`;
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getItem(params) {
+    const { itemId } = params;
+    if (!itemId)
+        throw new Error('itemId is required');
+    return qbRequest(`item/${itemId}`);
+}
+async function createItem(params) {
+    const { name, type, incomeAccountId, expenseAccountId, unitPrice, purchaseCost, description, purchaseDesc, qtyOnHand, assetAccountId } = params;
+    if (!name || !type || !incomeAccountId)
+        throw new Error('name, type, and incomeAccountId are required');
+    const item = {
+        Name: name,
+        Type: type,
+        IncomeAccountRef: { value: incomeAccountId },
+    };
+    if (expenseAccountId)
+        item.ExpenseAccountRef = { value: expenseAccountId };
+    if (unitPrice !== undefined)
+        item.UnitPrice = unitPrice;
+    if (purchaseCost !== undefined)
+        item.PurchaseCost = purchaseCost;
+    if (description)
+        item.Description = description;
+    if (purchaseDesc)
+        item.PurchaseDesc = purchaseDesc;
+    if (type === 'Inventory') {
+        item.TrackQtyOnHand = true;
+        item.QtyOnHand = qtyOnHand || 0;
+        item.InvStartDate = new Date().toISOString().split('T')[0];
+        if (assetAccountId)
+            item.AssetAccountRef = { value: assetAccountId };
+    }
+    return qbRequest('item', 'POST', item);
+}
+async function updateItem(params) {
+    const { itemId, syncToken, name, unitPrice, purchaseCost, description, active } = params;
+    if (!itemId || !syncToken)
+        throw new Error('itemId and syncToken are required');
+    const item = { Id: itemId, SyncToken: syncToken, sparse: true };
+    if (name)
+        item.Name = name;
+    if (unitPrice !== undefined)
+        item.UnitPrice = unitPrice;
+    if (purchaseCost !== undefined)
+        item.PurchaseCost = purchaseCost;
+    if (description)
+        item.Description = description;
+    if (active !== undefined)
+        item.Active = active;
+    return qbRequest('item', 'POST', item);
+}
+// --------------------------------------------------------------------------
+// ACCOUNTS
+// --------------------------------------------------------------------------
+async function listAccounts(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const accountType = params.accountType;
+    const active = params.active;
+    let query = `SELECT * FROM Account`;
+    const conditions = [];
+    if (accountType)
+        conditions.push(`AccountType = '${accountType}'`);
+    if (active !== undefined)
+        conditions.push(`Active = ${active}`);
+    if (conditions.length > 0)
+        query += ` WHERE ${conditions.join(' AND ')}`;
+    query += ` MAXRESULTS ${limit}`;
+    return qbQuery(query);
+}
+async function getAccount(params) {
+    const { accountId } = params;
+    if (!accountId)
+        throw new Error('accountId is required');
+    return qbRequest(`account/${accountId}`);
+}
+async function createAccount(params) {
+    const { name, accountType, accountSubType, description } = params;
+    if (!name || !accountType)
+        throw new Error('name and accountType are required');
+    const account = { Name: name, AccountType: accountType };
+    if (accountSubType)
+        account.AccountSubType = accountSubType;
+    if (description)
+        account.Description = description;
+    return qbRequest('account', 'POST', account);
+}
+async function updateAccount(params) {
+    const { accountId, syncToken, name, description, active } = params;
+    if (!accountId || !syncToken)
+        throw new Error('accountId and syncToken are required');
+    const account = { Id: accountId, SyncToken: syncToken, sparse: true };
+    if (name)
+        account.Name = name;
+    if (description)
+        account.Description = description;
+    if (active !== undefined)
+        account.Active = active;
+    return qbRequest('account', 'POST', account);
+}
+// --------------------------------------------------------------------------
+// EMPLOYEES
+// --------------------------------------------------------------------------
+async function listEmployees(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    const active = params.active;
+    let query = `SELECT * FROM Employee`;
+    if (active !== undefined)
+        query += ` WHERE Active = ${active}`;
+    query += ` MAXRESULTS ${limit} STARTPOSITION ${offset}`;
+    return qbQuery(query);
+}
+async function getEmployee(params) {
+    const { employeeId } = params;
+    if (!employeeId)
+        throw new Error('employeeId is required');
+    return qbRequest(`employee/${employeeId}`);
+}
+async function createEmployee(params) {
+    const { displayName, givenName, familyName, email, phone } = params;
+    if (!displayName)
+        throw new Error('displayName is required');
+    const employee = { DisplayName: displayName };
+    if (givenName)
+        employee.GivenName = givenName;
+    if (familyName)
+        employee.FamilyName = familyName;
+    if (email)
+        employee.PrimaryEmailAddr = { Address: email };
+    if (phone)
+        employee.PrimaryPhone = { FreeFormNumber: phone };
+    return qbRequest('employee', 'POST', employee);
+}
+async function updateEmployee(params) {
+    const { employeeId, syncToken, displayName, email, phone, active } = params;
+    if (!employeeId || !syncToken)
+        throw new Error('employeeId and syncToken are required');
+    const employee = { Id: employeeId, SyncToken: syncToken, sparse: true };
+    if (displayName)
+        employee.DisplayName = displayName;
+    if (email)
+        employee.PrimaryEmailAddr = { Address: email };
+    if (phone)
+        employee.PrimaryPhone = { FreeFormNumber: phone };
+    if (active !== undefined)
+        employee.Active = active;
+    return qbRequest('employee', 'POST', employee);
+}
+// --------------------------------------------------------------------------
+// JOURNAL ENTRIES
+// --------------------------------------------------------------------------
+async function listJournalEntries(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM JournalEntry MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getJournalEntry(params) {
+    const { journalEntryId } = params;
+    if (!journalEntryId)
+        throw new Error('journalEntryId is required');
+    return qbRequest(`journalentry/${journalEntryId}`);
+}
+async function createJournalEntry(params) {
+    const { lineItems, txnDate, privateNote } = params;
+    if (!lineItems)
+        throw new Error('lineItems is required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        Amount: item.amount,
+        Description: item.description,
+        DetailType: 'JournalEntryLineDetail',
+        JournalEntryLineDetail: {
+            PostingType: item.postingType,
+            AccountRef: { value: item.accountId },
+        },
+    }));
+    const entry = { Line: lines };
+    if (txnDate)
+        entry.TxnDate = txnDate;
+    if (privateNote)
+        entry.PrivateNote = privateNote;
+    return qbRequest('journalentry', 'POST', entry);
+}
+async function deleteJournalEntry(params) {
+    const { journalEntryId, syncToken } = params;
+    if (!journalEntryId || !syncToken)
+        throw new Error('journalEntryId and syncToken are required');
+    return qbRequest(`journalentry?operation=delete`, 'POST', { Id: journalEntryId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// DEPOSITS
+// --------------------------------------------------------------------------
+async function listDeposits(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM Deposit MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getDeposit(params) {
+    const { depositId } = params;
+    if (!depositId)
+        throw new Error('depositId is required');
+    return qbRequest(`deposit/${depositId}`);
+}
+async function createDeposit(params) {
+    const { depositToAccountId, lineItems, txnDate } = params;
+    if (!depositToAccountId || !lineItems)
+        throw new Error('depositToAccountId and lineItems are required');
+    const lines = lineItems.map((item, idx) => ({
+        Id: String(idx + 1),
+        Amount: item.amount,
+        Description: item.description,
+        DetailType: 'DepositLineDetail',
+        DepositLineDetail: { AccountRef: { value: item.accountId } },
+    }));
+    const deposit = {
+        DepositToAccountRef: { value: depositToAccountId },
+        Line: lines,
+    };
+    if (txnDate)
+        deposit.TxnDate = txnDate;
+    return qbRequest('deposit', 'POST', deposit);
+}
+async function deleteDeposit(params) {
+    const { depositId, syncToken } = params;
+    if (!depositId || !syncToken)
+        throw new Error('depositId and syncToken are required');
+    return qbRequest(`deposit?operation=delete`, 'POST', { Id: depositId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// TRANSFERS
+// --------------------------------------------------------------------------
+async function listTransfers(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    const offset = Number(params.offset) || 1;
+    return qbQuery(`SELECT * FROM Transfer MAXRESULTS ${limit} STARTPOSITION ${offset}`);
+}
+async function getTransfer(params) {
+    const { transferId } = params;
+    if (!transferId)
+        throw new Error('transferId is required');
+    return qbRequest(`transfer/${transferId}`);
+}
+async function createTransfer(params) {
+    const { fromAccountId, toAccountId, amount, txnDate, privateNote } = params;
+    if (!fromAccountId || !toAccountId || amount === undefined) {
+        throw new Error('fromAccountId, toAccountId, and amount are required');
+    }
+    const transfer = {
+        FromAccountRef: { value: fromAccountId },
+        ToAccountRef: { value: toAccountId },
+        Amount: amount,
+    };
+    if (txnDate)
+        transfer.TxnDate = txnDate;
+    if (privateNote)
+        transfer.PrivateNote = privateNote;
+    return qbRequest('transfer', 'POST', transfer);
+}
+async function deleteTransfer(params) {
+    const { transferId, syncToken } = params;
+    if (!transferId || !syncToken)
+        throw new Error('transferId and syncToken are required');
+    return qbRequest(`transfer?operation=delete`, 'POST', { Id: transferId, SyncToken: syncToken });
+}
+// --------------------------------------------------------------------------
+// TAX
+// --------------------------------------------------------------------------
+async function listTaxCodes(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    return qbQuery(`SELECT * FROM TaxCode MAXRESULTS ${limit}`);
+}
+async function listTaxRates(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    return qbQuery(`SELECT * FROM TaxRate MAXRESULTS ${limit}`);
+}
+// --------------------------------------------------------------------------
+// PAYMENT METHODS
+// --------------------------------------------------------------------------
+async function listPaymentMethods(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    return qbQuery(`SELECT * FROM PaymentMethod MAXRESULTS ${limit}`);
+}
+// --------------------------------------------------------------------------
+// TERMS
+// --------------------------------------------------------------------------
+async function listTerms(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    return qbQuery(`SELECT * FROM Term MAXRESULTS ${limit}`);
+}
+// --------------------------------------------------------------------------
+// CLASSES / DEPARTMENTS
+// --------------------------------------------------------------------------
+async function listClasses(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    return qbQuery(`SELECT * FROM Class MAXRESULTS ${limit}`);
+}
+async function listDepartments(params) {
+    const limit = Math.min(Number(params.limit) || 100, 1000);
+    return qbQuery(`SELECT * FROM Department MAXRESULTS ${limit}`);
+}
+// --------------------------------------------------------------------------
+// REPORTS
+// --------------------------------------------------------------------------
+async function getReport(reportName, params) {
+    const queryParams = [];
+    if (params.startDate)
+        queryParams.push(`start_date=${params.startDate}`);
+    if (params.endDate)
+        queryParams.push(`end_date=${params.endDate}`);
+    if (params.reportDate)
+        queryParams.push(`report_date=${params.reportDate}`);
+    if (params.summarizeBy)
+        queryParams.push(`summarize_column_by=${params.summarizeBy}`);
+    if (params.agingMethod)
+        queryParams.push(`aging_method=${params.agingMethod}`);
+    const queryString = queryParams.length > 0 ? `?${queryParams.join('&')}` : '';
+    return qbRequest(`reports/${reportName}${queryString}`);
+}
+async function getProfitLossReport(params) {
+    return getReport('ProfitAndLoss', params);
+}
+async function getBalanceSheetReport(params) {
+    return getReport('BalanceSheet', params);
+}
+async function getCashFlowReport(params) {
+    return getReport('CashFlow', params);
+}
+async function getArAgingReport(params) {
+    return getReport('AgedReceivables', params);
+}
+async function getApAgingReport(params) {
+    return getReport('AgedPayables', params);
+}
+async function getCustomerBalanceReport(params) {
+    return getReport('CustomerBalance', params);
+}
+async function getVendorBalanceReport(params) {
+    return getReport('VendorBalance', params);
+}
+async function getGeneralLedgerReport(params) {
+    return getReport('GeneralLedger', params);
+}
+async function getTrialBalanceReport(params) {
+    return getReport('TrialBalance', params);
+}
+// --------------------------------------------------------------------------
+// RAW QUERY
+// --------------------------------------------------------------------------
+async function runQuery(params) {
+    const { query } = params;
+    if (!query || typeof query !== 'string') {
+        throw new Error('query is required and must be a string');
+    }
+    if (!query.trim().toUpperCase().startsWith('SELECT')) {
+        throw new Error('Only SELECT queries are allowed');
+    }
+    return qbQuery(query);
+}
+// ============================================================================
+// BACKEND EXPORT
+// ============================================================================
+export const quickbooksBackend = {
+    name: 'quickbooks',
+    description: 'Comprehensive QuickBooks Online accounting integration: customers, invoices, estimates, payments, bills, vendors, items, accounts, employees, journal entries, reports, and more.',
+    actions,
+    async execute(action, params) {
+        switch (action) {
+            // Company
+            case 'get_company_info': return getCompanyInfo();
+            case 'get_preferences': return getPreferences();
+            // Customers
+            case 'list_customers': return listCustomers(params);
+            case 'get_customer': return getCustomer(params);
+            case 'create_customer': return createCustomer(params);
+            case 'update_customer': return updateCustomer(params);
+            // Invoices
+            case 'list_invoices': return listInvoices(params);
+            case 'get_invoice': return getInvoice(params);
+            case 'create_invoice': return createInvoice(params);
+            case 'update_invoice': return updateInvoice(params);
+            case 'delete_invoice': return deleteInvoice(params);
+            case 'send_invoice': return sendInvoice(params);
+            case 'void_invoice': return voidInvoice(params);
+            // Estimates
+            case 'list_estimates': return listEstimates(params);
+            case 'get_estimate': return getEstimate(params);
+            case 'create_estimate': return createEstimate(params);
+            case 'update_estimate': return updateEstimate(params);
+            case 'delete_estimate': return deleteEstimate(params);
+            case 'send_estimate': return sendEstimate(params);
+            // Payments
+            case 'list_payments': return listPayments(params);
+            case 'get_payment': return getPayment(params);
+            case 'create_payment': return createPayment(params);
+            case 'update_payment': return updatePayment(params);
+            case 'delete_payment': return deletePayment(params);
+            case 'void_payment': return voidPayment(params);
+            // Sales Receipts
+            case 'list_sales_receipts': return listSalesReceipts(params);
+            case 'get_sales_receipt': return getSalesReceipt(params);
+            case 'create_sales_receipt': return createSalesReceipt(params);
+            case 'delete_sales_receipt': return deleteSalesReceipt(params);
+            // Credit Memos
+            case 'list_credit_memos': return listCreditMemos(params);
+            case 'get_credit_memo': return getCreditMemo(params);
+            case 'create_credit_memo': return createCreditMemo(params);
+            case 'delete_credit_memo': return deleteCreditMemo(params);
+            // Refund Receipts
+            case 'list_refund_receipts': return listRefundReceipts(params);
+            case 'get_refund_receipt': return getRefundReceipt(params);
+            case 'create_refund_receipt': return createRefundReceipt(params);
+            case 'delete_refund_receipt': return deleteRefundReceipt(params);
+            // Vendors
+            case 'list_vendors': return listVendors(params);
+            case 'get_vendor': return getVendor(params);
+            case 'create_vendor': return createVendor(params);
+            case 'update_vendor': return updateVendor(params);
+            // Bills
+            case 'list_bills': return listBills(params);
+            case 'get_bill': return getBill(params);
+            case 'create_bill': return createBill(params);
+            case 'update_bill': return updateBill(params);
+            case 'delete_bill': return deleteBill(params);
+            // Bill Payments
+            case 'list_bill_payments': return listBillPayments(params);
+            case 'get_bill_payment': return getBillPayment(params);
+            case 'create_bill_payment': return createBillPayment(params);
+            case 'delete_bill_payment': return deleteBillPayment(params);
+            // Expenses / Purchases
+            case 'list_purchases': return listPurchases(params);
+            case 'get_purchase': return getPurchase(params);
+            case 'create_expense': return createExpense(params);
+            case 'delete_purchase': return deletePurchase(params);
+            // Items
+            case 'list_items': return listItems(params);
+            case 'get_item': return getItem(params);
+            case 'create_item': return createItem(params);
+            case 'update_item': return updateItem(params);
+            // Accounts
+            case 'list_accounts': return listAccounts(params);
+            case 'get_account': return getAccount(params);
+            case 'create_account': return createAccount(params);
+            case 'update_account': return updateAccount(params);
+            // Employees
+            case 'list_employees': return listEmployees(params);
+            case 'get_employee': return getEmployee(params);
+            case 'create_employee': return createEmployee(params);
+            case 'update_employee': return updateEmployee(params);
+            // Journal Entries
+            case 'list_journal_entries': return listJournalEntries(params);
+            case 'get_journal_entry': return getJournalEntry(params);
+            case 'create_journal_entry': return createJournalEntry(params);
+            case 'delete_journal_entry': return deleteJournalEntry(params);
+            // Deposits
+            case 'list_deposits': return listDeposits(params);
+            case 'get_deposit': return getDeposit(params);
+            case 'create_deposit': return createDeposit(params);
+            case 'delete_deposit': return deleteDeposit(params);
+            // Transfers
+            case 'list_transfers': return listTransfers(params);
+            case 'get_transfer': return getTransfer(params);
+            case 'create_transfer': return createTransfer(params);
+            case 'delete_transfer': return deleteTransfer(params);
+            // Tax
+            case 'list_tax_codes': return listTaxCodes(params);
+            case 'list_tax_rates': return listTaxRates(params);
+            // Payment Methods
+            case 'list_payment_methods': return listPaymentMethods(params);
+            // Terms
+            case 'list_terms': return listTerms(params);
+            // Classes / Departments
+            case 'list_classes': return listClasses(params);
+            case 'list_departments': return listDepartments(params);
+            // Reports
+            case 'get_profit_loss_report': return getProfitLossReport(params);
+            case 'get_balance_sheet_report': return getBalanceSheetReport(params);
+            case 'get_cash_flow_report': return getCashFlowReport(params);
+            case 'get_ar_aging_report': return getArAgingReport(params);
+            case 'get_ap_aging_report': return getApAgingReport(params);
+            case 'get_customer_balance_report': return getCustomerBalanceReport(params);
+            case 'get_vendor_balance_report': return getVendorBalanceReport(params);
+            case 'get_general_ledger_report': return getGeneralLedgerReport(params);
+            case 'get_trial_balance_report': return getTrialBalanceReport(params);
+            // Query
+            case 'query': return runQuery(params);
+            default:
+                throw new Error(`Unknown action: ${action}`);
+        }
+    },
+    async healthCheck() {
+        const startTime = Date.now();
+        try {
+            if (!CLIENT_ID || !CLIENT_SECRET || !refreshToken || !REALM_ID) {
+                return {
+                    status: 'unavailable',
+                    latency_ms: Date.now() - startTime,
+                    error: 'QuickBooks credentials not configured',
+                };
+            }
+            await getCompanyInfo();
+            return {
+                status: 'healthy',
+                latency_ms: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'unavailable',
+                latency_ms: Date.now() - startTime,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+};
+//# sourceMappingURL=quickbooks.js.map