@firela/api-types 0.0.0-canary.610daafc → 0.0.0-canary.63a53b7d

package/src/generated/types.gen.ts

@@ -6,13 +6,9 @@ export type CreateAccountDto = {
    */
   path: string;
   /**
-   * Display name to distinguish accounts at the same path (default: "")
+   * Account open date (server defaults to today)
    */
-  displayName?: string;
-  /**
-   * Account open date
-   */
-  openDate: string;
+  openDate?: string;
   /**
    * Allowed currencies (null = no restriction)
    */
@@ -36,18 +32,14 @@ export type CreateAccountDto = {
    * Whether this is a custom (user-created) account
    */
   isCustom?: boolean;
-  /**
-   * i18n key for display name (overrides template)
-   */
-  i18nKey?: string;
   /**
    * Icon identifier (overrides template)
    */
   icon?: string;
   /**
-   * Additional metadata
+   * Open directive metadata (NOT an opening-balance amount — use the opening-balance endpoint)
    */
-  openMeta?: {
+  openDirectiveMeta?: {
     [key: string]: unknown;
   };
   /**
@@ -77,10 +69,6 @@ export type AccountResponseDto = {
    * Account path (hierarchical, colon-separated)
    */
   path: string;
-  /**
-   * Display name distinguishing multiple accounts at the same path
-   */
-  displayName: string;
   /**
    * Account type (root segment)
    */
@@ -121,17 +109,17 @@ export type AccountResponseDto = {
    */
   isCustom: boolean;
   /**
-   * i18n key for display name
+   * Localized display name (ADR-0114, read-time projection)
    */
-  i18nKey?: string;
+  displayName?: string;
   /**
    * Icon identifier
    */
   icon?: string;
   /**
-   * Account metadata
+   * Open directive metadata (ADR-0115 Decision 9)
    */
-  openMeta?: {
+  openDirectiveMeta?: {
     [key: string]: unknown;
   };
   /**
@@ -178,10 +166,6 @@ export type AccountListResponseDto = {
 };
 
 export type UpdateAccountDto = {
-  /**
-   * Display name to distinguish accounts at the same path
-   */
-  displayName?: string;
   /**
    * Allowed currencies (null = no restriction)
    */
@@ -197,18 +181,14 @@ export type UpdateAccountDto = {
     | 'STRICT'
     | 'STRICT_WITH_SIZE'
     | 'NONE';
-  /**
-   * i18n key for display name
-   */
-  i18nKey?: string;
   /**
    * Icon identifier
    */
   icon?: string;
   /**
-   * Additional metadata (merged with existing)
+   * Open directive metadata (merged with existing; NOT an opening-balance amount)
    */
-  openMeta?: {
+  openDirectiveMeta?: {
     [key: string]: unknown;
   };
   /**
@@ -237,6 +217,28 @@ export type ReopenAccountDto = {
   reopenDate?: string;
 };
 
+export type CreateOpeningBalanceDto = {
+  /**
+   * Opening balance amount (non-negative)
+   */
+  amount: number;
+  /**
+   * Currency code
+   */
+  currency: string;
+  /**
+   * Opening-balance date (defaults to now)
+   */
+  date?: string;
+};
+
+export type OpeningBalanceResultDto = {
+  /**
+   * Created opening-balance transaction id.
+   */
+  transactionId: string;
+};
+
 export type AccountStandardResponseDto = {
   /**
    * Account path (hierarchical, colon-separated)
@@ -246,10 +248,6 @@ export type AccountStandardResponseDto = {
    * Account type in Beancount hierarchy
    */
   type: 'Assets' | 'Liabilities' | 'Income' | 'Expenses' | 'Equity';
-  /**
-   * i18n key for localized display name
-   */
-  i18nKey: string;
   /**
    * Short localized display name
    */
@@ -284,10 +282,6 @@ export type AccountStandardListResponseDto = {
 };
 
 export type TemplateMetadataDto = {
-  /**
-   * Whether this path can be extended
-   */
-  extendable: boolean;
   /**
    * Root account type
    */
@@ -1966,6 +1960,108 @@ export type UpdateCommodityDto = {
   };
 };
 
+export type CreateBeanPriceDto = {
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
+   */
+  currency: string;
+  /**
+   * Quote currency (pricing currency, e.g., CNY, EUR)
+   */
+  quoteCurrency: string;
+  /**
+   * Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.
+   */
+  amount: number;
+  /**
+   * Price date (ISO 8601 format)
+   */
+  date: string;
+  /**
+   * Metadata (validated by Zod schema, max field lengths enforced)
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+
+export type PriceResponseDto = {
+  /**
+   * Unique identifier
+   */
+  id: string;
+  /**
+   * User ID (owner of the price)
+   */
+  userId: string;
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
+   */
+  currency: string;
+  /**
+   * Quote currency (pricing currency, e.g., USD, CNY)
+   */
+  quoteCurrency: string;
+  /**
+   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
+   */
+  amount: number;
+  /**
+   * Price date (ISO 8601 format). Represents the date this price was valid.
+   */
+  date: string;
+  /**
+   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
+   */
+  meta: {
+    [key: string]: unknown;
+  };
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+};
+
+export type PriceListResponseDto = {
+  /**
+   * List of prices
+   */
+  items: Array<PriceResponseDto>;
+  /**
+   * Total number of prices
+   */
+  total: number;
+};
+
+export type UpdateBeanPriceDto = {
+  /**
+   * Currency being priced
+   */
+  currency?: string;
+  /**
+   * Quote currency (pricing currency)
+   */
+  quoteCurrency?: string;
+  /**
+   * Price amount (MUST be >= 0 per Beancount spec)
+   */
+  amount?: number;
+  /**
+   * Price date (ISO 8601 format)
+   */
+  date?: string;
+  /**
+   * Metadata
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+
 export type CreateRecurringRuleDto = {
   /**
    * Rule name (unique per user)
@@ -3168,6 +3264,160 @@ export type UpdateBeanEventDto = {
   };
 };
 
+export type OnboardingAccountDto = {
+  /**
+   * Account path (Assets/Liabilities only; format validated by the account service)
+   */
+  path: string;
+  /**
+   * ISO 4217 currency code (3 letters)
+   */
+  currency: string;
+  /**
+   * Opening balance as a non-negative Decimal string (e.g. "1000.00")
+   */
+  openingBalance?: string;
+  /**
+   * Platform ID to bind the account to (references Platform.id); omit for unbound
+   */
+  platformId?: string;
+};
+
+export type OnboardingDto = {
+  /**
+   * Asset/Liability accounts to register with opening balances
+   */
+  accounts?: Array<OnboardingAccountDto>;
+  /**
+   * Skip asset registration; only bootstrap the core account set
+   */
+  skipAssetRegistration?: boolean;
+};
+
+export type ActualBalanceDto = {
+  /**
+   * Actual balance amount as a decimal string (preserves precision for tolerance inference).
+   */
+  amount: string;
+  /**
+   * Currency code (ISO 4217 or commodity ticker).
+   */
+  ccy: string;
+};
+
+export type ComputeReconciliationDto = {
+  /**
+   * BeanAccount id to reconcile.
+   */
+  accountId: string;
+  /**
+   * Assertion date (ISO 8601, e.g. "2026-07-24").
+   */
+  asOfDate: string;
+  /**
+   * Actual balance from the external statement.
+   */
+  actualBalance: ActualBalanceDto;
+};
+
+export type ReconciliationComputeResultDto = {
+  accountId: string;
+  asOfDate: string;
+  /**
+   * System-computed book balance (decimal string).
+   */
+  bookBalance: string;
+  /**
+   * User-entered actual balance (decimal string).
+   */
+  actualBalance: string;
+  currency: string;
+  /**
+   * Diff = book − actual (decimal string).
+   */
+  diff: string;
+  /**
+   * Applied tolerance (decimal string).
+   */
+  tolerance: string;
+  /**
+   * true when |diff| ≤ tolerance.
+   */
+  withinTolerance: boolean;
+  /**
+   * Suggested next action: assert when within tolerance, pad otherwise.
+   */
+  suggestedAction: 'assert' | 'pad';
+};
+
+/**
+ * Suggested next action: assert when within tolerance, pad otherwise.
+ */
+export type suggestedAction = 'assert' | 'pad';
+
+export type AssertReconciliationDto = {
+  /**
+   * BeanAccount id to reconcile.
+   */
+  accountId: string;
+  /**
+   * Assertion date (ISO 8601, e.g. "2026-07-24").
+   */
+  asOfDate: string;
+  /**
+   * Actual balance from the external statement.
+   */
+  actualBalance: ActualBalanceDto;
+  /**
+   * Optional explicit tolerance override. Omit to infer from amount precision (Beancount default).
+   */
+  tolerance?: string;
+};
+
+export type ReconciliationRecordDto = {
+  id: string;
+  accountId: string;
+  date: string;
+  /**
+   * Asserted (actual) amount.
+   */
+  amount: string;
+  currency: string;
+  tolerance?: string;
+  /**
+   * book − actual.
+   */
+  diffAmount?: string;
+  diffCurrency?: string;
+  createdAt: string;
+};
+
+export type PadReconciliationDto = {
+  /**
+   * BeanAccount id to reconcile.
+   */
+  accountId: string;
+  /**
+   * Assertion date (ISO 8601, e.g. "2026-07-24").
+   */
+  asOfDate: string;
+  /**
+   * Actual balance from the external statement.
+   */
+  actualBalance: ActualBalanceDto;
+  /**
+   * Pad source account. Defaults to Equity:Opening-Balances (official Beancount convention).
+   */
+  sourceAccount?: string;
+};
+
+export type PadResultDto = {
+  /**
+   * Created pad adjusting transaction id.
+   */
+  transactionId: string;
+};
+
 export type FileImportDto = {
   /**
    * Bill file to import (CSV, PDF, OFX, etc.)
@@ -3466,107 +3716,19 @@ export type UpdateImporterConfigDto = {
   data?: UpdateConfigDataDto;
 };
 
-export type CreatePlatformDto = {
+export type ProviderSyncConfigDto = {
   /**
-   * Platform name
+   * Source account for the first posting
    */
-  name: string;
+  sourceAccount: string;
   /**
-   * Platform canonical identifier (lowercase, kebab-case)
+   * Default currency for transactions
    */
-  canonical: string;
+  defaultCurrency: string;
   /**
-   * Platform aliases (multi-language names for lookup)
+   * Default expense account for the second posting
    */
-  aliases: Array<string>;
-  /**
-   * Platform URL
-   */
-  url: string;
-  /**
-   * Platform type
-   */
-  type:
-    | 'BANK'
-    | 'BROKERAGE'
-    | 'CRYPTO_EXCHANGE'
-    | 'PAYMENT'
-    | 'INVESTMENT'
-    | 'INSURANCE'
-    | 'OTHER';
-  /**
-   * Platform logo URL
-   */
-  logoUrl?: string;
-  /**
-   * Whether the platform is active
-   */
-  isActive?: boolean;
-};
-
-/**
- * Platform type
- */
-export type type3 =
-  | 'BANK'
-  | 'BROKERAGE'
-  | 'CRYPTO_EXCHANGE'
-  | 'PAYMENT'
-  | 'INVESTMENT'
-  | 'INSURANCE'
-  | 'OTHER';
-
-export type UpdatePlatformDto = {
-  /**
-   * Platform name
-   */
-  name?: string;
-  /**
-   * Platform canonical identifier (lowercase, kebab-case)
-   */
-  canonical?: string;
-  /**
-   * Platform aliases (multi-language names for lookup)
-   */
-  aliases?: Array<string>;
-  /**
-   * Platform URL
-   */
-  url?: string;
-  /**
-   * Platform type
-   */
-  type?:
-    | 'BANK'
-    | 'BROKERAGE'
-    | 'CRYPTO_EXCHANGE'
-    | 'PAYMENT'
-    | 'INVESTMENT'
-    | 'INSURANCE'
-    | 'OTHER';
-  /**
-   * Platform logo URL
-   */
-  logoUrl?: string;
-  /**
-   * Whether the platform is active
-   */
-  isActive?: boolean;
-};
-
-export type ProviderSyncConfigDto = {
-  /**
-   * Source account for the first posting
-   */
-  sourceAccount: string;
-  /**
-   * Default currency for transactions
-   */
-  defaultCurrency: string;
-  /**
-   * Default expense account for the second posting
-   */
-  defaultExpenseAccount: string;
+  defaultExpenseAccount: string;
   /**
    * Default income account for the second posting
    */
@@ -3575,6 +3737,10 @@ export type ProviderSyncConfigDto = {
    * Filter pending transactions
    */
   filterPending?: boolean;
+  /**
+   * External account ID for per-batch providers (e.g. GoCardless). Overrides sourceAccount when an ExternalAccountLink mapping exists.
+   */
+  externalAccountId?: string;
 };
 
 export type ProviderSyncDto = {
@@ -3630,6 +3796,61 @@ export type SupportedProvidersResponseDto = {
   providers: Array<string>;
 };
 
+export type CreateExternalAccountLinkDto = {
+  /**
+   * Open Banking provider (whitelist)
+   */
+  provider:
+    | 'plaid'
+    | 'teller'
+    | 'truelayer'
+    | 'gocardless'
+    | 'simplefin'
+    | 'yodlee'
+    | 'beancount-direct'
+    | 'parsed-bill';
+  /**
+   * External account ID from the provider
+   */
+  externalAccountId: string;
+  /**
+   * Target BeanAccount ID (must belong to the JWT user)
+   */
+  beanAccountId: string;
+};
+
+/**
+ * Open Banking provider (whitelist)
+ */
+export type provider =
+  | 'plaid'
+  | 'teller'
+  | 'truelayer'
+  | 'gocardless'
+  | 'simplefin'
+  | 'yodlee'
+  | 'beancount-direct'
+  | 'parsed-bill';
+
+export type ExternalAccountLinkResponseDto = {
+  id: string;
+  provider: string;
+  externalAccountId: string;
+  beanAccountId: string;
+  isActive: boolean;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type ExternalAccountLinkListResponseDto = {
+  items: Array<ExternalAccountLinkResponseDto>;
+  total: number;
+  /**
+   * Filter by provider (query param)
+   */
+  provider?: string;
+};
+
 export type ParserTelemetryReportDto = unknown;
 
 export type UncoveredFormatMissDto = unknown;
@@ -4209,6 +4430,94 @@ export type liabilitySubType = 'borrow' | 'repay';
  */
 export type equitySubType = 'opening' | 'adjustment';
 
+export type CreatePlatformDto = {
+  /**
+   * Platform name
+   */
+  name: string;
+  /**
+   * Platform canonical identifier (lowercase, kebab-case)
+   */
+  canonical: string;
+  /**
+   * Platform aliases (multi-language names for lookup)
+   */
+  aliases: Array<string>;
+  /**
+   * Platform URL
+   */
+  url: string;
+  /**
+   * Platform type
+   */
+  type:
+    | 'BANK'
+    | 'BROKERAGE'
+    | 'CRYPTO_EXCHANGE'
+    | 'PAYMENT'
+    | 'INVESTMENT'
+    | 'INSURANCE'
+    | 'OTHER';
+  /**
+   * Platform logo URL
+   */
+  logoUrl?: string;
+  /**
+   * Whether the platform is active
+   */
+  isActive?: boolean;
+};
+
+/**
+ * Platform type
+ */
+export type type3 =
+  | 'BANK'
+  | 'BROKERAGE'
+  | 'CRYPTO_EXCHANGE'
+  | 'PAYMENT'
+  | 'INVESTMENT'
+  | 'INSURANCE'
+  | 'OTHER';
+
+export type UpdatePlatformDto = {
+  /**
+   * Platform name
+   */
+  name?: string;
+  /**
+   * Platform canonical identifier (lowercase, kebab-case)
+   */
+  canonical?: string;
+  /**
+   * Platform aliases (multi-language names for lookup)
+   */
+  aliases?: Array<string>;
+  /**
+   * Platform URL
+   */
+  url?: string;
+  /**
+   * Platform type
+   */
+  type?:
+    | 'BANK'
+    | 'BROKERAGE'
+    | 'CRYPTO_EXCHANGE'
+    | 'PAYMENT'
+    | 'INVESTMENT'
+    | 'INSURANCE'
+    | 'OTHER';
+  /**
+   * Platform logo URL
+   */
+  logoUrl?: string;
+  /**
+   * Whether the platform is active
+   */
+  isActive?: boolean;
+};
+
 export type NetWorthByCurrencyDto = {
   /**
    * Net worth by currency
@@ -4922,157 +5231,55 @@ export type HoldingPnlResponseDto = {
  */
 export type method = 'average' | 'FIFO';
 
-export type CreateBeanPriceDto = {
+export type CurrencyBalanceDto = {
   /**
-   * Currency being priced (e.g., USD, AAPL, BTC)
+   * ISO 4217 currency code
    */
   currency: string;
   /**
-   * Quote currency (pricing currency, e.g., CNY, EUR)
+   * Balance amount
    */
-  quoteCurrency: string;
+  balance: string;
+};
+
+export type TimeSeriesPointDto = {
   /**
-   * Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.
+   * Date in YYYY-MM-DD format
    */
-  amount: number;
+  date: string;
   /**
-   * Price date (ISO 8601 format)
+   * Value at this date (in base currency)
    */
-  date: string;
+  value: string;
   /**
-   * Metadata (validated by Zod schema, max field lengths enforced)
+   * Change from previous point
    */
-  metadata?: {
+  change?: {
     [key: string]: unknown;
   };
-};
-
-export type PriceResponseDto = {
   /**
-   * Unique identifier
+   * Total assets at this date (in base currency)
    */
-  id: string;
+  assets?: string;
   /**
-   * User ID (owner of the price)
+   * Total liabilities at this date (in base currency)
    */
-  userId: string;
+  liabilities?: string;
   /**
-   * Currency being priced (e.g., USD, AAPL, BTC)
+   * Multi-currency breakdown for this point
    */
-  currency: string;
+  byCurrency?: Array<CurrencyBalanceDto>;
+};
+
+export type TrendSummaryDto = {
   /**
-   * Quote currency (pricing currency, e.g., USD, CNY)
+   * Value at start of period
    */
-  quoteCurrency: string;
+  startValue: string;
   /**
-   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
+   * Value at end of period
    */
-  amount: number;
-  /**
-   * Price date (ISO 8601 format). Represents the date this price was valid.
-   */
-  date: string;
-  /**
-   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
-   */
-  meta: {
-    [key: string]: unknown;
-  };
-  /**
-   * Creation timestamp
-   */
-  createdAt: string;
-  /**
-   * Last update timestamp
-   */
-  updatedAt: string;
-};
-
-export type PriceListResponseDto = {
-  /**
-   * List of prices
-   */
-  items: Array<PriceResponseDto>;
-  /**
-   * Total number of prices
-   */
-  total: number;
-};
-
-export type UpdateBeanPriceDto = {
-  /**
-   * Currency being priced
-   */
-  currency?: string;
-  /**
-   * Quote currency (pricing currency)
-   */
-  quoteCurrency?: string;
-  /**
-   * Price amount (MUST be >= 0 per Beancount spec)
-   */
-  amount?: number;
-  /**
-   * Price date (ISO 8601 format)
-   */
-  date?: string;
-  /**
-   * Metadata
-   */
-  metadata?: {
-    [key: string]: unknown;
-  };
-};
-
-export type CurrencyBalanceDto = {
-  /**
-   * ISO 4217 currency code
-   */
-  currency: string;
-  /**
-   * Balance amount
-   */
-  balance: string;
-};
-
-export type TimeSeriesPointDto = {
-  /**
-   * Date in YYYY-MM-DD format
-   */
-  date: string;
-  /**
-   * Value at this date (in base currency)
-   */
-  value: string;
-  /**
-   * Change from previous point
-   */
-  change?: {
-    [key: string]: unknown;
-  };
-  /**
-   * Total assets at this date (in base currency)
-   */
-  assets?: string;
-  /**
-   * Total liabilities at this date (in base currency)
-   */
-  liabilities?: string;
-  /**
-   * Multi-currency breakdown for this point
-   */
-  byCurrency?: Array<CurrencyBalanceDto>;
-};
-
-export type TrendSummaryDto = {
-  /**
-   * Value at start of period
-   */
-  startValue: string;
-  /**
-   * Value at end of period
-   */
-  endValue: string;
+  endValue: string;
   /**
    * Total change over period
    */
@@ -5233,7 +5440,7 @@ export type AccountControllerFindAllData = {
    */
   region: 'cn' | 'us' | 'de' | 'gb';
   /**
-   * Search term for path or i18nKey
+   * Search term for account path
    */
   search?: string;
   /**
@@ -5316,6 +5523,21 @@ export type AccountControllerReopenData = {
 
 export type AccountControllerReopenResponse = AccountResponseDto;
 
+export type AccountControllerAddOpeningBalanceData = {
+  /**
+   * Account UUID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateOpeningBalanceDto;
+};
+
+export type AccountControllerAddOpeningBalanceResponse =
+  OpeningBalanceResultDto;
+
 export type AccountStandardsControllerGetTemplatesData = {
   /**
    * Region code (cn, us, de)
@@ -5504,7 +5726,7 @@ export type TransactionControllerDeleteResponse = void;
 
 export type BalanceControllerGetBalanceData = {
   /**
-   * Account name (e.g., "Assets:Bank:Checking")
+   * Account name (e.g., "Assets:Checking")
    */
   account: string;
   /**
@@ -5906,6 +6128,103 @@ export type CommodityControllerBulkCreateData = {
 
 export type CommodityControllerBulkCreateResponse = Array<CommodityResponseDto>;
 
+export type PriceControllerCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateBeanPriceDto;
+};
+
+export type PriceControllerCreateResponse = PriceResponseDto;
+
+export type PriceControllerFindAllData = {
+  /**
+   * Filter by currency (e.g., BTC, AAPL, USD)
+   */
+  currency?: string;
+  /**
+   * Filter prices from this date (ISO 8601 format)
+   */
+  dateFrom?: string;
+  /**
+   * Filter prices to this date (ISO 8601 format)
+   */
+  dateTo?: string;
+  /**
+   * Number of items per page (default: 20, max: 100)
+   */
+  limit?: number;
+  /**
+   * Page number for pagination (default: 1)
+   */
+  page?: number;
+  /**
+   * Filter by quote currency (pricing currency, e.g., USD, CNY)
+   */
+  quoteCurrency?: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Search term for currency or quoteCurrency (case-insensitive partial match)
+   */
+  search?: string;
+};
+
+export type PriceControllerFindAllResponse = PriceListResponseDto;
+
+export type PriceControllerFindOneData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type PriceControllerFindOneResponse = PriceResponseDto;
+
+export type PriceControllerUpdateData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UpdateBeanPriceDto;
+};
+
+export type PriceControllerUpdateResponse = PriceResponseDto;
+
+export type PriceControllerDeleteData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type PriceControllerDeleteResponse = void;
+
+export type PriceControllerBulkCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: Array<string>;
+};
+
+export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
+
 export type RecurringRuleControllerCreateData = {
   /**
    * Region code for tenant context
@@ -6469,6 +6788,61 @@ export type EventControllerGetSliceData = {
 
 export type EventControllerGetSliceResponse = unknown;
 
+export type OnboardingControllerBootstrapData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: OnboardingDto;
+};
+
+export type OnboardingControllerBootstrapResponse = unknown;
+
+export type ReconciliationControllerComputeData = {
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: ComputeReconciliationDto;
+};
+
+export type ReconciliationControllerComputeResponse =
+  ReconciliationComputeResultDto;
+
+export type ReconciliationControllerAssertData = {
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: AssertReconciliationDto;
+};
+
+export type ReconciliationControllerAssertResponse = ReconciliationRecordDto;
+
+export type ReconciliationControllerPadData = {
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: PadReconciliationDto;
+};
+
+export type ReconciliationControllerPadResponse = PadResultDto;
+
+export type ReconciliationControllerHistoryData = {
+  /**
+   * BeanAccount id
+   */
+  accountId: string;
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type ReconciliationControllerHistoryResponse =
+  Array<ReconciliationRecordDto>;
+
 export type ExportControllerExportBeancountResponse = unknown;
 
 export type FileImportControllerImportFileData = {
@@ -6561,48 +6935,6 @@ export type ImporterConfigControllerResetConfigData = {
 
 export type ImporterConfigControllerResetConfigResponse = ImporterConfigDto;
 
-export type PlatformControllerFindAllResponse = unknown;
-
-export type PlatformControllerCreateData = {
-  requestBody: CreatePlatformDto;
-};
-
-export type PlatformControllerCreateResponse = unknown;
-
-export type PlatformControllerGetPlatformListResponse = unknown;
-
-export type PlatformControllerMatchPlatformsData = {
-  /**
-   * Search query — Chinese name, English name, or abbreviation
-   */
-  q: string;
-  /**
-   * Region code for category override lookup
-   */
-  region?: string;
-};
-
-export type PlatformControllerMatchPlatformsResponse = unknown;
-
-export type PlatformControllerUpdateData = {
-  /**
-   * Platform ID
-   */
-  id: string;
-  requestBody: UpdatePlatformDto;
-};
-
-export type PlatformControllerUpdateResponse = unknown;
-
-export type PlatformControllerDeleteData = {
-  /**
-   * Platform ID
-   */
-  id: string;
-};
-
-export type PlatformControllerDeleteResponse = void;
-
 export type ProviderSyncControllerSyncData = {
   /**
    * Provider name
@@ -6648,6 +6980,49 @@ export type ProviderSyncControllerIsProviderSupportedData = {
 
 export type ProviderSyncControllerIsProviderSupportedResponse = unknown;
 
+export type ExternalAccountLinkControllerCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateExternalAccountLinkDto;
+};
+
+export type ExternalAccountLinkControllerCreateResponse =
+  ExternalAccountLinkResponseDto;
+
+export type ExternalAccountLinkControllerFindAllData = {
+  provider: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type ExternalAccountLinkControllerFindAllResponse =
+  ExternalAccountLinkListResponseDto;
+
+export type ExternalAccountLinkControllerFindOneData = {
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type ExternalAccountLinkControllerFindOneResponse =
+  ExternalAccountLinkResponseDto;
+
+export type ExternalAccountLinkControllerRemoveData = {
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type ExternalAccountLinkControllerRemoveResponse = void;
+
 export type TelemetryControllerReportTelemetryData = {
   /**
    * Region code for tenant context
@@ -6720,6 +7095,48 @@ export type NlpControllerGetSessionData = {
 
 export type NlpControllerGetSessionResponse = unknown;
 
+export type PlatformControllerFindAllResponse = unknown;
+
+export type PlatformControllerCreateData = {
+  requestBody: CreatePlatformDto;
+};
+
+export type PlatformControllerCreateResponse = unknown;
+
+export type PlatformControllerGetPlatformListResponse = unknown;
+
+export type PlatformControllerMatchPlatformsData = {
+  /**
+   * Search query — Chinese name, English name, or abbreviation
+   */
+  q: string;
+  /**
+   * Region code for category override lookup
+   */
+  region?: string;
+};
+
+export type PlatformControllerMatchPlatformsResponse = unknown;
+
+export type PlatformControllerUpdateData = {
+  /**
+   * Platform ID
+   */
+  id: string;
+  requestBody: UpdatePlatformDto;
+};
+
+export type PlatformControllerUpdateResponse = unknown;
+
+export type PlatformControllerDeleteData = {
+  /**
+   * Platform ID
+   */
+  id: string;
+};
+
+export type PlatformControllerDeleteResponse = void;
+
 export type DashboardControllerGetNetWorthData = {
   /**
    * Date for balance calculation (ISO 8601 format)
@@ -6817,103 +7234,6 @@ export type HoldingPnlControllerGetHoldingPnlData = {
 
 export type HoldingPnlControllerGetHoldingPnlResponse = HoldingPnlResponseDto;
 
-export type PriceControllerCreateData = {
-  /**
-   * Region code for tenant context
-   */
-  region: 'cn' | 'us' | 'de' | 'gb';
-  requestBody: CreateBeanPriceDto;
-};
-
-export type PriceControllerCreateResponse = PriceResponseDto;
-
-export type PriceControllerFindAllData = {
-  /**
-   * Filter by currency (e.g., BTC, AAPL, USD)
-   */
-  currency?: string;
-  /**
-   * Filter prices from this date (ISO 8601 format)
-   */
-  dateFrom?: string;
-  /**
-   * Filter prices to this date (ISO 8601 format)
-   */
-  dateTo?: string;
-  /**
-   * Number of items per page (default: 20, max: 100)
-   */
-  limit?: number;
-  /**
-   * Page number for pagination (default: 1)
-   */
-  page?: number;
-  /**
-   * Filter by quote currency (pricing currency, e.g., USD, CNY)
-   */
-  quoteCurrency?: string;
-  /**
-   * Region code for tenant context
-   */
-  region: 'cn' | 'us' | 'de' | 'gb';
-  /**
-   * Search term for currency or quoteCurrency (case-insensitive partial match)
-   */
-  search?: string;
-};
-
-export type PriceControllerFindAllResponse = PriceListResponseDto;
-
-export type PriceControllerFindOneData = {
-  /**
-   * Price ID
-   */
-  id: string;
-  /**
-   * Region code for tenant context
-   */
-  region: 'cn' | 'us' | 'de' | 'gb';
-};
-
-export type PriceControllerFindOneResponse = PriceResponseDto;
-
-export type PriceControllerUpdateData = {
-  /**
-   * Price ID
-   */
-  id: string;
-  /**
-   * Region code for tenant context
-   */
-  region: 'cn' | 'us' | 'de' | 'gb';
-  requestBody: UpdateBeanPriceDto;
-};
-
-export type PriceControllerUpdateResponse = PriceResponseDto;
-
-export type PriceControllerDeleteData = {
-  /**
-   * Price ID
-   */
-  id: string;
-  /**
-   * Region code for tenant context
-   */
-  region: 'cn' | 'us' | 'de' | 'gb';
-};
-
-export type PriceControllerDeleteResponse = void;
-
-export type PriceControllerBulkCreateData = {
-  /**
-   * Region code for tenant context
-   */
-  region: 'cn' | 'us' | 'de' | 'gb';
-  requestBody: Array<string>;
-};
-
-export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
-
 export type ReportingControllerGetPortfolioTrendsData = {
   /**
    * Data granularity
@@ -7129,6 +7449,25 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/accounts/{id}/opening-balance': {
+    post: {
+      req: AccountControllerAddOpeningBalanceData;
+      res: {
+        /**
+         * Opening-balance transaction created
+         */
+        201: OpeningBalanceResultDto;
+        /**
+         * Account not found
+         */
+        404: unknown;
+        /**
+         * An opening balance already exists for this account
+         */
+        409: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/bean/account-standards': {
     get: {
       req: AccountStandardsControllerGetTemplatesData;
@@ -7737,54 +8076,138 @@ export type $OpenApiTs = {
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules': {
+  '/api/v1/{region}/bean/prices': {
     post: {
-      req: RecurringRuleControllerCreateData;
+      req: PriceControllerCreateData;
       res: {
         /**
-         * Rule created successfully
+         * Price created successfully
          */
-        201: RecurringRuleResponseDto;
+        201: PriceResponseDto;
         /**
-         * Invalid input data (e.g., autoCreate without accounts)
+         * Currency or quoteCurrency commodity not found
          */
-        400: unknown;
+        404: unknown;
         /**
-         * Rule with same name already exists
+         * Price already exists for this currency pair and date
          */
         409: unknown;
       };
     };
     get: {
-      req: RecurringRuleControllerFindAllData;
+      req: PriceControllerFindAllData;
       res: {
         /**
-         * Rules retrieved successfully
+         * Prices retrieved successfully
          */
-        200: Array<RecurringRuleResponseDto>;
+        200: PriceListResponseDto;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules/from-transaction/{transactionId}': {
-    post: {
-      req: RecurringRuleControllerCreateFromTransactionData;
+  '/api/v1/{region}/bean/prices/{id}': {
+    get: {
+      req: PriceControllerFindOneData;
       res: {
         /**
-         * Rule created successfully
-         */
-        201: RecurringRuleResponseDto;
-        /**
-         * Transaction not found
+         * Price retrieved successfully
          */
-        404: ApiProblemResponseDto;
+        200: PriceResponseDto;
         /**
-         * Rule with same name already exists or transaction already linked
+         * Price not found
          */
-        409: ApiProblemResponseDto;
+        404: unknown;
       };
     };
-  };
-  '/api/v1/{region}/bean/recurring-rules/{id}': {
+    put: {
+      req: PriceControllerUpdateData;
+      res: {
+        /**
+         * Price updated successfully
+         */
+        200: PriceResponseDto;
+        /**
+         * Price not found
+         */
+        404: unknown;
+        /**
+         * Updated price conflicts with existing price
+         */
+        409: unknown;
+      };
+    };
+    delete: {
+      req: PriceControllerDeleteData;
+      res: {
+        /**
+         * Price deleted successfully
+         */
+        204: void;
+        /**
+         * Price not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/prices/bulk': {
+    post: {
+      req: PriceControllerBulkCreateData;
+      res: {
+        /**
+         * Prices created successfully
+         */
+        201: Array<PriceResponseDto>;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/recurring-rules': {
+    post: {
+      req: RecurringRuleControllerCreateData;
+      res: {
+        /**
+         * Rule created successfully
+         */
+        201: RecurringRuleResponseDto;
+        /**
+         * Invalid input data (e.g., autoCreate without accounts)
+         */
+        400: unknown;
+        /**
+         * Rule with same name already exists
+         */
+        409: unknown;
+      };
+    };
+    get: {
+      req: RecurringRuleControllerFindAllData;
+      res: {
+        /**
+         * Rules retrieved successfully
+         */
+        200: Array<RecurringRuleResponseDto>;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/recurring-rules/from-transaction/{transactionId}': {
+    post: {
+      req: RecurringRuleControllerCreateFromTransactionData;
+      res: {
+        /**
+         * Rule created successfully
+         */
+        201: RecurringRuleResponseDto;
+        /**
+         * Transaction not found
+         */
+        404: ApiProblemResponseDto;
+        /**
+         * Rule with same name already exists or transaction already linked
+         */
+        409: ApiProblemResponseDto;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/recurring-rules/{id}': {
     get: {
       req: RecurringRuleControllerFindOneData;
       res: {
@@ -8477,6 +8900,85 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/onboarding': {
+    post: {
+      req: OnboardingControllerBootstrapData;
+      res: {
+        /**
+         * Onboarding bootstrap result.
+         */
+        201: unknown;
+        /**
+         * Invalid region/account path/duplicate paths.
+         */
+        422: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/reconciliations': {
+    post: {
+      req: ReconciliationControllerComputeData;
+      res: {
+        /**
+         * Reconciliation preview
+         */
+        200: ReconciliationComputeResultDto;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/reconciliations/assert': {
+    post: {
+      req: ReconciliationControllerAssertData;
+      res: {
+        /**
+         * Balance assertion recorded
+         */
+        201: ReconciliationRecordDto;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/reconciliations/pad': {
+    post: {
+      req: ReconciliationControllerPadData;
+      res: {
+        /**
+         * Pad adjusting entry generated
+         */
+        201: PadResultDto;
+        /**
+         * Book already within tolerance — no pad needed
+         */
+        400: unknown;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/accounts/{accountId}/reconciliations': {
+    get: {
+      req: ReconciliationControllerHistoryData;
+      res: {
+        /**
+         * Reconciliation history
+         */
+        200: Array<ReconciliationRecordDto>;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/bean/export/beancount': {
     get: {
       res: {
@@ -8627,128 +9129,104 @@ export type $OpenApiTs = {
       };
     };
   };
-  '/api/v1/bean/platforms': {
-    get: {
+  '/api/v1/{region}/bean/import/provider/{providerName}/sync': {
+    post: {
+      req: ProviderSyncControllerSyncData;
       res: {
         /**
-         * List of platforms with binding and account counts
+         * Sync completed successfully
          */
-        200: unknown;
-      };
-    };
-    post: {
-      req: PlatformControllerCreateData;
-      res: {
+        200: ProviderSyncResponseDto;
         /**
-         * Platform created successfully
+         * Invalid request data
          */
-        201: unknown;
+        400: unknown;
         /**
-         * Platform already exists
+         * Missing or invalid authentication
          */
-        409: unknown;
-      };
-    };
-  };
-  '/api/v1/bean/platforms/list': {
-    get: {
-      res: {
+        401: unknown;
         /**
-         * List of platforms with user binding status
+         * Provider not supported
          */
-        200: unknown;
+        404: unknown;
       };
     };
   };
-  '/api/v1/bean/platforms/match': {
+  '/api/v1/{region}/bean/import/provider/supported': {
     get: {
-      req: PlatformControllerMatchPlatformsData;
+      req: ProviderSyncControllerGetSupportedProvidersData;
       res: {
         /**
-         * List of matching platforms with suggested segment names
+         * List of supported providers
          */
-        200: unknown;
+        200: SupportedProvidersResponseDto;
+        /**
+         * Missing or invalid authentication
+         */
+        401: unknown;
       };
     };
   };
-  '/api/v1/bean/platforms/{id}': {
-    put: {
-      req: PlatformControllerUpdateData;
+  '/api/v1/{region}/bean/import/provider/{providerName}/supported': {
+    get: {
+      req: ProviderSyncControllerIsProviderSupportedData;
       res: {
         /**
-         * Platform updated successfully
+         * Provider support status
          */
         200: unknown;
         /**
-         * Platform not found
+         * Missing or invalid authentication
          */
-        404: unknown;
+        401: unknown;
       };
     };
-    delete: {
-      req: PlatformControllerDeleteData;
+  };
+  '/api/v1/{region}/bean/external-account-links': {
+    post: {
+      req: ExternalAccountLinkControllerCreateData;
       res: {
         /**
-         * Platform deleted successfully
+         * Link created.
          */
-        204: void;
+        201: ExternalAccountLinkResponseDto;
         /**
-         * Platform not found
+         * beanAccountId not owned, or an active link already exists.
          */
-        404: unknown;
+        422: unknown;
       };
     };
-  };
-  '/api/v1/{region}/bean/import/provider/{providerName}/sync': {
-    post: {
-      req: ProviderSyncControllerSyncData;
+    get: {
+      req: ExternalAccountLinkControllerFindAllData;
       res: {
         /**
-         * Sync completed successfully
+         * Links retrieved.
          */
-        200: ProviderSyncResponseDto;
-        /**
-         * Invalid request data
-         */
-        400: unknown;
-        /**
-         * Missing or invalid authentication
-         */
-        401: unknown;
-        /**
-         * Provider not supported
-         */
-        404: unknown;
+        200: ExternalAccountLinkListResponseDto;
       };
     };
   };
-  '/api/v1/{region}/bean/import/provider/supported': {
+  '/api/v1/{region}/bean/external-account-links/{id}': {
     get: {
-      req: ProviderSyncControllerGetSupportedProvidersData;
+      req: ExternalAccountLinkControllerFindOneData;
       res: {
         /**
-         * List of supported providers
+         * Link retrieved.
          */
-        200: SupportedProvidersResponseDto;
+        200: ExternalAccountLinkResponseDto;
         /**
-         * Missing or invalid authentication
+         * Link not found or not owned by the user.
          */
-        401: unknown;
+        422: unknown;
       };
     };
-  };
-  '/api/v1/{region}/bean/import/provider/{providerName}/supported': {
-    get: {
-      req: ProviderSyncControllerIsProviderSupportedData;
+    delete: {
+      req: ExternalAccountLinkControllerRemoveData;
       res: {
         /**
-         * Provider support status
-         */
-        200: unknown;
-        /**
-         * Missing or invalid authentication
+         * Link soft-deleted; historical transactions are unaffected.
          */
-        401: unknown;
+        204: void;
       };
     };
   };
@@ -8840,6 +9318,78 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/bean/platforms': {
+    get: {
+      res: {
+        /**
+         * List of platforms with binding and account counts
+         */
+        200: unknown;
+      };
+    };
+    post: {
+      req: PlatformControllerCreateData;
+      res: {
+        /**
+         * Platform created successfully
+         */
+        201: unknown;
+        /**
+         * Platform already exists
+         */
+        409: unknown;
+      };
+    };
+  };
+  '/api/v1/bean/platforms/list': {
+    get: {
+      res: {
+        /**
+         * List of platforms with user binding status
+         */
+        200: unknown;
+      };
+    };
+  };
+  '/api/v1/bean/platforms/match': {
+    get: {
+      req: PlatformControllerMatchPlatformsData;
+      res: {
+        /**
+         * List of matching platforms with suggested segment names
+         */
+        200: unknown;
+      };
+    };
+  };
+  '/api/v1/bean/platforms/{id}': {
+    put: {
+      req: PlatformControllerUpdateData;
+      res: {
+        /**
+         * Platform updated successfully
+         */
+        200: unknown;
+        /**
+         * Platform not found
+         */
+        404: unknown;
+      };
+    };
+    delete: {
+      req: PlatformControllerDeleteData;
+      res: {
+        /**
+         * Platform deleted successfully
+         */
+        204: void;
+        /**
+         * Platform not found
+         */
+        404: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/dashboard/net-worth': {
     get: {
       req: DashboardControllerGetNetWorthData;
@@ -8930,90 +9480,6 @@ export type $OpenApiTs = {
       };
     };
   };
-  '/api/v1/{region}/bean/prices': {
-    post: {
-      req: PriceControllerCreateData;
-      res: {
-        /**
-         * Price created successfully
-         */
-        201: PriceResponseDto;
-        /**
-         * Currency or quoteCurrency commodity not found
-         */
-        404: unknown;
-        /**
-         * Price already exists for this currency pair and date
-         */
-        409: unknown;
-      };
-    };
-    get: {
-      req: PriceControllerFindAllData;
-      res: {
-        /**
-         * Prices retrieved successfully
-         */
-        200: PriceListResponseDto;
-      };
-    };
-  };
-  '/api/v1/{region}/bean/prices/{id}': {
-    get: {
-      req: PriceControllerFindOneData;
-      res: {
-        /**
-         * Price retrieved successfully
-         */
-        200: PriceResponseDto;
-        /**
-         * Price not found
-         */
-        404: unknown;
-      };
-    };
-    put: {
-      req: PriceControllerUpdateData;
-      res: {
-        /**
-         * Price updated successfully
-         */
-        200: PriceResponseDto;
-        /**
-         * Price not found
-         */
-        404: unknown;
-        /**
-         * Updated price conflicts with existing price
-         */
-        409: unknown;
-      };
-    };
-    delete: {
-      req: PriceControllerDeleteData;
-      res: {
-        /**
-         * Price deleted successfully
-         */
-        204: void;
-        /**
-         * Price not found
-         */
-        404: unknown;
-      };
-    };
-  };
-  '/api/v1/{region}/bean/prices/bulk': {
-    post: {
-      req: PriceControllerBulkCreateData;
-      res: {
-        /**
-         * Prices created successfully
-         */
-        201: Array<PriceResponseDto>;
-      };
-    };
-  };
   '/api/v1/{region}/reporting/portfolio/trends': {
     get: {
       req: ReportingControllerGetPortfolioTrendsData;