digital-tools 2.0.2 → 2.1.1

package/src/entities/finance.js

@@ -0,0 +1,3478 @@
+/**
+ * Finance Entity Types (Nouns) - Stripe API Inspired
+ *
+ * Semantic type definitions for financial digital tools that can be used by
+ * both remote human workers AND AI agents. Each entity defines:
+ * - Properties: The data fields
+ * - Actions: Operations that can be performed (Verbs)
+ * - Events: State changes that occur
+ *
+ * Heavily influenced by Stripe's API structure and nomenclature.
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// CORE
+// =============================================================================
+/**
+ * Customer entity
+ *
+ * Represents a customer - person or business making purchases
+ */
+export const Customer = {
+    singular: 'customer',
+    plural: 'customers',
+    description: 'A person or business making purchases',
+    properties: {
+        // Identity
+        customerId: {
+            type: 'string',
+            description: 'Unique customer identifier',
+        },
+        email: {
+            type: 'string',
+            optional: true,
+            description: 'Customer email address',
+        },
+        phone: {
+            type: 'string',
+            optional: true,
+            description: 'Customer phone number',
+        },
+        // Name
+        name: {
+            type: 'string',
+            optional: true,
+            description: 'Customer full name',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Description of the customer',
+        },
+        // Address
+        address: {
+            type: 'json',
+            optional: true,
+            description: 'Customer address',
+        },
+        shippingAddress: {
+            type: 'json',
+            optional: true,
+            description: 'Shipping address',
+        },
+        // Balance & Credit
+        balance: {
+            type: 'number',
+            optional: true,
+            description: 'Current balance in cents (positive = customer owes, negative = credit)',
+        },
+        currency: {
+            type: 'string',
+            optional: true,
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Tax
+        taxExempt: {
+            type: 'string',
+            optional: true,
+            description: 'Tax exemption status: none, exempt, reverse',
+            examples: ['none', 'exempt', 'reverse'],
+        },
+        taxIds: {
+            type: 'json',
+            array: true,
+            optional: true,
+            description: 'Tax IDs for the customer',
+        },
+        // Preferences
+        preferredLocales: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Preferred locales',
+        },
+        invoicePrefix: {
+            type: 'string',
+            optional: true,
+            description: 'Prefix for invoice numbers',
+        },
+        // Status
+        delinquent: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether customer has overdue invoices',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the customer was created',
+        },
+    },
+    relationships: {
+        defaultPaymentMethod: {
+            type: 'PaymentMethod',
+            required: false,
+            description: 'Default payment method',
+        },
+        paymentMethods: {
+            type: 'PaymentMethod[]',
+            description: 'Payment methods on file',
+        },
+        invoices: {
+            type: 'Invoice[]',
+            backref: 'customer',
+            description: 'Customer invoices',
+        },
+        subscriptions: {
+            type: 'Subscription[]',
+            backref: 'customer',
+            description: 'Customer subscriptions',
+        },
+        charges: {
+            type: 'Charge[]',
+            description: 'Charges for this customer',
+        },
+        balanceTransactions: {
+            type: 'BalanceTransaction[]',
+            description: 'Balance transactions',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'list',
+        'retrieve',
+        'search',
+        'createBalanceTransaction',
+        'listBalanceTransactions',
+        'updateBalance',
+    ],
+    events: [
+        'customer.created',
+        'customer.updated',
+        'customer.deleted',
+        'customer.balance.updated',
+    ],
+};
+/**
+ * Product entity
+ *
+ * Represents goods or services for sale
+ */
+export const Product = {
+    singular: 'product',
+    plural: 'products',
+    description: 'Goods or services for sale',
+    properties: {
+        // Identity
+        productId: {
+            type: 'string',
+            description: 'Unique product identifier',
+        },
+        name: {
+            type: 'string',
+            description: 'Product name',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Product description',
+        },
+        // Status
+        active: {
+            type: 'boolean',
+            description: 'Whether product is available for purchase',
+        },
+        // Classification
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Product type: service or good',
+            examples: ['service', 'good'],
+        },
+        unitLabel: {
+            type: 'string',
+            optional: true,
+            description: 'Unit label (e.g., "per seat", "per GB")',
+        },
+        // Display
+        images: {
+            type: 'url',
+            array: true,
+            optional: true,
+            description: 'Product images',
+        },
+        url: {
+            type: 'url',
+            optional: true,
+            description: 'Product URL',
+        },
+        // Features
+        features: {
+            type: 'json',
+            array: true,
+            optional: true,
+            description: 'Product features',
+        },
+        // Tax
+        taxCode: {
+            type: 'string',
+            optional: true,
+            description: 'Tax code for product',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the product was created',
+        },
+        updated: {
+            type: 'datetime',
+            optional: true,
+            description: 'Time at which the product was last updated',
+        },
+    },
+    relationships: {
+        prices: {
+            type: 'Price[]',
+            backref: 'product',
+            description: 'Prices for this product',
+        },
+        defaultPrice: {
+            type: 'Price',
+            required: false,
+            description: 'Default price',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'list',
+        'retrieve',
+        'search',
+    ],
+    events: [
+        'product.created',
+        'product.updated',
+        'product.deleted',
+    ],
+};
+/**
+ * Price entity
+ *
+ * Represents pricing configuration (one-time or recurring)
+ */
+export const Price = {
+    singular: 'price',
+    plural: 'prices',
+    description: 'Pricing configuration for a product',
+    properties: {
+        // Identity
+        priceId: {
+            type: 'string',
+            description: 'Unique price identifier',
+        },
+        nickname: {
+            type: 'string',
+            optional: true,
+            description: 'Price nickname',
+        },
+        // Status
+        active: {
+            type: 'boolean',
+            description: 'Whether price is available for new purchases',
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Pricing type: one_time or recurring',
+            examples: ['one_time', 'recurring'],
+        },
+        // Amount
+        unitAmount: {
+            type: 'number',
+            optional: true,
+            description: 'Unit price in cents',
+        },
+        unitAmountDecimal: {
+            type: 'string',
+            optional: true,
+            description: 'Unit price as decimal string for precision',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Billing Scheme
+        billingScheme: {
+            type: 'string',
+            optional: true,
+            description: 'Billing scheme: per_unit or tiered',
+            examples: ['per_unit', 'tiered'],
+        },
+        tiers: {
+            type: 'json',
+            array: true,
+            optional: true,
+            description: 'Pricing tiers (for tiered billing)',
+        },
+        tiersMode: {
+            type: 'string',
+            optional: true,
+            description: 'Tiers mode: graduated or volume',
+            examples: ['graduated', 'volume'],
+        },
+        // Recurring Details
+        recurring: {
+            type: 'json',
+            optional: true,
+            description: 'Recurring pricing details (interval, interval_count, usage_type, aggregate_usage)',
+        },
+        // Transform Quantity
+        transformQuantity: {
+            type: 'json',
+            optional: true,
+            description: 'Transform quantity settings',
+        },
+        // Tax
+        taxBehavior: {
+            type: 'string',
+            optional: true,
+            description: 'Tax behavior: inclusive, exclusive, unspecified',
+            examples: ['inclusive', 'exclusive', 'unspecified'],
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the price was created',
+        },
+    },
+    relationships: {
+        product: {
+            type: 'Product',
+            backref: 'prices',
+            description: 'Product this price belongs to',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'list',
+        'retrieve',
+        'search',
+    ],
+    events: [
+        'price.created',
+        'price.updated',
+        'price.deleted',
+    ],
+};
+// =============================================================================
+// PAYMENTS
+// =============================================================================
+/**
+ * PaymentMethod entity
+ *
+ * Represents a payment method (card, bank account, etc.)
+ */
+export const PaymentMethod = {
+    singular: 'payment method',
+    plural: 'payment methods',
+    description: 'A payment method such as card or bank account',
+    properties: {
+        // Identity
+        paymentMethodId: {
+            type: 'string',
+            description: 'Unique payment method identifier',
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Payment method type: card, us_bank_account, sepa_debit, etc.',
+            examples: ['card', 'us_bank_account', 'sepa_debit', 'acss_debit', 'alipay', 'wechat_pay'],
+        },
+        // Card Details
+        card: {
+            type: 'json',
+            optional: true,
+            description: 'Card details (brand, last4, exp_month, exp_year, etc.)',
+        },
+        // Bank Account Details
+        usBankAccount: {
+            type: 'json',
+            optional: true,
+            description: 'US bank account details',
+        },
+        sepaDebit: {
+            type: 'json',
+            optional: true,
+            description: 'SEPA debit details',
+        },
+        // Billing Details
+        billingDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Billing details (name, email, phone, address)',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the payment method was created',
+        },
+    },
+    relationships: {
+        customer: {
+            type: 'Customer',
+            required: false,
+            description: 'Customer this payment method belongs to',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'attach',
+        'detach',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'payment_method.attached',
+        'payment_method.detached',
+        'payment_method.updated',
+        'payment_method.automatically_updated',
+    ],
+};
+/**
+ * PaymentIntent entity
+ *
+ * Represents an intent to collect payment
+ */
+export const PaymentIntent = {
+    singular: 'payment intent',
+    plural: 'payment intents',
+    description: 'An intent to collect payment from a customer',
+    properties: {
+        // Identity
+        paymentIntentId: {
+            type: 'string',
+            description: 'Unique payment intent identifier',
+        },
+        clientSecret: {
+            type: 'string',
+            optional: true,
+            description: 'Client secret for completing payment',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Amount in cents',
+        },
+        amountCapturable: {
+            type: 'number',
+            optional: true,
+            description: 'Amount capturable in cents',
+        },
+        amountReceived: {
+            type: 'number',
+            optional: true,
+            description: 'Amount received in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: requires_payment_method, requires_confirmation, requires_action, processing, succeeded, canceled',
+            examples: ['requires_payment_method', 'requires_confirmation', 'requires_action', 'processing', 'succeeded', 'canceled'],
+        },
+        cancellationReason: {
+            type: 'string',
+            optional: true,
+            description: 'Cancellation reason',
+        },
+        // Capture
+        captureMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Capture method: automatic or manual',
+            examples: ['automatic', 'manual'],
+        },
+        // Confirmation
+        confirmationMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Confirmation method: automatic or manual',
+            examples: ['automatic', 'manual'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Description of payment',
+        },
+        statementDescriptor: {
+            type: 'string',
+            optional: true,
+            description: 'Statement descriptor',
+        },
+        // Receipt
+        receiptEmail: {
+            type: 'string',
+            optional: true,
+            description: 'Email to send receipt to',
+        },
+        // Setup Future Usage
+        setupFutureUsage: {
+            type: 'string',
+            optional: true,
+            description: 'Setup for future usage: on_session or off_session',
+            examples: ['on_session', 'off_session'],
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the payment intent was created',
+        },
+        canceledAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Time at which the payment intent was canceled',
+        },
+    },
+    relationships: {
+        customer: {
+            type: 'Customer',
+            required: false,
+            description: 'Customer making the payment',
+        },
+        paymentMethod: {
+            type: 'PaymentMethod',
+            required: false,
+            description: 'Payment method used',
+        },
+        invoice: {
+            type: 'Invoice',
+            required: false,
+            description: 'Invoice this payment is for',
+        },
+        charges: {
+            type: 'Charge[]',
+            description: 'Charges created by this payment intent',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'confirm',
+        'capture',
+        'cancel',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'payment_intent.created',
+        'payment_intent.succeeded',
+        'payment_intent.canceled',
+        'payment_intent.processing',
+        'payment_intent.payment_failed',
+        'payment_intent.amount_capturable_updated',
+    ],
+};
+/**
+ * Charge entity
+ *
+ * Represents a charge attempt
+ */
+export const Charge = {
+    singular: 'charge',
+    plural: 'charges',
+    description: 'A charge attempt on a payment source',
+    properties: {
+        // Identity
+        chargeId: {
+            type: 'string',
+            description: 'Unique charge identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Amount charged in cents',
+        },
+        amountCaptured: {
+            type: 'number',
+            optional: true,
+            description: 'Amount captured in cents',
+        },
+        amountRefunded: {
+            type: 'number',
+            optional: true,
+            description: 'Amount refunded in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: succeeded, pending, failed',
+            examples: ['succeeded', 'pending', 'failed'],
+        },
+        paid: {
+            type: 'boolean',
+            description: 'Whether charge was paid',
+        },
+        refunded: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether charge was refunded',
+        },
+        captured: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether charge was captured',
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Charge description',
+        },
+        statementDescriptor: {
+            type: 'string',
+            optional: true,
+            description: 'Statement descriptor',
+        },
+        // Receipt
+        receiptEmail: {
+            type: 'string',
+            optional: true,
+            description: 'Email receipt was sent to',
+        },
+        receiptNumber: {
+            type: 'string',
+            optional: true,
+            description: 'Receipt number',
+        },
+        receiptUrl: {
+            type: 'url',
+            optional: true,
+            description: 'Receipt URL',
+        },
+        // Failure
+        failureCode: {
+            type: 'string',
+            optional: true,
+            description: 'Failure code',
+        },
+        failureMessage: {
+            type: 'string',
+            optional: true,
+            description: 'Failure message',
+        },
+        // Payment Details
+        paymentMethodDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Payment method details',
+        },
+        // Fraud Detection
+        fraudDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Fraud detection details',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the charge was created',
+        },
+    },
+    relationships: {
+        customer: {
+            type: 'Customer',
+            required: false,
+            description: 'Customer charged',
+        },
+        paymentIntent: {
+            type: 'PaymentIntent',
+            required: false,
+            description: 'Payment intent that created this charge',
+        },
+        paymentMethod: {
+            type: 'PaymentMethod',
+            required: false,
+            description: 'Payment method used',
+        },
+        invoice: {
+            type: 'Invoice',
+            required: false,
+            description: 'Invoice this charge is for',
+        },
+        refunds: {
+            type: 'Refund[]',
+            backref: 'charge',
+            description: 'Refunds for this charge',
+        },
+        balanceTransaction: {
+            type: 'BalanceTransaction',
+            required: false,
+            description: 'Balance transaction',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'capture',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'charge.succeeded',
+        'charge.failed',
+        'charge.pending',
+        'charge.captured',
+        'charge.updated',
+        'charge.refunded',
+        'charge.dispute.created',
+        'charge.dispute.updated',
+        'charge.dispute.closed',
+    ],
+};
+/**
+ * Refund entity
+ *
+ * Represents a refund of a charge
+ */
+export const Refund = {
+    singular: 'refund',
+    plural: 'refunds',
+    description: 'A refund of a charge',
+    properties: {
+        // Identity
+        refundId: {
+            type: 'string',
+            description: 'Unique refund identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Amount refunded in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Status: succeeded, failed, pending, canceled',
+            examples: ['succeeded', 'failed', 'pending', 'canceled'],
+        },
+        // Reason
+        reason: {
+            type: 'string',
+            optional: true,
+            description: 'Reason: duplicate, fraudulent, requested_by_customer',
+            examples: ['duplicate', 'fraudulent', 'requested_by_customer'],
+        },
+        // Receipt
+        receiptNumber: {
+            type: 'string',
+            optional: true,
+            description: 'Receipt number',
+        },
+        // Failure
+        failureReason: {
+            type: 'string',
+            optional: true,
+            description: 'Failure reason',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the refund was created',
+        },
+    },
+    relationships: {
+        charge: {
+            type: 'Charge',
+            backref: 'refunds',
+            description: 'Charge that was refunded',
+        },
+        paymentIntent: {
+            type: 'PaymentIntent',
+            required: false,
+            description: 'Payment intent that was refunded',
+        },
+        balanceTransaction: {
+            type: 'BalanceTransaction',
+            required: false,
+            description: 'Balance transaction',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'cancel',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'charge.refund.updated',
+    ],
+};
+// =============================================================================
+// BILLING
+// =============================================================================
+/**
+ * Invoice entity
+ *
+ * Represents a statement of amounts owed
+ */
+export const Invoice = {
+    singular: 'invoice',
+    plural: 'invoices',
+    description: 'A statement of amounts owed by a customer',
+    properties: {
+        // Identity
+        invoiceId: {
+            type: 'string',
+            description: 'Unique invoice identifier',
+        },
+        number: {
+            type: 'string',
+            optional: true,
+            description: 'Invoice number',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Status: draft, open, paid, void, uncollectible',
+            examples: ['draft', 'open', 'paid', 'void', 'uncollectible'],
+        },
+        // Amount
+        amountDue: {
+            type: 'number',
+            optional: true,
+            description: 'Amount due in cents',
+        },
+        amountPaid: {
+            type: 'number',
+            optional: true,
+            description: 'Amount paid in cents',
+        },
+        amountRemaining: {
+            type: 'number',
+            optional: true,
+            description: 'Amount remaining in cents',
+        },
+        subtotal: {
+            type: 'number',
+            optional: true,
+            description: 'Subtotal before discounts and tax',
+        },
+        total: {
+            type: 'number',
+            optional: true,
+            description: 'Total amount',
+        },
+        tax: {
+            type: 'number',
+            optional: true,
+            description: 'Tax amount',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Invoice description',
+        },
+        footer: {
+            type: 'string',
+            optional: true,
+            description: 'Invoice footer',
+        },
+        // Collection
+        collectionMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Collection method: charge_automatically or send_invoice',
+            examples: ['charge_automatically', 'send_invoice'],
+        },
+        attemptCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of payment attempts',
+        },
+        attempted: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether payment was attempted',
+        },
+        // Dates
+        created: {
+            type: 'datetime',
+            description: 'Time at which the invoice was created',
+        },
+        dueDate: {
+            type: 'datetime',
+            optional: true,
+            description: 'Date payment is due',
+        },
+        periodStart: {
+            type: 'datetime',
+            optional: true,
+            description: 'Start of billing period',
+        },
+        periodEnd: {
+            type: 'datetime',
+            optional: true,
+            description: 'End of billing period',
+        },
+        // Payment
+        paid: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether invoice has been paid',
+        },
+        paidAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Time at which payment occurred',
+        },
+        // Invoice PDF
+        invoicePdf: {
+            type: 'url',
+            optional: true,
+            description: 'URL to invoice PDF',
+        },
+        hostedInvoiceUrl: {
+            type: 'url',
+            optional: true,
+            description: 'URL to hosted invoice page',
+        },
+        // Auto Advance
+        autoAdvance: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether to auto-finalize draft after period end',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+    },
+    relationships: {
+        customer: {
+            type: 'Customer',
+            backref: 'invoices',
+            description: 'Customer being invoiced',
+        },
+        subscription: {
+            type: 'Subscription',
+            required: false,
+            description: 'Subscription this invoice is for',
+        },
+        lines: {
+            type: 'InvoiceLineItem[]',
+            backref: 'invoice',
+            description: 'Line items',
+        },
+        charge: {
+            type: 'Charge',
+            required: false,
+            description: 'Latest charge for this invoice',
+        },
+        paymentIntent: {
+            type: 'PaymentIntent',
+            required: false,
+            description: 'Payment intent for this invoice',
+        },
+        defaultPaymentMethod: {
+            type: 'PaymentMethod',
+            required: false,
+            description: 'Default payment method',
+        },
+        quote: {
+            type: 'Quote',
+            required: false,
+            description: 'Quote this invoice was created from',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'finalize',
+        'pay',
+        'send',
+        'voidInvoice',
+        'markUncollectible',
+        'list',
+        'retrieve',
+        'upcomingInvoice',
+    ],
+    events: [
+        'invoice.created',
+        'invoice.updated',
+        'invoice.deleted',
+        'invoice.finalized',
+        'invoice.paid',
+        'invoice.payment_failed',
+        'invoice.payment_action_required',
+        'invoice.sent',
+        'invoice.voided',
+        'invoice.marked_uncollectible',
+    ],
+};
+/**
+ * InvoiceLineItem entity
+ *
+ * Represents a line item on an invoice
+ */
+export const InvoiceLineItem = {
+    singular: 'invoice line item',
+    plural: 'invoice line items',
+    description: 'A line item on an invoice',
+    properties: {
+        // Identity
+        lineItemId: {
+            type: 'string',
+            description: 'Unique line item identifier',
+        },
+        // Type
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Type: invoiceitem or subscription',
+            examples: ['invoiceitem', 'subscription'],
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Line item description',
+        },
+        // Quantity
+        quantity: {
+            type: 'number',
+            optional: true,
+            description: 'Quantity',
+        },
+        // Unit Amount
+        unitAmount: {
+            type: 'number',
+            optional: true,
+            description: 'Unit amount in cents',
+        },
+        unitAmountExcludingTax: {
+            type: 'number',
+            optional: true,
+            description: 'Unit amount excluding tax',
+        },
+        // Period
+        period: {
+            type: 'json',
+            optional: true,
+            description: 'Period this line item covers',
+        },
+        // Proration
+        proration: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether this is a proration',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+    },
+    relationships: {
+        invoice: {
+            type: 'Invoice',
+            backref: 'lines',
+            description: 'Invoice this line item belongs to',
+        },
+        price: {
+            type: 'Price',
+            required: false,
+            description: 'Price for this line item',
+        },
+        subscription: {
+            type: 'Subscription',
+            required: false,
+            description: 'Subscription this line item is for',
+        },
+        subscriptionItem: {
+            type: 'SubscriptionItem',
+            required: false,
+            description: 'Subscription item',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'list',
+        'retrieve',
+    ],
+    events: [],
+};
+/**
+ * Subscription entity
+ *
+ * Represents a recurring payment arrangement
+ */
+export const Subscription = {
+    singular: 'subscription',
+    plural: 'subscriptions',
+    description: 'A recurring payment arrangement',
+    properties: {
+        // Identity
+        subscriptionId: {
+            type: 'string',
+            description: 'Unique subscription identifier',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, paused',
+            examples: ['incomplete', 'incomplete_expired', 'trialing', 'active', 'past_due', 'canceled', 'unpaid', 'paused'],
+        },
+        // Collection
+        collectionMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Collection method: charge_automatically or send_invoice',
+            examples: ['charge_automatically', 'send_invoice'],
+        },
+        // Billing
+        billingCycleAnchor: {
+            type: 'datetime',
+            optional: true,
+            description: 'Billing cycle anchor',
+        },
+        currentPeriodStart: {
+            type: 'datetime',
+            optional: true,
+            description: 'Start of current period',
+        },
+        currentPeriodEnd: {
+            type: 'datetime',
+            optional: true,
+            description: 'End of current period',
+        },
+        // Cancellation
+        cancelAtPeriodEnd: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether to cancel at period end',
+        },
+        canceledAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Time subscription was canceled',
+        },
+        cancelAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Time to cancel subscription',
+        },
+        // Trial
+        trialStart: {
+            type: 'datetime',
+            optional: true,
+            description: 'Start of trial period',
+        },
+        trialEnd: {
+            type: 'datetime',
+            optional: true,
+            description: 'End of trial period',
+        },
+        // Dates
+        created: {
+            type: 'datetime',
+            description: 'Time at which the subscription was created',
+        },
+        startDate: {
+            type: 'datetime',
+            optional: true,
+            description: 'Subscription start date',
+        },
+        endedAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Time subscription ended',
+        },
+        // Days Until Due
+        daysUntilDue: {
+            type: 'number',
+            optional: true,
+            description: 'Days until payment is due',
+        },
+        // Discount
+        discount: {
+            type: 'json',
+            optional: true,
+            description: 'Discount applied to subscription',
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Subscription description',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+    },
+    relationships: {
+        customer: {
+            type: 'Customer',
+            backref: 'subscriptions',
+            description: 'Customer subscribed',
+        },
+        items: {
+            type: 'SubscriptionItem[]',
+            backref: 'subscription',
+            description: 'Subscription items',
+        },
+        defaultPaymentMethod: {
+            type: 'PaymentMethod',
+            required: false,
+            description: 'Default payment method',
+        },
+        latestInvoice: {
+            type: 'Invoice',
+            required: false,
+            description: 'Latest invoice',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'cancel',
+        'resume',
+        'pause',
+        'list',
+        'retrieve',
+        'search',
+    ],
+    events: [
+        'customer.subscription.created',
+        'customer.subscription.updated',
+        'customer.subscription.deleted',
+        'customer.subscription.paused',
+        'customer.subscription.resumed',
+        'customer.subscription.trial_will_end',
+    ],
+};
+/**
+ * SubscriptionItem entity
+ *
+ * Represents an item in a subscription
+ */
+export const SubscriptionItem = {
+    singular: 'subscription item',
+    plural: 'subscription items',
+    description: 'An item in a subscription',
+    properties: {
+        // Identity
+        subscriptionItemId: {
+            type: 'string',
+            description: 'Unique subscription item identifier',
+        },
+        // Billing Thresholds
+        billingThresholds: {
+            type: 'json',
+            optional: true,
+            description: 'Billing thresholds',
+        },
+        // Quantity
+        quantity: {
+            type: 'number',
+            optional: true,
+            description: 'Quantity',
+        },
+        // Tax Rates
+        taxRates: {
+            type: 'json',
+            array: true,
+            optional: true,
+            description: 'Tax rates',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the subscription item was created',
+        },
+    },
+    relationships: {
+        subscription: {
+            type: 'Subscription',
+            backref: 'items',
+            description: 'Subscription this item belongs to',
+        },
+        price: {
+            type: 'Price',
+            description: 'Price for this item',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'list',
+        'retrieve',
+    ],
+    events: [],
+};
+/**
+ * Quote entity
+ *
+ * Represents proposed pricing for a customer
+ */
+export const Quote = {
+    singular: 'quote',
+    plural: 'quotes',
+    description: 'Proposed pricing for a customer',
+    properties: {
+        // Identity
+        quoteId: {
+            type: 'string',
+            description: 'Unique quote identifier',
+        },
+        number: {
+            type: 'string',
+            optional: true,
+            description: 'Quote number',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: draft, open, accepted, canceled',
+            examples: ['draft', 'open', 'accepted', 'canceled'],
+        },
+        // Amount
+        amountSubtotal: {
+            type: 'number',
+            optional: true,
+            description: 'Subtotal amount in cents',
+        },
+        amountTotal: {
+            type: 'number',
+            optional: true,
+            description: 'Total amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Quote description',
+        },
+        header: {
+            type: 'string',
+            optional: true,
+            description: 'Quote header',
+        },
+        footer: {
+            type: 'string',
+            optional: true,
+            description: 'Quote footer',
+        },
+        // Expiration
+        expiresAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Quote expiration time',
+        },
+        // Collection
+        collectionMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Collection method: charge_automatically or send_invoice',
+            examples: ['charge_automatically', 'send_invoice'],
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the quote was created',
+        },
+    },
+    relationships: {
+        customer: {
+            type: 'Customer',
+            description: 'Customer being quoted',
+        },
+        invoice: {
+            type: 'Invoice',
+            required: false,
+            description: 'Invoice created from quote',
+        },
+        subscription: {
+            type: 'Subscription',
+            required: false,
+            description: 'Subscription created from quote',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'finalize',
+        'accept',
+        'cancel',
+        'list',
+        'retrieve',
+        'pdf',
+    ],
+    events: [
+        'quote.created',
+        'quote.finalized',
+        'quote.accepted',
+        'quote.canceled',
+    ],
+};
+// =============================================================================
+// BALANCE
+// =============================================================================
+/**
+ * Balance entity
+ *
+ * Represents the Stripe account balance
+ */
+export const Balance = {
+    singular: 'balance',
+    plural: 'balances',
+    description: 'The balance of a Stripe account',
+    properties: {
+        // Available
+        available: {
+            type: 'json',
+            array: true,
+            description: 'Available balance by currency',
+        },
+        // Pending
+        pending: {
+            type: 'json',
+            array: true,
+            description: 'Pending balance by currency',
+        },
+        // Livemode
+        livemode: {
+            type: 'boolean',
+            description: 'Whether in live mode',
+        },
+    },
+    relationships: {},
+    actions: [
+        'retrieve',
+    ],
+    events: [],
+};
+/**
+ * BalanceTransaction entity
+ *
+ * Represents a transaction affecting the account balance
+ */
+export const BalanceTransaction = {
+    singular: 'balance transaction',
+    plural: 'balance transactions',
+    description: 'A transaction affecting the account balance',
+    properties: {
+        // Identity
+        balanceTransactionId: {
+            type: 'string',
+            description: 'Unique balance transaction identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Gross amount in cents',
+        },
+        net: {
+            type: 'number',
+            description: 'Net amount in cents',
+        },
+        fee: {
+            type: 'number',
+            optional: true,
+            description: 'Fee amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Transaction type: charge, refund, adjustment, application_fee, etc.',
+            examples: ['charge', 'refund', 'adjustment', 'application_fee', 'application_fee_refund', 'transfer', 'payment', 'payout'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Transaction description',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: available or pending',
+            examples: ['available', 'pending'],
+        },
+        // Reporting Category
+        reportingCategory: {
+            type: 'string',
+            optional: true,
+            description: 'Reporting category',
+        },
+        // Fee Details
+        feeDetails: {
+            type: 'json',
+            array: true,
+            optional: true,
+            description: 'Breakdown of fees',
+        },
+        // Dates
+        created: {
+            type: 'datetime',
+            description: 'Time at which the transaction was created',
+        },
+        availableOn: {
+            type: 'datetime',
+            optional: true,
+            description: 'Time funds become available',
+        },
+    },
+    relationships: {
+        source: {
+            type: 'json',
+            required: false,
+            description: 'Source object (Charge, Refund, Transfer, etc.)',
+        },
+    },
+    actions: [
+        'list',
+        'retrieve',
+    ],
+    events: [],
+};
+// =============================================================================
+// CONNECT (for platforms)
+// =============================================================================
+/**
+ * Account entity (Stripe Connect)
+ *
+ * Represents a connected Stripe account
+ */
+export const Account = {
+    singular: 'account',
+    plural: 'accounts',
+    description: 'A connected Stripe account',
+    properties: {
+        // Identity
+        accountId: {
+            type: 'string',
+            description: 'Unique account identifier',
+        },
+        email: {
+            type: 'string',
+            optional: true,
+            description: 'Account email',
+        },
+        // Type
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Account type: standard, express, custom',
+            examples: ['standard', 'express', 'custom'],
+        },
+        // Business
+        businessType: {
+            type: 'string',
+            optional: true,
+            description: 'Business type: individual, company, non_profit, government_entity',
+            examples: ['individual', 'company', 'non_profit', 'government_entity'],
+        },
+        businessProfile: {
+            type: 'json',
+            optional: true,
+            description: 'Business profile information',
+        },
+        company: {
+            type: 'json',
+            optional: true,
+            description: 'Company information',
+        },
+        individual: {
+            type: 'json',
+            optional: true,
+            description: 'Individual information',
+        },
+        // Capabilities
+        capabilities: {
+            type: 'json',
+            optional: true,
+            description: 'Account capabilities',
+        },
+        // Requirements
+        requirements: {
+            type: 'json',
+            optional: true,
+            description: 'Account requirements',
+        },
+        // Settings
+        settings: {
+            type: 'json',
+            optional: true,
+            description: 'Account settings',
+        },
+        // Charges
+        chargesEnabled: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether charges are enabled',
+        },
+        payoutsEnabled: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether payouts are enabled',
+        },
+        detailsSubmitted: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether account details have been submitted',
+        },
+        // Country
+        country: {
+            type: 'string',
+            optional: true,
+            description: 'Country code',
+        },
+        defaultCurrency: {
+            type: 'string',
+            optional: true,
+            description: 'Default currency',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the account was created',
+        },
+    },
+    relationships: {
+        externalAccounts: {
+            type: 'BankAccount[]',
+            description: 'External accounts (bank accounts, cards)',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'reject',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'account.updated',
+        'account.application.authorized',
+        'account.application.deauthorized',
+        'account.external_account.created',
+        'account.external_account.deleted',
+        'account.external_account.updated',
+    ],
+};
+/**
+ * AccountLink entity
+ *
+ * Represents an onboarding link for a connected account
+ */
+export const AccountLink = {
+    singular: 'account link',
+    plural: 'account links',
+    description: 'An onboarding link for a connected account',
+    properties: {
+        // URL
+        url: {
+            type: 'url',
+            description: 'URL for account onboarding',
+        },
+        // Expiration
+        expiresAt: {
+            type: 'datetime',
+            description: 'Time at which the link expires',
+        },
+        // Created
+        created: {
+            type: 'datetime',
+            description: 'Time at which the link was created',
+        },
+    },
+    relationships: {
+        account: {
+            type: 'Account',
+            description: 'Account this link is for',
+        },
+    },
+    actions: [
+        'create',
+    ],
+    events: [],
+};
+/**
+ * Transfer entity
+ *
+ * Represents a transfer to a connected account
+ */
+export const Transfer = {
+    singular: 'transfer',
+    plural: 'transfers',
+    description: 'A transfer to a connected Stripe account',
+    properties: {
+        // Identity
+        transferId: {
+            type: 'string',
+            description: 'Unique transfer identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Amount transferred in cents',
+        },
+        amountReversed: {
+            type: 'number',
+            optional: true,
+            description: 'Amount reversed in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Transfer description',
+        },
+        // Status
+        reversed: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether transfer has been reversed',
+        },
+        // Source Transaction
+        sourceType: {
+            type: 'string',
+            optional: true,
+            description: 'Source type: card, bank_account, etc.',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the transfer was created',
+        },
+    },
+    relationships: {
+        destination: {
+            type: 'Account',
+            description: 'Destination account',
+        },
+        sourceTransaction: {
+            type: 'Charge',
+            required: false,
+            description: 'Source transaction',
+        },
+        balanceTransaction: {
+            type: 'BalanceTransaction',
+            required: false,
+            description: 'Balance transaction',
+        },
+        reversals: {
+            type: 'json[]',
+            description: 'Transfer reversals',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'list',
+        'retrieve',
+        'reverse',
+    ],
+    events: [
+        'transfer.created',
+        'transfer.updated',
+        'transfer.reversed',
+    ],
+};
+/**
+ * Payout entity
+ *
+ * Represents a payout to an external account
+ */
+export const Payout = {
+    singular: 'payout',
+    plural: 'payouts',
+    description: 'A payout to an external bank account or debit card',
+    properties: {
+        // Identity
+        payoutId: {
+            type: 'string',
+            description: 'Unique payout identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Amount paid out in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: pending, paid, failed, canceled',
+            examples: ['pending', 'paid', 'failed', 'canceled'],
+        },
+        // Type
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Payout type: bank_account or card',
+            examples: ['bank_account', 'card'],
+        },
+        method: {
+            type: 'string',
+            optional: true,
+            description: 'Payout method: standard or instant',
+            examples: ['standard', 'instant'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Payout description',
+        },
+        statementDescriptor: {
+            type: 'string',
+            optional: true,
+            description: 'Statement descriptor',
+        },
+        // Failure
+        failureCode: {
+            type: 'string',
+            optional: true,
+            description: 'Failure code',
+        },
+        failureMessage: {
+            type: 'string',
+            optional: true,
+            description: 'Failure message',
+        },
+        // Dates
+        created: {
+            type: 'datetime',
+            description: 'Time at which the payout was created',
+        },
+        arrivalDate: {
+            type: 'datetime',
+            optional: true,
+            description: 'Expected arrival date',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+    },
+    relationships: {
+        destination: {
+            type: 'BankAccount',
+            required: false,
+            description: 'Destination bank account',
+        },
+        balanceTransaction: {
+            type: 'BalanceTransaction',
+            required: false,
+            description: 'Balance transaction',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'cancel',
+        'reverse',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'payout.created',
+        'payout.updated',
+        'payout.canceled',
+        'payout.failed',
+        'payout.paid',
+    ],
+};
+/**
+ * ApplicationFee entity
+ *
+ * Represents a platform fee on a charge
+ */
+export const ApplicationFee = {
+    singular: 'application fee',
+    plural: 'application fees',
+    description: 'A platform fee collected on a charge',
+    properties: {
+        // Identity
+        applicationFeeId: {
+            type: 'string',
+            description: 'Unique application fee identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Fee amount in cents',
+        },
+        amountRefunded: {
+            type: 'number',
+            optional: true,
+            description: 'Amount refunded in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Status
+        refunded: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether fee has been refunded',
+        },
+        // Livemode
+        livemode: {
+            type: 'boolean',
+            description: 'Whether in live mode',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the fee was created',
+        },
+    },
+    relationships: {
+        charge: {
+            type: 'Charge',
+            description: 'Charge this fee was collected on',
+        },
+        account: {
+            type: 'Account',
+            description: 'Connected account',
+        },
+        balanceTransaction: {
+            type: 'BalanceTransaction',
+            required: false,
+            description: 'Balance transaction',
+        },
+    },
+    actions: [
+        'list',
+        'retrieve',
+        'refund',
+    ],
+    events: [
+        'application_fee.created',
+        'application_fee.refunded',
+    ],
+};
+// =============================================================================
+// TREASURY (embedded banking)
+// =============================================================================
+/**
+ * FinancialAccount entity (Treasury)
+ *
+ * Represents a Treasury financial account
+ */
+export const FinancialAccount = {
+    singular: 'financial account',
+    plural: 'financial accounts',
+    description: 'A Treasury financial account for embedded banking',
+    properties: {
+        // Identity
+        financialAccountId: {
+            type: 'string',
+            description: 'Unique financial account identifier',
+        },
+        // Balance
+        balance: {
+            type: 'json',
+            description: 'Account balance',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: open or closed',
+            examples: ['open', 'closed'],
+        },
+        // Supported Currencies
+        supportedCurrencies: {
+            type: 'string',
+            array: true,
+            description: 'Supported currencies',
+        },
+        // Features
+        features: {
+            type: 'json',
+            optional: true,
+            description: 'Enabled features',
+        },
+        // Financial Addresses
+        financialAddresses: {
+            type: 'json',
+            array: true,
+            optional: true,
+            description: 'Financial addresses (e.g., ACH routing info)',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the account was created',
+        },
+    },
+    relationships: {},
+    actions: [
+        'create',
+        'update',
+        'retrieve',
+        'list',
+    ],
+    events: [
+        'treasury.financial_account.created',
+        'treasury.financial_account.closed',
+        'treasury.financial_account.features_status_updated',
+    ],
+};
+/**
+ * TreasuryTransaction entity
+ *
+ * Represents a transaction in a Treasury financial account
+ */
+export const TreasuryTransaction = {
+    singular: 'treasury transaction',
+    plural: 'treasury transactions',
+    description: 'A transaction in a Treasury financial account',
+    properties: {
+        // Identity
+        treasuryTransactionId: {
+            type: 'string',
+            description: 'Unique transaction identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Transaction amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Transaction description',
+        },
+        // Flow
+        flowType: {
+            type: 'string',
+            description: 'Flow type: inbound_transfer, outbound_transfer, outbound_payment, received_credit, received_debit',
+            examples: ['inbound_transfer', 'outbound_transfer', 'outbound_payment', 'received_credit', 'received_debit'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: open, posted, void',
+            examples: ['open', 'posted', 'void'],
+        },
+        // Balance Impact
+        balanceImpact: {
+            type: 'json',
+            optional: true,
+            description: 'Impact on balance',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the transaction was created',
+        },
+    },
+    relationships: {
+        financialAccount: {
+            type: 'FinancialAccount',
+            description: 'Financial account',
+        },
+        flowDetails: {
+            type: 'json',
+            required: false,
+            description: 'Details about the flow',
+        },
+    },
+    actions: [
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'treasury.transaction_entry.created',
+    ],
+};
+/**
+ * InboundTransfer entity (Treasury)
+ *
+ * Represents a transfer into a Treasury financial account
+ */
+export const InboundTransfer = {
+    singular: 'inbound transfer',
+    plural: 'inbound transfers',
+    description: 'A transfer into a Treasury financial account',
+    properties: {
+        // Identity
+        inboundTransferId: {
+            type: 'string',
+            description: 'Unique inbound transfer identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Transfer amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Transfer description',
+        },
+        // Origin
+        originPaymentMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Origin payment method',
+        },
+        originPaymentMethodDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Origin payment method details',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: processing, succeeded, failed, canceled',
+            examples: ['processing', 'succeeded', 'failed', 'canceled'],
+        },
+        // Failure
+        failureDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Failure details',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the transfer was created',
+        },
+    },
+    relationships: {
+        financialAccount: {
+            type: 'FinancialAccount',
+            description: 'Destination financial account',
+        },
+    },
+    actions: [
+        'create',
+        'cancel',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'treasury.inbound_transfer.created',
+        'treasury.inbound_transfer.succeeded',
+        'treasury.inbound_transfer.failed',
+        'treasury.inbound_transfer.canceled',
+    ],
+};
+/**
+ * OutboundTransfer entity (Treasury)
+ *
+ * Represents a transfer out of a Treasury financial account
+ */
+export const OutboundTransfer = {
+    singular: 'outbound transfer',
+    plural: 'outbound transfers',
+    description: 'A transfer out of a Treasury financial account',
+    properties: {
+        // Identity
+        outboundTransferId: {
+            type: 'string',
+            description: 'Unique outbound transfer identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Transfer amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Transfer description',
+        },
+        statementDescriptor: {
+            type: 'string',
+            optional: true,
+            description: 'Statement descriptor',
+        },
+        // Destination
+        destinationPaymentMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Destination payment method',
+        },
+        destinationPaymentMethodDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Destination payment method details',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: processing, posted, failed, canceled, returned',
+            examples: ['processing', 'posted', 'failed', 'canceled', 'returned'],
+        },
+        // Expected Arrival
+        expectedArrivalDate: {
+            type: 'datetime',
+            optional: true,
+            description: 'Expected arrival date',
+        },
+        // Return Details
+        returnedDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Return details if returned',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the transfer was created',
+        },
+    },
+    relationships: {
+        financialAccount: {
+            type: 'FinancialAccount',
+            description: 'Source financial account',
+        },
+    },
+    actions: [
+        'create',
+        'cancel',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'treasury.outbound_transfer.created',
+        'treasury.outbound_transfer.posted',
+        'treasury.outbound_transfer.failed',
+        'treasury.outbound_transfer.canceled',
+        'treasury.outbound_transfer.returned',
+    ],
+};
+/**
+ * OutboundPayment entity (Treasury)
+ *
+ * Represents a payment from a Treasury financial account
+ */
+export const OutboundPayment = {
+    singular: 'outbound payment',
+    plural: 'outbound payments',
+    description: 'A payment from a Treasury financial account',
+    properties: {
+        // Identity
+        outboundPaymentId: {
+            type: 'string',
+            description: 'Unique outbound payment identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Payment amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Payment description',
+        },
+        statementDescriptor: {
+            type: 'string',
+            optional: true,
+            description: 'Statement descriptor',
+        },
+        // Destination
+        destinationPaymentMethod: {
+            type: 'string',
+            optional: true,
+            description: 'Destination payment method',
+        },
+        destinationPaymentMethodDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Destination payment method details',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: processing, posted, failed, canceled, returned',
+            examples: ['processing', 'posted', 'failed', 'canceled', 'returned'],
+        },
+        // End User Details
+        endUserDetails: {
+            type: 'json',
+            optional: true,
+            description: 'End user details',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the payment was created',
+        },
+    },
+    relationships: {
+        financialAccount: {
+            type: 'FinancialAccount',
+            description: 'Source financial account',
+        },
+    },
+    actions: [
+        'create',
+        'cancel',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'treasury.outbound_payment.created',
+        'treasury.outbound_payment.posted',
+        'treasury.outbound_payment.failed',
+        'treasury.outbound_payment.canceled',
+        'treasury.outbound_payment.returned',
+    ],
+};
+/**
+ * ReceivedCredit entity (Treasury)
+ *
+ * Represents a credit received into a Treasury financial account
+ */
+export const ReceivedCredit = {
+    singular: 'received credit',
+    plural: 'received credits',
+    description: 'A credit received into a Treasury financial account',
+    properties: {
+        // Identity
+        receivedCreditId: {
+            type: 'string',
+            description: 'Unique received credit identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Credit amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Credit description',
+        },
+        // Network
+        network: {
+            type: 'string',
+            description: 'Network: ach, us_domestic_wire',
+            examples: ['ach', 'us_domestic_wire'],
+        },
+        // Initiating Payment Method Details
+        initiatingPaymentMethodDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Initiating payment method details',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: succeeded or failed',
+            examples: ['succeeded', 'failed'],
+        },
+        // Failure Code
+        failureCode: {
+            type: 'string',
+            optional: true,
+            description: 'Failure code',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the credit was received',
+        },
+    },
+    relationships: {
+        financialAccount: {
+            type: 'FinancialAccount',
+            description: 'Financial account',
+        },
+    },
+    actions: [
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'treasury.received_credit.created',
+        'treasury.received_credit.succeeded',
+        'treasury.received_credit.failed',
+    ],
+};
+/**
+ * ReceivedDebit entity (Treasury)
+ *
+ * Represents a debit received from a Treasury financial account
+ */
+export const ReceivedDebit = {
+    singular: 'received debit',
+    plural: 'received debits',
+    description: 'A debit received from a Treasury financial account',
+    properties: {
+        // Identity
+        receivedDebitId: {
+            type: 'string',
+            description: 'Unique received debit identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Debit amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Debit description',
+        },
+        // Network
+        network: {
+            type: 'string',
+            description: 'Network: ach',
+            examples: ['ach'],
+        },
+        // Initiating Payment Method Details
+        initiatingPaymentMethodDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Initiating payment method details',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: succeeded or failed',
+            examples: ['succeeded', 'failed'],
+        },
+        // Failure Code
+        failureCode: {
+            type: 'string',
+            optional: true,
+            description: 'Failure code',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the debit was received',
+        },
+    },
+    relationships: {
+        financialAccount: {
+            type: 'FinancialAccount',
+            description: 'Financial account',
+        },
+    },
+    actions: [
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'treasury.received_debit.created',
+    ],
+};
+// =============================================================================
+// ISSUING (cards)
+// =============================================================================
+/**
+ * IssuingCard entity
+ *
+ * Represents an issued payment card
+ */
+export const IssuingCard = {
+    singular: 'issuing card',
+    plural: 'issuing cards',
+    description: 'An issued physical or virtual payment card',
+    properties: {
+        // Identity
+        issuingCardId: {
+            type: 'string',
+            description: 'Unique card identifier',
+        },
+        last4: {
+            type: 'string',
+            optional: true,
+            description: 'Last 4 digits of card number',
+        },
+        // Brand
+        brand: {
+            type: 'string',
+            description: 'Card brand: visa or mastercard',
+            examples: ['visa', 'mastercard'],
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Card type: physical or virtual',
+            examples: ['physical', 'virtual'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: active, inactive, canceled',
+            examples: ['active', 'inactive', 'canceled'],
+        },
+        // Cancellation
+        cancellationReason: {
+            type: 'string',
+            optional: true,
+            description: 'Cancellation reason',
+        },
+        // Spending Controls
+        spendingControls: {
+            type: 'json',
+            optional: true,
+            description: 'Spending controls and limits',
+        },
+        // Shipping
+        shipping: {
+            type: 'json',
+            optional: true,
+            description: 'Shipping information (for physical cards)',
+        },
+        // Expiration
+        expMonth: {
+            type: 'number',
+            optional: true,
+            description: 'Expiration month',
+        },
+        expYear: {
+            type: 'number',
+            optional: true,
+            description: 'Expiration year',
+        },
+        // Currency
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the card was created',
+        },
+    },
+    relationships: {
+        cardholder: {
+            type: 'IssuingCardholder',
+            description: 'Cardholder',
+        },
+        replacementFor: {
+            type: 'IssuingCard',
+            required: false,
+            description: 'Card being replaced',
+        },
+        replacedBy: {
+            type: 'IssuingCard',
+            required: false,
+            description: 'Replacement card',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'cancel',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'issuing_card.created',
+        'issuing_card.updated',
+    ],
+};
+/**
+ * IssuingCardholder entity
+ *
+ * Represents a cardholder
+ */
+export const IssuingCardholder = {
+    singular: 'issuing cardholder',
+    plural: 'issuing cardholders',
+    description: 'A cardholder for issued cards',
+    properties: {
+        // Identity
+        issuingCardholderId: {
+            type: 'string',
+            description: 'Unique cardholder identifier',
+        },
+        name: {
+            type: 'string',
+            description: 'Cardholder name',
+        },
+        email: {
+            type: 'string',
+            optional: true,
+            description: 'Cardholder email',
+        },
+        phoneNumber: {
+            type: 'string',
+            optional: true,
+            description: 'Cardholder phone number',
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Cardholder type: individual or company',
+            examples: ['individual', 'company'],
+        },
+        // Billing
+        billing: {
+            type: 'json',
+            description: 'Billing information',
+        },
+        // Company
+        company: {
+            type: 'json',
+            optional: true,
+            description: 'Company information (for company type)',
+        },
+        // Individual
+        individual: {
+            type: 'json',
+            optional: true,
+            description: 'Individual information (for individual type)',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: active, inactive, blocked',
+            examples: ['active', 'inactive', 'blocked'],
+        },
+        // Spending Controls
+        spendingControls: {
+            type: 'json',
+            optional: true,
+            description: 'Default spending controls',
+        },
+        // Requirements
+        requirements: {
+            type: 'json',
+            optional: true,
+            description: 'Verification requirements',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the cardholder was created',
+        },
+    },
+    relationships: {
+        cards: {
+            type: 'IssuingCard[]',
+            backref: 'cardholder',
+            description: 'Cards issued to this cardholder',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'list',
+        'retrieve',
+    ],
+    events: [
+        'issuing_cardholder.created',
+        'issuing_cardholder.updated',
+    ],
+};
+/**
+ * IssuingAuthorization entity
+ *
+ * Represents a card authorization attempt
+ */
+export const IssuingAuthorization = {
+    singular: 'issuing authorization',
+    plural: 'issuing authorizations',
+    description: 'A card authorization attempt',
+    properties: {
+        // Identity
+        issuingAuthorizationId: {
+            type: 'string',
+            description: 'Unique authorization identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Authorization amount in cents',
+        },
+        amountDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Amount details (atm_fee, cashback, etc.)',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: pending, reversed, closed',
+            examples: ['pending', 'reversed', 'closed'],
+        },
+        approved: {
+            type: 'boolean',
+            description: 'Whether authorization was approved',
+        },
+        // Merchant
+        merchantAmount: {
+            type: 'number',
+            optional: true,
+            description: 'Merchant amount in merchant currency',
+        },
+        merchantCurrency: {
+            type: 'string',
+            optional: true,
+            description: 'Merchant currency',
+        },
+        merchantData: {
+            type: 'json',
+            optional: true,
+            description: 'Merchant data',
+        },
+        // Verification Data
+        verificationData: {
+            type: 'json',
+            optional: true,
+            description: 'Verification data',
+        },
+        // Request History
+        requestHistory: {
+            type: 'json',
+            array: true,
+            optional: true,
+            description: 'Request history',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the authorization was created',
+        },
+    },
+    relationships: {
+        card: {
+            type: 'IssuingCard',
+            description: 'Card used',
+        },
+        cardholder: {
+            type: 'IssuingCardholder',
+            required: false,
+            description: 'Cardholder',
+        },
+        transactions: {
+            type: 'IssuingTransaction[]',
+            description: 'Transactions created from this authorization',
+        },
+    },
+    actions: [
+        'approve',
+        'decline',
+        'list',
+        'retrieve',
+        'update',
+    ],
+    events: [
+        'issuing_authorization.created',
+        'issuing_authorization.updated',
+        'issuing_authorization.request',
+    ],
+};
+/**
+ * IssuingTransaction entity
+ *
+ * Represents a completed card transaction
+ */
+export const IssuingTransaction = {
+    singular: 'issuing transaction',
+    plural: 'issuing transactions',
+    description: 'A completed card transaction',
+    properties: {
+        // Identity
+        issuingTransactionId: {
+            type: 'string',
+            description: 'Unique transaction identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Transaction amount in cents',
+        },
+        amountDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Amount details',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Transaction type: capture or refund',
+            examples: ['capture', 'refund'],
+        },
+        // Merchant
+        merchantAmount: {
+            type: 'number',
+            optional: true,
+            description: 'Merchant amount',
+        },
+        merchantCurrency: {
+            type: 'string',
+            optional: true,
+            description: 'Merchant currency',
+        },
+        merchantData: {
+            type: 'json',
+            optional: true,
+            description: 'Merchant data',
+        },
+        // Purchase Details
+        purchaseDetails: {
+            type: 'json',
+            optional: true,
+            description: 'Purchase details',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the transaction was created',
+        },
+    },
+    relationships: {
+        card: {
+            type: 'IssuingCard',
+            description: 'Card used',
+        },
+        cardholder: {
+            type: 'IssuingCardholder',
+            required: false,
+            description: 'Cardholder',
+        },
+        authorization: {
+            type: 'IssuingAuthorization',
+            required: false,
+            description: 'Authorization',
+        },
+        dispute: {
+            type: 'IssuingDispute',
+            required: false,
+            description: 'Dispute if disputed',
+        },
+    },
+    actions: [
+        'list',
+        'retrieve',
+        'update',
+    ],
+    events: [
+        'issuing_transaction.created',
+        'issuing_transaction.updated',
+    ],
+};
+/**
+ * IssuingDispute entity
+ *
+ * Represents a dispute on a card transaction
+ */
+export const IssuingDispute = {
+    singular: 'issuing dispute',
+    plural: 'issuing disputes',
+    description: 'A dispute on a card transaction',
+    properties: {
+        // Identity
+        issuingDisputeId: {
+            type: 'string',
+            description: 'Unique dispute identifier',
+        },
+        // Amount
+        amount: {
+            type: 'number',
+            description: 'Disputed amount in cents',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Status: unsubmitted, submitted, won, lost, expired',
+            examples: ['unsubmitted', 'submitted', 'won', 'lost', 'expired'],
+        },
+        // Evidence
+        evidence: {
+            type: 'json',
+            optional: true,
+            description: 'Evidence for dispute',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the dispute was created',
+        },
+    },
+    relationships: {
+        transaction: {
+            type: 'IssuingTransaction',
+            description: 'Transaction being disputed',
+        },
+    },
+    actions: [
+        'create',
+        'submit',
+        'list',
+        'retrieve',
+        'update',
+    ],
+    events: [
+        'issuing_dispute.created',
+        'issuing_dispute.updated',
+        'issuing_dispute.closed',
+        'issuing_dispute.funds_reinstated',
+    ],
+};
+// =============================================================================
+// BANK
+// =============================================================================
+/**
+ * BankAccount entity
+ *
+ * Represents an external bank account
+ */
+export const BankAccount = {
+    singular: 'bank account',
+    plural: 'bank accounts',
+    description: 'An external bank account',
+    properties: {
+        // Identity
+        bankAccountId: {
+            type: 'string',
+            description: 'Unique bank account identifier',
+        },
+        accountHolderName: {
+            type: 'string',
+            optional: true,
+            description: 'Account holder name',
+        },
+        accountHolderType: {
+            type: 'string',
+            optional: true,
+            description: 'Account holder type: individual or company',
+            examples: ['individual', 'company'],
+        },
+        // Bank Details
+        bankName: {
+            type: 'string',
+            optional: true,
+            description: 'Bank name',
+        },
+        country: {
+            type: 'string',
+            description: 'Country code',
+        },
+        currency: {
+            type: 'string',
+            description: 'Currency code (ISO 4217)',
+            examples: ['USD', 'EUR', 'GBP', 'JPY'],
+        },
+        // Account Number
+        last4: {
+            type: 'string',
+            optional: true,
+            description: 'Last 4 digits of account number',
+        },
+        routingNumber: {
+            type: 'string',
+            optional: true,
+            description: 'Routing number',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Status: new, validated, verified, verification_failed, errored',
+            examples: ['new', 'validated', 'verified', 'verification_failed', 'errored'],
+        },
+        // Fingerprint
+        fingerprint: {
+            type: 'string',
+            optional: true,
+            description: 'Unique fingerprint',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+    },
+    relationships: {
+        customer: {
+            type: 'Customer',
+            required: false,
+            description: 'Customer this bank account belongs to',
+        },
+        account: {
+            type: 'Account',
+            required: false,
+            description: 'Connected account this bank account belongs to',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'verify',
+        'list',
+        'retrieve',
+    ],
+    events: [],
+};
+// =============================================================================
+// WEBHOOKS
+// =============================================================================
+/**
+ * WebhookEndpoint entity
+ *
+ * Represents a webhook endpoint configuration
+ */
+export const WebhookEndpoint = {
+    singular: 'webhook endpoint',
+    plural: 'webhook endpoints',
+    description: 'A webhook endpoint for receiving events',
+    properties: {
+        // Identity
+        webhookEndpointId: {
+            type: 'string',
+            description: 'Unique webhook endpoint identifier',
+        },
+        // URL
+        url: {
+            type: 'url',
+            description: 'Webhook URL',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Status: enabled or disabled',
+            examples: ['enabled', 'disabled'],
+        },
+        // Events
+        enabledEvents: {
+            type: 'string',
+            array: true,
+            description: 'Events to send to this endpoint',
+        },
+        // API Version
+        apiVersion: {
+            type: 'string',
+            optional: true,
+            description: 'API version',
+        },
+        // Description
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Endpoint description',
+        },
+        // Secret
+        secret: {
+            type: 'string',
+            optional: true,
+            description: 'Webhook signing secret',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Additional metadata',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the endpoint was created',
+        },
+    },
+    relationships: {},
+    actions: [
+        'create',
+        'update',
+        'delete',
+        'list',
+        'retrieve',
+    ],
+    events: [],
+};
+/**
+ * Event entity
+ *
+ * Represents a Stripe event
+ */
+export const Event = {
+    singular: 'event',
+    plural: 'events',
+    description: 'A Stripe API event',
+    properties: {
+        // Identity
+        eventId: {
+            type: 'string',
+            description: 'Unique event identifier',
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Event type (e.g., customer.created, charge.succeeded)',
+        },
+        // Data
+        data: {
+            type: 'json',
+            description: 'Event data',
+        },
+        // API Version
+        apiVersion: {
+            type: 'string',
+            optional: true,
+            description: 'API version',
+        },
+        // Request
+        request: {
+            type: 'json',
+            optional: true,
+            description: 'Request information',
+        },
+        // Pending Webhooks
+        pendingWebhooks: {
+            type: 'number',
+            optional: true,
+            description: 'Number of pending webhooks',
+        },
+        // Livemode
+        livemode: {
+            type: 'boolean',
+            description: 'Whether in live mode',
+        },
+        // Timestamps
+        created: {
+            type: 'datetime',
+            description: 'Time at which the event was created',
+        },
+    },
+    relationships: {},
+    actions: [
+        'list',
+        'retrieve',
+    ],
+    events: [],
+};
+// =============================================================================
+// EXPORTS
+// =============================================================================
+/**
+ * All finance entity types
+ */
+export const FinanceEntities = {
+    // Core
+    Customer,
+    Product,
+    Price,
+    // Payments
+    PaymentMethod,
+    PaymentIntent,
+    Charge,
+    Refund,
+    // Billing
+    Invoice,
+    InvoiceLineItem,
+    Subscription,
+    SubscriptionItem,
+    Quote,
+    // Balance
+    Balance,
+    BalanceTransaction,
+    // Connect
+    Account,
+    AccountLink,
+    Transfer,
+    Payout,
+    ApplicationFee,
+    // Treasury
+    FinancialAccount,
+    TreasuryTransaction,
+    InboundTransfer,
+    OutboundTransfer,
+    OutboundPayment,
+    ReceivedCredit,
+    ReceivedDebit,
+    // Issuing
+    IssuingCard,
+    IssuingCardholder,
+    IssuingAuthorization,
+    IssuingTransaction,
+    IssuingDispute,
+    // Bank
+    BankAccount,
+    // Webhooks
+    WebhookEndpoint,
+    Event,
+};
+/**
+ * Entity categories for organization
+ */
+export const FinanceCategories = {
+    core: ['Customer', 'Product', 'Price'],
+    payments: ['PaymentMethod', 'PaymentIntent', 'Charge', 'Refund'],
+    billing: ['Invoice', 'InvoiceLineItem', 'Subscription', 'SubscriptionItem', 'Quote'],
+    balance: ['Balance', 'BalanceTransaction'],
+    connect: ['Account', 'AccountLink', 'Transfer', 'Payout', 'ApplicationFee'],
+    treasury: [
+        'FinancialAccount',
+        'TreasuryTransaction',
+        'InboundTransfer',
+        'OutboundTransfer',
+        'OutboundPayment',
+        'ReceivedCredit',
+        'ReceivedDebit',
+    ],
+    issuing: [
+        'IssuingCard',
+        'IssuingCardholder',
+        'IssuingAuthorization',
+        'IssuingTransaction',
+        'IssuingDispute',
+    ],
+    bank: ['BankAccount'],
+    webhooks: ['WebhookEndpoint', 'Event'],
+};