@dotdo/do 0.1.0

package/dist/do/business/financial/reports.js

@@ -0,0 +1,347 @@
+/**
+ * Financial Reports
+ *
+ * Generates standard financial statements:
+ * - Profit & Loss (Income Statement)
+ * - Balance Sheet
+ * - Cash Flow Statement
+ *
+ * @module financial/reports
+ */
+/**
+ * Financial statement generator for Digital Objects
+ *
+ * Generates standard financial reports from the accounting journal
+ * including P&L, Balance Sheet, and Cash Flow Statement.
+ *
+ * @example
+ * ```typescript
+ * const reporter = new FinancialReporter({ journal })
+ *
+ * // Generate P&L for last month
+ * const pnl = await reporter.generateProfitAndLoss({
+ *   start: startOfMonth,
+ *   end: endOfMonth,
+ *   label: 'January 2024'
+ * })
+ *
+ * // Generate balance sheet as of today
+ * const balance = await reporter.generateBalanceSheet(Date.now())
+ * ```
+ */
+export class FinancialReporter {
+    config;
+    /**
+     * Create a new FinancialReporter instance
+     *
+     * @param config - Financial reporter configuration
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    // =========================================================================
+    // Profit & Loss Statement
+    // =========================================================================
+    /**
+     * Generate a Profit & Loss (Income) Statement
+     *
+     * @param period - Report period
+     * @param options - Report options
+     * @returns The P&L statement
+     *
+     * @example
+     * ```typescript
+     * const pnl = await reporter.generateProfitAndLoss({
+     *   start: new Date('2024-01-01').getTime(),
+     *   end: new Date('2024-01-31').getTime(),
+     *   label: 'January 2024'
+     * })
+     *
+     * console.log('Net Income:', pnl.netIncome)
+     * console.log('Gross Margin:', pnl.grossProfit / pnl.revenue.total)
+     * ```
+     */
+    async generateProfitAndLoss(period, options) {
+        // TODO: Implement P&L generation
+        throw new Error('Not implemented');
+    }
+    /**
+     * Generate a comparative P&L with period-over-period analysis
+     *
+     * @param currentPeriod - Current report period
+     * @param previousPeriod - Previous period for comparison
+     * @param options - Report options
+     * @returns Comparative P&L
+     */
+    async generateComparativeProfitAndLoss(currentPeriod, previousPeriod, options) {
+        // TODO: Implement comparative P&L
+        throw new Error('Not implemented');
+    }
+    /**
+     * Build a P&L section from account balances
+     *
+     * @param category - Account category for the section
+     * @param period - Report period
+     * @param name - Section name
+     * @returns The P&L section
+     */
+    async buildPLSection(category, period, name) {
+        // TODO: Implement section building
+        throw new Error('Not implemented');
+    }
+    // =========================================================================
+    // Balance Sheet
+    // =========================================================================
+    /**
+     * Generate a Balance Sheet
+     *
+     * @param asOf - Point-in-time for the balance sheet
+     * @param options - Report options
+     * @returns The balance sheet
+     *
+     * @example
+     * ```typescript
+     * const balance = await reporter.generateBalanceSheet(Date.now())
+     *
+     * console.log('Total Assets:', balance.totalAssets)
+     * console.log('Total Liabilities:', balance.totalLiabilities)
+     * console.log('Total Equity:', balance.totalEquity)
+     *
+     * // Verify accounting equation
+     * const isBalanced = balance.totalAssets ===
+     *   balance.totalLiabilities + balance.totalEquity
+     * ```
+     */
+    async generateBalanceSheet(asOf, options) {
+        // TODO: Implement balance sheet generation
+        throw new Error('Not implemented');
+    }
+    /**
+     * Generate a comparative balance sheet
+     *
+     * @param currentDate - Current balance sheet date
+     * @param previousDate - Previous date for comparison
+     * @param options - Report options
+     * @returns Comparative balance sheet
+     */
+    async generateComparativeBalanceSheet(currentDate, previousDate, options) {
+        // TODO: Implement comparative balance sheet
+        throw new Error('Not implemented');
+    }
+    /**
+     * Build a balance sheet section from accounts
+     *
+     * @param category - Account category
+     * @param asOf - Point-in-time
+     * @param name - Section name
+     * @returns The balance sheet section
+     */
+    async buildBalanceSheetSection(category, asOf, name) {
+        // TODO: Implement section building
+        throw new Error('Not implemented');
+    }
+    /**
+     * Verify that the balance sheet balances
+     *
+     * @param balanceSheet - Balance sheet to verify
+     * @returns True if assets = liabilities + equity
+     */
+    verifyBalanceSheet(balanceSheet) {
+        const tolerance = 0.01; // Allow for small rounding differences
+        const difference = Math.abs(balanceSheet.totalAssets -
+            (balanceSheet.totalLiabilities + balanceSheet.totalEquity));
+        return difference <= tolerance;
+    }
+    // =========================================================================
+    // Cash Flow Statement
+    // =========================================================================
+    /**
+     * Generate a Cash Flow Statement
+     *
+     * Uses the indirect method, starting with net income and
+     * adjusting for non-cash items and working capital changes.
+     *
+     * @param period - Report period
+     * @param options - Report options
+     * @returns The cash flow statement
+     *
+     * @example
+     * ```typescript
+     * const cashFlow = await reporter.generateCashFlow({
+     *   start: startOfMonth,
+     *   end: endOfMonth
+     * })
+     *
+     * console.log('Net Cash from Operations:', cashFlow.operatingActivities.total)
+     * console.log('Ending Cash:', cashFlow.endingCash)
+     * ```
+     */
+    async generateCashFlow(period, options) {
+        // TODO: Implement cash flow generation
+        throw new Error('Not implemented');
+    }
+    /**
+     * Generate a comparative cash flow statement
+     *
+     * @param currentPeriod - Current report period
+     * @param previousPeriod - Previous period for comparison
+     * @param options - Report options
+     * @returns Comparative cash flow statement
+     */
+    async generateComparativeCashFlow(currentPeriod, previousPeriod, options) {
+        // TODO: Implement comparative cash flow
+        throw new Error('Not implemented');
+    }
+    /**
+     * Build operating activities section
+     *
+     * @param period - Report period
+     * @returns Operating activities section
+     */
+    async buildOperatingActivities(period) {
+        // TODO: Implement operating activities
+        throw new Error('Not implemented');
+    }
+    /**
+     * Build investing activities section
+     *
+     * @param period - Report period
+     * @returns Investing activities section
+     */
+    async buildInvestingActivities(period) {
+        // TODO: Implement investing activities
+        throw new Error('Not implemented');
+    }
+    /**
+     * Build financing activities section
+     *
+     * @param period - Report period
+     * @returns Financing activities section
+     */
+    async buildFinancingActivities(period) {
+        // TODO: Implement financing activities
+        throw new Error('Not implemented');
+    }
+    // =========================================================================
+    // Utility Methods
+    // =========================================================================
+    /**
+     * Get fiscal year dates
+     *
+     * @param year - Calendar year
+     * @returns Start and end timestamps for the fiscal year
+     */
+    getFiscalYear(year) {
+        const startMonth = this.config.fiscalYearStartMonth || 1;
+        const start = new Date(year, startMonth - 1, 1).getTime();
+        const end = new Date(year + 1, startMonth - 1, 0, 23, 59, 59, 999).getTime();
+        return {
+            start,
+            end,
+            label: `FY ${year}`,
+        };
+    }
+    /**
+     * Get fiscal quarter dates
+     *
+     * @param year - Calendar year
+     * @param quarter - Quarter (1-4)
+     * @returns Start and end timestamps for the quarter
+     */
+    getFiscalQuarter(year, quarter) {
+        const startMonth = this.config.fiscalYearStartMonth || 1;
+        const quarterStartMonth = startMonth + (quarter - 1) * 3 - 1;
+        const start = new Date(year, quarterStartMonth, 1).getTime();
+        const end = new Date(year, quarterStartMonth + 3, 0, 23, 59, 59, 999).getTime();
+        return {
+            start,
+            end,
+            label: `Q${quarter} FY ${year}`,
+        };
+    }
+    /**
+     * Get calendar month dates
+     *
+     * @param year - Calendar year
+     * @param month - Month (1-12)
+     * @returns Start and end timestamps for the month
+     */
+    getMonth(year, month) {
+        const start = new Date(year, month - 1, 1).getTime();
+        const end = new Date(year, month, 0, 23, 59, 59, 999).getTime();
+        const monthNames = [
+            'January', 'February', 'March', 'April', 'May', 'June',
+            'July', 'August', 'September', 'October', 'November', 'December',
+        ];
+        return {
+            start,
+            end,
+            label: `${monthNames[month - 1]} ${year}`,
+        };
+    }
+    /**
+     * Format a currency amount
+     *
+     * @param amount - Amount in smallest currency unit
+     * @param currency - Currency code
+     * @returns Formatted string
+     */
+    formatCurrency(amount, currency) {
+        const curr = currency || this.config.defaultCurrency || 'USD';
+        const formatted = (amount / 100).toLocaleString('en-US', {
+            style: 'currency',
+            currency: curr,
+        });
+        return formatted;
+    }
+    /**
+     * Calculate percentage change
+     *
+     * @param current - Current value
+     * @param previous - Previous value
+     * @returns Percentage change
+     */
+    calculatePercentageChange(current, previous) {
+        if (previous === 0) {
+            return current === 0 ? 0 : 100;
+        }
+        return ((current - previous) / Math.abs(previous)) * 100;
+    }
+    /**
+     * Generate all standard reports for a period
+     *
+     * @param period - Report period
+     * @returns All financial reports
+     */
+    async generateAllReports(period) {
+        const [profitAndLoss, balanceSheet, cashFlow] = await Promise.all([
+            this.generateProfitAndLoss(period),
+            this.generateBalanceSheet(period.end),
+            this.generateCashFlow(period),
+        ]);
+        return { profitAndLoss, balanceSheet, cashFlow };
+    }
+}
+/**
+ * Report error codes
+ */
+export const ReportErrorCodes = {
+    INVALID_PERIOD: 'INVALID_PERIOD',
+    NO_DATA: 'NO_DATA',
+    BALANCE_MISMATCH: 'BALANCE_MISMATCH',
+    MISSING_ACCOUNTS: 'MISSING_ACCOUNTS',
+};
+/**
+ * Report error
+ */
+export class ReportError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'ReportError';
+    }
+}
+//# sourceMappingURL=reports.js.map

package/dist/do/business/financial/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../../../do/business/financial/reports.ts"],"names":[],"mappings":"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"}

package/dist/do/business/financial/stripe.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Stripe Connect Integration
+ *
+ * Provides Stripe Connect functionality for multi-party payments:
+ * - Account creation (Standard, Express, Custom)
+ * - Onboarding flow management
+ * - Capability monitoring
+ * - Bank account management
+ *
+ * @module financial/stripe
+ */
+import type { StripeConnectAccount, StripeAccountType, StripeCapabilities, BankAccount } from '../../../types/financial';
+import type { DigitalObjectRef } from '../../../types/identity';
+/**
+ * Configuration for Stripe Connect
+ */
+export interface StripeConnectConfig {
+    /** Stripe secret API key */
+    secretKey: string;
+    /** Webhook signing secret */
+    webhookSecret?: string;
+    /** Default account type for new accounts */
+    defaultAccountType?: StripeAccountType;
+    /** Platform country */
+    platformCountry?: string;
+}
+/**
+ * Options for creating a Connect account
+ */
+export interface CreateAccountOptions {
+    /** Business profile information */
+    businessProfile?: {
+        name?: string;
+        url?: string;
+        supportEmail?: string;
+        supportPhone?: string;
+        mcc?: string;
+    };
+    /** Requested capabilities */
+    capabilities?: (keyof StripeCapabilities)[];
+    /** Account metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Options for creating an account link
+ */
+export interface AccountLinkOptions {
+    /** Type of account link */
+    type?: 'account_onboarding' | 'account_update';
+    /** Collect additional information */
+    collect?: 'currently_due' | 'eventually_due';
+}
+/**
+ * Stripe Connect manager for Digital Objects
+ *
+ * Handles Stripe Connect account lifecycle including creation,
+ * onboarding, and capability management.
+ *
+ * @example
+ * ```typescript
+ * const connect = new StripeConnect({ secretKey: env.STRIPE_SECRET_KEY })
+ *
+ * // Create a new connected account
+ * const account = await connect.createAccount('express', businessRef, {
+ *   businessProfile: { name: 'Acme Corp' }
+ * })
+ *
+ * // Generate onboarding link
+ * const link = await connect.createAccountLink(
+ *   account.stripeAccountId,
+ *   'https://example.com/return',
+ *   'https://example.com/refresh'
+ * )
+ * ```
+ */
+export declare class StripeConnect {
+    private readonly config;
+    /**
+     * Create a new StripeConnect instance
+     *
+     * @param config - Stripe Connect configuration
+     */
+    constructor(config: StripeConnectConfig);
+    /**
+     * Create a new Stripe Connect account
+     *
+     * @param type - Account type (standard, express, or custom)
+     * @param businessRef - Reference to the Business DO
+     * @param options - Additional account options
+     * @returns The created Connect account
+     *
+     * @example
+     * ```typescript
+     * const account = await connect.createAccount('express', businessRef)
+     * console.log(account.stripeAccountId) // 'acct_xxx'
+     * ```
+     */
+    createAccount(type: StripeAccountType, businessRef: DigitalObjectRef, options?: CreateAccountOptions): Promise<StripeConnectAccount>;
+    /**
+     * Retrieve a Connect account by Stripe account ID
+     *
+     * @param stripeAccountId - The Stripe account ID (acct_xxx)
+     * @returns The Connect account or null if not found
+     */
+    getAccount(stripeAccountId: string): Promise<StripeConnectAccount | null>;
+    /**
+     * Update a Connect account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param updates - Fields to update
+     * @returns The updated account
+     */
+    updateAccount(stripeAccountId: string, updates: Partial<CreateAccountOptions>): Promise<StripeConnectAccount>;
+    /**
+     * Delete a Connect account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     */
+    deleteAccount(stripeAccountId: string): Promise<void>;
+    /**
+     * Create an account link for onboarding or updates
+     *
+     * Account links are single-use URLs that redirect the account holder
+     * to Stripe-hosted onboarding or account management.
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param returnUrl - URL to redirect after completion
+     * @param refreshUrl - URL to redirect if link expires
+     * @param options - Additional link options
+     * @returns The account link URL
+     *
+     * @example
+     * ```typescript
+     * const url = await connect.createAccountLink(
+     *   'acct_xxx',
+     *   'https://example.com/onboarding/complete',
+     *   'https://example.com/onboarding/refresh'
+     * )
+     * // Redirect user to url
+     * ```
+     */
+    createAccountLink(stripeAccountId: string, returnUrl: string, refreshUrl: string, options?: AccountLinkOptions): Promise<string>;
+    /**
+     * Create a login link for Express or Custom accounts
+     *
+     * Login links allow connected account holders to access their
+     * Stripe Express dashboard.
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns The login link URL
+     */
+    createLoginLink(stripeAccountId: string): Promise<string>;
+    /**
+     * Get account capabilities
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns Current capabilities and their status
+     */
+    getCapabilities(stripeAccountId: string): Promise<StripeCapabilities>;
+    /**
+     * Request additional capabilities for an account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param capabilities - Capabilities to request
+     */
+    requestCapabilities(stripeAccountId: string, capabilities: (keyof StripeCapabilities)[]): Promise<void>;
+    /**
+     * Add a bank account for payouts
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param bankAccountToken - Bank account token from Stripe.js
+     * @returns The created bank account
+     */
+    addBankAccount(stripeAccountId: string, bankAccountToken: string): Promise<BankAccount>;
+    /**
+     * List bank accounts for a Connect account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns List of bank accounts
+     */
+    listBankAccounts(stripeAccountId: string): Promise<BankAccount[]>;
+    /**
+     * Set the default bank account for payouts
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param bankAccountId - The bank account ID to set as default
+     */
+    setDefaultBankAccount(stripeAccountId: string, bankAccountId: string): Promise<void>;
+    /**
+     * Delete a bank account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param bankAccountId - The bank account ID to delete
+     */
+    deleteBankAccount(stripeAccountId: string, bankAccountId: string): Promise<void>;
+    /**
+     * Handle a Stripe webhook event
+     *
+     * Validates the webhook signature and processes account-related events.
+     *
+     * @param payload - Raw webhook payload
+     * @param signature - Stripe-Signature header value
+     * @returns Processed event data
+     *
+     * @example
+     * ```typescript
+     * app.post('/webhook', async (req, res) => {
+     *   const event = await connect.handleWebhook(
+     *     req.body,
+     *     req.headers['stripe-signature']
+     *   )
+     *   // Process event...
+     * })
+     * ```
+     */
+    handleWebhook(payload: string | ArrayBuffer, signature: string): Promise<{
+        type: string;
+        data: unknown;
+    }>;
+    /**
+     * Check if an account is fully onboarded and ready for charges
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns True if the account can accept charges
+     */
+    isReadyForCharges(stripeAccountId: string): Promise<boolean>;
+    /**
+     * Check if an account is ready for payouts
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns True if the account can receive payouts
+     */
+    isReadyForPayouts(stripeAccountId: string): Promise<boolean>;
+}
+/**
+ * Stripe Connect error codes
+ */
+export declare const StripeConnectErrorCodes: {
+    readonly ACCOUNT_NOT_FOUND: "ACCOUNT_NOT_FOUND";
+    readonly ONBOARDING_INCOMPLETE: "ONBOARDING_INCOMPLETE";
+    readonly CAPABILITY_NOT_AVAILABLE: "CAPABILITY_NOT_AVAILABLE";
+    readonly BANK_ACCOUNT_INVALID: "BANK_ACCOUNT_INVALID";
+    readonly WEBHOOK_SIGNATURE_INVALID: "WEBHOOK_SIGNATURE_INVALID";
+};
+export type StripeConnectErrorCode = typeof StripeConnectErrorCodes[keyof typeof StripeConnectErrorCodes];
+/**
+ * Stripe Connect error
+ */
+export declare class StripeConnectError extends Error {
+    readonly code: StripeConnectErrorCode;
+    readonly details?: unknown | undefined;
+    constructor(code: StripeConnectErrorCode, message: string, details?: unknown | undefined);
+}
+//# sourceMappingURL=stripe.d.ts.map

package/dist/do/business/financial/stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../../../do/business/financial/stripe.ts"],"names":[],"mappings":"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"}