@happyvertical/accounting 0.101.3 → 0.102.1

package/dist/index.d.ts

@@ -1,4 +1,35 @@
-import { AccountingOptions, AccountingProvider, QuickBooksOptions, StripeOptions } from './types.js';
+/**
+ * @happyvertical/accounting - Multi-provider accounting integration
+ *
+ * This package provides a unified interface for syncing and auditing
+ * accounting data (AR/AP) with external providers like QuickBooks Online,
+ * Stripe, PayPal, and Coinbase Commerce.
+ *
+ * Key components:
+ * - getAccountingProvider() - Factory function for creating provider instances
+ * - AccountingProvider - Unified interface for all providers
+ * - Audit operations for reconciling local vs external data
+ *
+ * @example
+ * ```typescript
+ * import { getAccountingProvider } from '@happyvertical/accounting';
+ *
+ * const provider = await getAccountingProvider({
+ *   type: 'quickbooks',
+ *   clientId: 'xxx',
+ *   clientSecret: 'xxx',
+ *   realmId: 'xxx',
+ *   refreshToken: 'xxx'
+ * });
+ *
+ * // Sync a customer
+ * const result = await provider.customers.sync(customer);
+ *
+ * // Audit invoices
+ * const report = await provider.audit.reconcileInvoices(localInvoices);
+ * ```
+ */
+import type { AccountingOptions, AccountingProvider, QuickBooksOptions, StripeOptions } from './types.js';
 export type { QuickBooksOAuthErrorCode } from './errors.js';
 export { QuickBooksOAuthError, QuickBooksWriteError, StripeApiError, } from './errors.js';
 export { prepareQuickBooksInvoiceRequest } from './providers/quickbooks/invoice-request.js';

package/dist/providers/quickbooks/index.d.ts

@@ -1,4 +1,10 @@
-import { AccountingProvider, AuditOperations, BillOperations, CustomerOperations, InvoiceOperations, PaymentOperations, QuickBooksInvoiceRequest, QuickBooksOptions, VendorOperations, WebhookOperations } from '../../types.js';
+/**
+ * QuickBooks Online Provider
+ *
+ * Implements the AccountingProvider interface for QuickBooks Online.
+ * Uses the Intuit OAuth2 library for authentication and the QBO API for operations.
+ */
+import type { AccountingProvider, AuditOperations, BillOperations, CustomerOperations, InvoiceOperations, PaymentOperations, QuickBooksInvoiceRequest, QuickBooksOptions, VendorOperations, WebhookOperations } from '../../types.js';
 /**
  * QuickBooks Online accounting provider
  */

package/dist/providers/quickbooks/invoice-request.d.ts

@@ -1,4 +1,4 @@
-import { InvoiceInput, QuickBooksInvoiceRequest } from '../../types.js';
+import type { InvoiceInput, QuickBooksInvoiceRequest } from '../../types.js';
 /** Prepare once, persist before sending, and reuse unchanged. Performs no I/O. */
 export declare function prepareQuickBooksInvoiceRequest(invoice: InvoiceInput, identity: Omit<QuickBooksInvoiceRequest, 'payloadHash'>): QuickBooksInvoiceRequest;
 export declare function validateQuickBooksInvoiceRequest(request: QuickBooksInvoiceRequest, realmId: string, environment: 'sandbox' | 'production', payload: string | undefined): void;

package/dist/providers/quickbooks/oauth.d.ts

@@ -1,4 +1,4 @@
-import { QuickBooksOAuthClient, QuickBooksOAuthOptions } from '../../types.js';
+import type { QuickBooksOAuthClient, QuickBooksOAuthOptions } from '../../types.js';
 /** Create a public QuickBooks connection helper backed by Intuit's OAuth client. */
 export declare function createQuickBooksOAuthClient(options: QuickBooksOAuthOptions): Promise<QuickBooksOAuthClient>;
 //# sourceMappingURL=oauth.d.ts.map

package/dist/providers/stripe/index.d.ts

@@ -1,4 +1,11 @@
-import { AuditOperations, BillOperations, CustomerOperations, InvoiceOperations, PaymentOperations, StripeAccountingProvider, StripeBillingOperations, StripeOptions, VendorOperations, WebhookOperations } from '../../types.js';
+/**
+ * Stripe Provider
+ *
+ * Implements Stripe AR, payment, webhook, and billing operations using the
+ * Stripe HTTP API directly. The SDK keeps Stripe as an optional runtime
+ * dependency by relying on the platform fetch implementation.
+ */
+import type { AuditOperations, BillOperations, CustomerOperations, InvoiceOperations, PaymentOperations, StripeAccountingProvider, StripeBillingOperations, StripeOptions, VendorOperations, WebhookOperations } from '../../types.js';
 type StripePrimitive = string | number | boolean | Date | null | undefined;
 type StripeFormValue = StripePrimitive | StripeFormValue[] | {
     [key: string]: StripeFormValue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/accounting",
-  "version": "0.101.3",
+  "version": "0.102.1",
   "description": "Multi-provider accounting integration for AR/AP sync and audit with QuickBooks, Stripe, and more",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,7 +36,7 @@
   "homepage": "https://github.com/happyvertical/sdk/tree/main/packages/accounting#readme",
   "license": "MIT",
   "dependencies": {
-    "@happyvertical/utils": "0.101.3",
+    "@happyvertical/utils": "0.102.1",
     "intuit-oauth": "^4.2.3"
   },
   "devDependencies": {