@firela/api-types 0.0.0-canary.aa5c64ec → 0.0.0-canary.addbab34

package/src/generated/types.gen.ts

@@ -164,9 +164,7 @@ export type AccountResponseDto = {
   /**
    * Platform ID (null if unbound)
    */
-  platformId?: {
-    [key: string]: unknown;
-  };
+  platformId?: string;
   /**
    * Platform details (populated if platformId is set)
    */
@@ -327,15 +325,27 @@ export type AccountStandardResponseDto = {
    */
   type: 'Assets' | 'Liabilities' | 'Income' | 'Expenses' | 'Equity';
   /**
-   * Short localized display name
+   * Short display name. Universal rows project to the request locale (Accept-Language); regional rows keep the authored native name — mixed-language by design (ADR-0131 class P vs class A).
    */
   name?: string;
   /**
-   * Account description (stable semantics only)
+   * Authored market-language alternative names delivered verbatim (not localized copy, not xlf-managed, not locale-projected). Flat string[] per ADR-0129 D1; ADR-0131 class A.
+   */
+  aliases?: Array<string>;
+  /**
+   * Locale-projected search synonyms (e.g. the zh bank-card / debit-card everyday terms for the checking account). Pure-locale projection — absent when the locale has no seeded synonyms; English fallback rides the authored aliases field. Search-only vocabulary, not the NLP routing corpus (#698, ADR-0131 fourth-class adjudication).
+   */
+  searchTerms?: Array<string>;
+  /**
+   * Product denomination as a 3-letter ISO 4217 code, authored market data delivered verbatim (not localized, not xlf-managed). ADR-0131 class A. Absent = single-currency not asserted — consumers fall back to their own region currency (#714).
+   */
+  currency?: string;
+  /**
+   * Account description (stable semantics only). Mixed-language contract: universal rows project to the request locale via the accountDesc xlf axis with an en fallback (ADR-0131 class P, ADR-0132; unseeded locales falling back to English are expected); regional rows deliver the authored market language (ADR-0131 class A, verbatim, never xlf-managed).
    */
   description: string;
   /**
-   * Account tags for categorization
+   * Account tags for categorization — structured metadata delivered verbatim (not localized, not xlf-managed). ADR-0131 class A.
    */
   tags: Array<string>;
   /**
@@ -595,7 +605,7 @@ export type PostingResponseDto = {
    */
   account: string;
   /**
-   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
+   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned. Carries the raw Beancount sign (credit-normal accounts such as Income post negative — the accounting truth, ADR-0126); renderers must not infer economic semantics from this sign.
    */
   units?: string;
   /**
@@ -830,7 +840,7 @@ export type PostingDetailDto = {
    */
   account: string;
   /**
-   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
+   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned. Carries the raw Beancount sign (credit-normal accounts such as Income post negative — the accounting truth, ADR-0126); renderers must not infer economic semantics from this sign.
    */
   units?: string;
   /**
@@ -976,6 +986,101 @@ export type flag2 =
  */
 export type status2 = 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
 
+export type TransactionListItemDto = {
+  /**
+   * Transaction ID
+   */
+  id: string;
+  /**
+   * Transaction date
+   */
+  date: string;
+  /**
+   * Transaction flag
+   */
+  flag?:
+    | 'CLEARED'
+    | 'PENDING'
+    | 'PADDING'
+    | 'SUMMARIZE'
+    | 'TRANSFER'
+    | 'CONVERSIONS';
+  /**
+   * Custom flag (if not using standard flags)
+   */
+  customFlag?: string;
+  /**
+   * Payee name
+   */
+  payee?: string;
+  /**
+   * Transaction narration
+   */
+  narration: string;
+  /**
+   * Transaction tags
+   */
+  tags: Array<string>;
+  /**
+   * Transaction links
+   */
+  links: Array<string>;
+  /**
+   * Transaction metadata
+   */
+  meta?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Transaction status
+   */
+  status: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
+  /**
+   * Source type (free-form string from transaction metadata, e.g. import, api)
+   */
+  sourceType?: string;
+  /**
+   * Source platform (e.g., alipay, wechat)
+   */
+  sourcePlatform?: string;
+  /**
+   * Transaction postings
+   */
+  postings: Array<PostingDetailDto>;
+  /**
+   * Created at timestamp
+   */
+  createdAt: string;
+  /**
+   * Voided at timestamp (if voided)
+   */
+  voidedAt?: string;
+  /**
+   * User ID who voided this transaction
+   */
+  voidedBy?: string;
+  /**
+   * Correction reason (if voided or superseded)
+   */
+  correctionReason?: string;
+  /**
+   * ID of the transaction that supersedes this one (set when status=SUPERSEDED)
+   */
+  supersededBy?: string;
+  /**
+   * ID of the transaction this one corrected/replaced (back-link on the replacement)
+   */
+  originalTxn?: string;
+  /**
+   * Row amount under the request viewpoint (ADR-0126). Category viewpoint (category + flow): per-leg sign-normalized sum over the category account set (Income-root legs negated, Expenses-root identity) — positive under normal booking but NOT clamped (explicit negative expense legs and net-flip refund months stay negative). No viewpoint (plain list / search, no accountId): wallet money-flow net = raw-sign sum over cost-less Assets/Liabilities legs (income positive, expenses negative, transfers net ~0); color cue is the wallet sign (net < 0 = wealth-decreasing). Status-orthogonal: audit views match too (ADR-0128 amount-as-matching-key). Omitted under the account viewpoint (incl. dual) and for rows with no wallet leg.
+   */
+  viewpointAmount?: string;
+  /**
+   * Currency of viewpointAmount. A row spanning multiple currencies takes the largest-magnitude currency group (known simplification, ADR-0126).
+   */
+  viewpointCurrency?: string;
+};
+
 export type BalanceByCurrencyDto = {
   /**
    * ISO 4217 currency code
@@ -1004,7 +1109,7 @@ export type ExchangeRateWarningDto = {
 
 export type TransactionListSummaryDto = {
   /**
-   * Partial converted total in base currency (rated currencies only, raw Beancount sign). When warnings is non-empty this excludes currencies missing an FX rate; may be "0.00" if ALL non-base currencies lack a rate. Converted at the dateTo (or current) available rate.
+   * Partial converted total in base currency (rated currencies only). Sign by viewpoint (ADR-0126): account viewpoint keeps the raw Beancount sign (income negative); category viewpoint is per-leg sign-normalized (Income legs negated, Expenses legs identity — positive under normal booking, not clamped). When warnings is non-empty this excludes currencies missing an FX rate; may be "0.00" if ALL non-base currencies lack a rate. Converted at the dateTo (or current) available rate.
    */
   totalAmount: string;
   /**
@@ -1021,11 +1126,32 @@ export type TransactionListSummaryDto = {
   warnings?: Array<ExchangeRateWarningDto>;
 };
 
+export type TransactionListViewpointDto = {
+  /**
+   * Viewpoint type (only category drill-down carries a viewpoint today)
+   */
+  type: 'category';
+  /**
+   * Flow root the category account set is restricted to
+   */
+  flow: 'income' | 'expense';
+};
+
+/**
+ * Viewpoint type (only category drill-down carries a viewpoint today)
+ */
+export type type2 = 'category';
+
+/**
+ * Flow root the category account set is restricted to
+ */
+export type flow = 'income' | 'expense';
+
 export type TransactionListResponseDto = {
   /**
    * List of transactions
    */
-  data: Array<TransactionDetailDto>;
+  data: Array<TransactionListItemDto>;
   /**
    * Total count of matching transactions
    */
@@ -1042,6 +1168,10 @@ export type TransactionListResponseDto = {
    * Amount summary for the full filtered set (#514). Present only when the request has a single account OR category viewpoint; omitted for search-only / plain-list / dual-perspective requests.
    */
   summary?: TransactionListSummaryDto;
+  /**
+   * Viewpoint metadata (ADR-0126). Present only for a single category filter (category + flow, no accountId); dual-perspective requests are viewpoint-less (raw signs, no viewpointAmount).
+   */
+  viewpoint?: TransactionListViewpointDto;
 };
 
 export type TagSuggestionDto = {
@@ -1253,7 +1383,7 @@ export type ReviewSummaryDto = {
 /**
  * Review type
  */
-export type type2 =
+export type type3 =
   | 'DUPLICATE'
   | 'RULE_MATCH'
   | 'PAYEE_MATCH'
@@ -1701,7 +1831,7 @@ export type UpdatePayeeDto = {
    */
   customTags?: Array<string>;
   /**
-   * Metadata for extended information (location, notes, contact info, etc.). Will merge with existing metadata.
+   * Metadata for extended information (location, notes, contact info, etc.)
    */
   meta?: {
     [key: string]: unknown;
@@ -2094,481 +2224,449 @@ export type UpdateCommodityDto = {
   };
 };
 
-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?: {
-    [key: string]: unknown;
-  };
-};
-
-export type PriceResponseDto = {
+  change?: string;
   /**
-   * 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;
+  endValue: string;
   /**
-   * Price date (ISO 8601 format). Represents the date this price was valid.
+   * Total change over period
    */
-  date: string;
+  totalChange: string;
   /**
-   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
+   * Total change percentage
    */
-  meta: {
-    [key: string]: unknown;
-  };
+  totalChangePercentage: string;
+};
+
+export type MultiCurrencyPointDto = {
   /**
-   * Creation timestamp
+   * Date in YYYY-MM-DD format
    */
-  createdAt: string;
+  date: string;
   /**
-   * Last update timestamp
+   * Balances by currency
    */
-  updatedAt: string;
+  byCurrency: Array<CurrencyBalanceDto>;
 };
 
-export type PriceListResponseDto = {
+export type PortfolioTrendsResponseDto = {
   /**
-   * List of prices
+   * Time series data points
    */
-  items: Array<PriceResponseDto>;
+  series: Array<TimeSeriesPointDto>;
   /**
-   * Total number of prices
+   * Period summary
    */
-  total: number;
-};
-
-export type UpdateBeanPriceDto = {
+  summary: TrendSummaryDto;
   /**
-   * Currency being priced
+   * Period requested
    */
-  currency?: string;
+  period: string;
   /**
-   * Quote currency (pricing currency)
+   * Data granularity
    */
-  quoteCurrency?: string;
+  granularity: string;
   /**
-   * Price amount (MUST be >= 0 per Beancount spec)
+   * Base currency for converted values
    */
-  amount?: number;
+  currency: string;
   /**
-   * Price date (ISO 8601 format)
+   * Multi-currency time series (each point has currency breakdown)
    */
-  date?: string;
+  byCurrency?: Array<MultiCurrencyPointDto>;
   /**
-   * Metadata
+   * Exchange rate warnings
    */
-  metadata?: {
-    [key: string]: unknown;
-  };
+  warnings?: Array<ExchangeRateWarningDto>;
 };
 
-export type CreateRecurringRuleDto = {
+export type CashFlowPointDto = {
   /**
-   * Rule name (unique per user)
+   * Month key (YYYY-MM)
    */
-  name: string;
+  month: string;
   /**
-   * Icon emoji
+   * Income in base currency (absolute, converted)
    */
-  icon?: string;
+  income: string;
   /**
-   * Recurring frequency
+   * Expense in base currency (absolute, converted)
    */
-  frequency:
-    | 'WEEKLY'
-    | 'BIWEEKLY'
-    | 'MONTHLY'
-    | 'BIMONTHLY'
-    | 'QUARTERLY'
-    | 'YEARLY'
-    | 'CUSTOM';
+  expense: string;
   /**
-   * Expected amount (positive number)
+   * netSavings = income − expense (savings positive)
    */
-  expectedAmount: number;
+  netSavings: string;
+};
+
+export type CashFlowTrendSummaryDto = {
   /**
-   * Expected day of month (1-31)
+   * Total income across the period
    */
-  expectedDay?: number;
+  totalIncome: string;
   /**
-   * Custom interval in days (required for CUSTOM frequency)
-   */
-  customIntervalDays?: number;
-  /**
-   * Currency code
+   * Total expense across the period
    */
-  currency: string;
+  totalExpense: string;
   /**
-   * Payee matching pattern (supports wildcards)
+   * income − expense across the period
    */
-  matchPayeePattern?: string;
+  totalNetSavings: string;
   /**
-   * Amount tolerance percentage (0-1)
+   * totalNetSavings divided by the window length (N months, incl. zero-filled)
    */
-  matchAmountTolerance: number;
+  averageMonthlyNetSavings: string;
+};
+
+export type CashFlowTrendsResponseDto = {
   /**
-   * Default expense account for auto-create
+   * Monthly cash-flow series (fixed N-month window, zero-filled)
    */
-  defaultExpenseAccount?: string;
+  series: Array<CashFlowPointDto>;
   /**
-   * Default payment account for auto-create
+   * Period totals
    */
-  defaultPaymentAccount?: string;
+  summary: CashFlowTrendSummaryDto;
   /**
-   * Default payee for auto-create
+   * Period requested
    */
-  defaultPayee?: string;
+  period: string;
   /**
-   * Auto-create transaction when expected date arrives
+   * Data granularity (v1 returns month buckets)
    */
-  autoCreate: boolean;
+  granularity: string;
   /**
-   * Rule start date (ISO format)
+   * Base currency for converted values
    */
-  startDate?: string;
+  currency: string;
   /**
-   * Rule end date (ISO format)
+   * Exchange rate warnings (e.g. missing rate for a currency)
    */
-  endDate?: string;
+  warnings?: Array<ExchangeRateWarningDto>;
 };
 
-/**
- * Recurring frequency
- */
-export type frequency =
-  | 'WEEKLY'
-  | 'BIWEEKLY'
-  | 'MONTHLY'
-  | 'BIMONTHLY'
-  | 'QUARTERLY'
-  | 'YEARLY'
-  | 'CUSTOM';
+export type GenerateSnapshotBody = unknown;
 
-export type RecurringRuleResponseDto = {
-  /**
-   * Rule ID
-   */
-  id: string;
-  /**
-   * User ID
-   */
-  userId: string;
+export type GenerateSnapshotResponse = unknown;
+
+export type BackfillSnapshotsBody = unknown;
+
+export type BackfillSnapshotsResponse = unknown;
+
+export type CreateBeanPriceDto = {
   /**
-   * Rule name
+   * Currency being priced (e.g., USD, AAPL, BTC)
    */
-  name: string;
+  currency: string;
   /**
-   * Icon emoji
+   * Quote currency (pricing currency, e.g., CNY, EUR)
    */
-  icon?: {
-    [key: string]: unknown;
-  };
+  quoteCurrency: string;
   /**
-   * Recurring frequency
+   * Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.
    */
-  frequency: string;
+  amount: number;
   /**
-   * Expected amount
+   * Price date (ISO 8601 format)
    */
-  expectedAmount: number;
+  date: string;
   /**
-   * Expected day of month
+   * Metadata (validated by Zod schema, max field lengths enforced)
    */
-  expectedDay?: {
+  metadata?: {
     [key: string]: unknown;
   };
+};
+
+export type PriceResponseDto = {
   /**
-   * Custom interval in days
+   * Unique identifier
    */
-  customIntervalDays?: {
-    [key: string]: unknown;
-  };
+  id: string;
   /**
-   * Currency code
+   * User ID (owner of the price)
+   */
+  userId: string;
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
    */
   currency: string;
   /**
-   * Payee matching pattern
+   * Quote currency (pricing currency, e.g., USD, CNY)
    */
-  matchPayeePattern?: {
-    [key: string]: unknown;
-  };
+  quoteCurrency: string;
   /**
-   * Amount tolerance percentage
+   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
    */
-  matchAmountTolerance: number;
+  amount: number;
   /**
-   * Default expense account
+   * Price date (ISO 8601 format). Represents the date this price was valid.
    */
-  defaultExpenseAccount?: {
-    [key: string]: unknown;
-  };
+  date: string;
   /**
-   * Default payment account
+   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
    */
-  defaultPaymentAccount?: {
+  meta: {
     [key: string]: unknown;
   };
   /**
-   * Default payee
+   * Creation timestamp
    */
-  defaultPayee?: {
-    [key: string]: unknown;
-  };
+  createdAt: string;
   /**
-   * Whether rule is active
+   * Last update timestamp
    */
-  isActive: boolean;
+  updatedAt: string;
+};
+
+export type PriceListResponseDto = {
   /**
-   * Rule start date (YYYY-MM-DD)
+   * List of prices
    */
-  startDate: string;
+  items: Array<PriceResponseDto>;
   /**
-   * Rule end date (YYYY-MM-DD)
+   * Total number of prices
    */
-  endDate?: {
-    [key: string]: unknown;
-  };
+  total: number;
+};
+
+export type UpdateBeanPriceDto = {
   /**
-   * Auto-create transaction on expected date
+   * Currency being priced
    */
-  autoCreate: boolean;
+  currency?: string;
   /**
-   * Last matched occurrence date (YYYY-MM-DD)
+   * Quote currency (pricing currency)
    */
-  lastOccurrence?: {
-    [key: string]: unknown;
-  };
+  quoteCurrency?: string;
   /**
-   * Total matched transactions count
+   * Price amount (MUST be >= 0 per Beancount spec)
    */
-  totalCount: number;
+  amount?: number;
   /**
-   * Created at timestamp
+   * Price date (ISO 8601 format)
    */
-  createdAt: string;
+  date?: string;
   /**
-   * Updated at timestamp
+   * Metadata
    */
-  updatedAt: string;
+  metadata?: {
+    [key: string]: unknown;
+  };
 };
 
-export type CreateRuleFromTransactionDto = {
-  /**
-   * Recurring frequency
-   */
-  frequency:
-    | 'WEEKLY'
-    | 'BIWEEKLY'
-    | 'MONTHLY'
-    | 'BIMONTHLY'
-    | 'QUARTERLY'
-    | 'YEARLY'
-    | 'CUSTOM';
-  /**
-   * Optional name override (default: transaction payee)
-   */
-  name?: string;
+export type DeleteOwnUserDto = {
   /**
-   * Optional icon emoji
+   * Access token for user verification
    */
-  icon?: string;
+  accessToken: string;
 };
 
-export type RecurringRuleWithStatsResponseDto = {
+export type UserSettingsResponseDto = {
   /**
-   * Rule ID
+   * Stored base currency choice (ISO 4217) for net-worth/report aggregation. null = user never chose; aggregates fall back to the region default at display time (#713).
    */
-  id: string;
+  baseCurrency: string | null;
+};
+
+export type UserResponseDto = {
   /**
    * User ID
    */
-  userId: string;
-  /**
-   * Rule name
-   */
-  name: string;
+  id: string;
   /**
-   * Icon emoji
+   * Assigned user role
    */
-  icon?: {
-    [key: string]: unknown;
-  };
+  role: string;
   /**
-   * Recurring frequency
+   * Permission strings
    */
-  frequency: string;
+  permissions: Array<string>;
   /**
-   * Expected amount
+   * User settings
    */
-  expectedAmount: number;
+  settings: UserSettingsResponseDto;
+};
+
+export type SignupDto = {
   /**
-   * Expected day of month
+   * Cloudflare Turnstile verification token (optional when Turnstile disabled)
    */
-  expectedDay?: {
-    [key: string]: unknown;
-  };
+  turnstileToken?: string;
+};
+
+export type SignupResponseDto = {
   /**
-   * Custom interval in days
+   * JWT auth token
    */
-  customIntervalDays?: {
-    [key: string]: unknown;
-  };
+  authToken: string;
   /**
-   * Currency code
+   * Auto-generated access token
    */
-  currency: string;
+  accessToken: string;
   /**
-   * Payee matching pattern
+   * Assigned user role
    */
-  matchPayeePattern?: {
-    [key: string]: unknown;
-  };
+  role: 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
+};
+
+/**
+ * Assigned user role
+ */
+export type role = 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
+
+export type UpdateUserSettingDto = {
   /**
-   * Amount tolerance percentage
+   * Security ID
    */
-  matchAmountTolerance: number;
+  secId?: number;
   /**
-   * Default expense account
+   * Annual interest rate
    */
-  defaultExpenseAccount?: {
-    [key: string]: unknown;
-  };
+  annualInterestRate?: number;
   /**
-   * Default payment account
+   * Currency code
    */
-  defaultPaymentAccount?: {
-    [key: string]: unknown;
-  };
+  currency?: string;
   /**
-   * Default payee
+   * Base currency code
    */
-  defaultPayee?: {
-    [key: string]: unknown;
-  };
+  baseCurrency?: string;
   /**
-   * Whether rule is active
+   * Benchmark symbol
    */
-  isActive: boolean;
+  benchmark?: string;
   /**
-   * Rule start date (YYYY-MM-DD)
+   * Color scheme
    */
-  startDate: string;
+  colorScheme?: 'DARK' | 'LIGHT';
   /**
-   * Rule end date (YYYY-MM-DD)
+   * Date range filter
    */
-  endDate?: {
-    [key: string]: unknown;
-  };
+  dateRange?: string;
   /**
-   * Auto-create transaction on expected date
+   * Emergency fund amount
    */
-  autoCreate: boolean;
+  emergencyFund?: number;
   /**
-   * Last matched occurrence date (YYYY-MM-DD)
+   * Account filter IDs
    */
-  lastOccurrence?: {
-    [key: string]: unknown;
-  };
+  'filters.accounts'?: Array<string>;
   /**
-   * Total matched transactions count
+   * Asset class filters
    */
-  totalCount: number;
+  'filters.assetClasses'?: Array<string>;
   /**
-   * Created at timestamp
+   * Data source filter
    */
-  createdAt: string;
+  'filters.dataSource'?: string;
   /**
-   * Updated at timestamp
+   * Symbol filter
    */
-  updatedAt: string;
+  'filters.symbol'?: string;
   /**
-   * Number of pending expected transactions
+   * Tag filters
    */
-  pendingCount: number;
+  'filters.tags'?: Array<string>;
   /**
-   * Number of overdue expected transactions
+   * Enable experimental features
    */
-  overdueCount: number;
+  isExperimentalFeatures?: boolean;
   /**
-   * Next expected date (YYYY-MM-DD)
+   * Enable restricted view mode
    */
-  nextExpectedDate?: {
-    [key: string]: unknown;
-  };
+  isRestrictedView?: boolean;
   /**
-   * Total amount of all matched transactions
+   * Language code
    */
-  totalAmount: number;
+  language?: string;
   /**
-   * Average amount per transaction
+   * Locale code
    */
-  averageAmount: number;
+  locale?: string;
   /**
-   * Number of matched transactions
+   * Projected total amount
    */
-  transactionCount: number;
+  projectedTotalAmount?: number;
   /**
-   * First matched transaction date (YYYY-MM-DD)
+   * Retirement date in ISO 8601 format
    */
-  firstDate?: {
-    [key: string]: unknown;
-  };
+  retirementDate?: string;
   /**
-   * Last matched transaction date (YYYY-MM-DD)
+   * Savings rate percentage
    */
-  lastDate?: {
-    [key: string]: unknown;
-  };
+  savingsRate?: number;
   /**
-   * Amount variance (standard deviation squared)
+   * View mode
    */
-  variance: number;
+  viewMode?: 'DEFAULT' | 'ZEN';
+};
+
+/**
+ * Color scheme
+ */
+export type colorScheme = 'DARK' | 'LIGHT';
+
+/**
+ * View mode
+ */
+export type viewMode = 'DEFAULT' | 'ZEN';
+
+export type UpdatePropertyDto = {
   /**
-   * Number of upcoming expected transactions
+   * Property value
    */
-  upcomingCount: number;
+  value: string;
 };
 
-export type UpdateRecurringRuleDto = {
+export type CreateRecurringRuleDto = {
   /**
-   * Rule name
+   * Rule name (unique per user)
    */
-  name?: string;
+  name: string;
   /**
    * Icon emoji
    */
@@ -2576,7 +2674,7 @@ export type UpdateRecurringRuleDto = {
   /**
    * Recurring frequency
    */
-  frequency?:
+  frequency:
     | 'WEEKLY'
     | 'BIWEEKLY'
     | 'MONTHLY'
@@ -2585,15 +2683,15 @@ export type UpdateRecurringRuleDto = {
     | 'YEARLY'
     | 'CUSTOM';
   /**
-   * Expected amount
+   * Expected amount (positive number)
    */
-  expectedAmount?: number;
+  expectedAmount: number;
   /**
    * Expected day of month (1-31)
    */
   expectedDay?: number;
   /**
-   * Custom interval in days
+   * Custom interval in days (required for CUSTOM frequency)
    */
   customIntervalDays?: number;
   /**
@@ -2601,111 +2699,132 @@ export type UpdateRecurringRuleDto = {
    */
   currency?: string;
   /**
-   * Payee matching pattern
+   * Payee matching pattern (supports wildcards)
    */
   matchPayeePattern?: string;
   /**
    * Amount tolerance percentage (0-1)
    */
-  matchAmountTolerance?: number;
+  matchAmountTolerance: number;
   /**
-   * Default expense account
+   * Default expense account for auto-create
    */
   defaultExpenseAccount?: string;
   /**
-   * Default payment account
+   * Default payment account for auto-create
    */
   defaultPaymentAccount?: string;
   /**
-   * Default payee
+   * Default payee for auto-create
    */
   defaultPayee?: string;
   /**
-   * Auto-create transaction
+   * Auto-create transaction when expected date arrives
    */
-  autoCreate?: boolean;
+  autoCreate: boolean;
   /**
-   * Rule active status
+   * Rule start date (ISO format)
    */
-  isActive?: boolean;
+  startDate?: string;
   /**
    * Rule end date (ISO format)
    */
   endDate?: string;
 };
 
-export type ExpectedTransactionRuleDto = {
+/**
+ * Recurring frequency
+ */
+export type frequency =
+  | 'WEEKLY'
+  | 'BIWEEKLY'
+  | 'MONTHLY'
+  | 'BIMONTHLY'
+  | 'QUARTERLY'
+  | 'YEARLY'
+  | 'CUSTOM';
+
+export type RecurringRuleResponseDto = {
+  /**
+   * Rule ID
+   */
+  id: string;
+  /**
+   * User ID
+   */
+  userId: string;
   /**
    * Rule name
    */
   name: string;
   /**
-   * Rule icon
+   * Icon emoji
    */
-  icon?: {
-    [key: string]: unknown;
-  };
+  icon?: string;
   /**
-   * Rule frequency
+   * Recurring frequency
    */
   frequency: string;
+  /**
+   * Expected amount
+   */
+  expectedAmount: number;
+  /**
+   * Expected day of month
+   */
+  expectedDay?: number;
+  /**
+   * Custom interval in days
+   */
+  customIntervalDays?: number;
   /**
    * Currency code
    */
   currency: string;
-};
-
-export type ExpectedTransactionResponseDto = {
   /**
-   * Expected transaction ID
+   * Payee matching pattern
    */
-  id: string;
+  matchPayeePattern?: string;
   /**
-   * User ID
+   * Amount tolerance percentage
    */
-  userId: string;
+  matchAmountTolerance: number;
   /**
-   * Associated rule ID
+   * Default expense account
    */
-  ruleId: string;
+  defaultExpenseAccount?: string;
   /**
-   * Expected date (YYYY-MM-DD)
+   * Default payment account
    */
-  expectedDate: string;
+  defaultPaymentAccount?: string;
   /**
-   * Expected amount
+   * Default payee
    */
-  expectedAmount: number;
+  defaultPayee?: string;
   /**
-   * Status (PENDING, COMPLETED, SKIPPED)
+   * Whether rule is active
    */
-  status: string;
+  isActive: boolean;
   /**
-   * Matched transaction ID
+   * Rule start date (YYYY-MM-DD)
    */
-  matchedTransactionId?: {
-    [key: string]: unknown;
-  };
+  startDate: string;
   /**
-   * Match timestamp (ISO 8601)
+   * Rule end date (YYYY-MM-DD)
    */
-  matchedAt?: {
-    [key: string]: unknown;
-  };
+  endDate?: string;
   /**
-   * Match confidence score (0-1)
+   * Auto-create transaction on expected date
    */
-  matchConfidence?: {
-    [key: string]: unknown;
-  };
+  autoCreate: boolean;
   /**
-   * Whether this expected transaction is overdue
+   * Last matched occurrence date (YYYY-MM-DD)
    */
-  isOverdue: boolean;
+  lastOccurrence?: string;
   /**
-   * Rule information
+   * Total matched transactions count
    */
-  rule: ExpectedTransactionRuleDto;
+  totalCount: number;
   /**
    * Created at timestamp
    */
@@ -2716,435 +2835,420 @@ export type ExpectedTransactionResponseDto = {
   updatedAt: string;
 };
 
-export type ExpectedTransactionListResponseDto = {
-  items: Array<ExpectedTransactionResponseDto>;
+export type CreateRuleFromTransactionDto = {
   /**
-   * Total count
+   * Recurring frequency
    */
-  total: number;
-};
-
-export type ConfirmMatchDto = {
+  frequency:
+    | 'WEEKLY'
+    | 'BIWEEKLY'
+    | 'MONTHLY'
+    | 'BIMONTHLY'
+    | 'QUARTERLY'
+    | 'YEARLY'
+    | 'CUSTOM';
   /**
-   * Transaction ID to match with
+   * Optional name override (default: transaction payee)
    */
-  transactionId: string;
+  name?: string;
+  /**
+   * Optional icon emoji
+   */
+  icon?: string;
 };
 
-export type EnterNowDto = {
+export type RecurringRuleWithStatsResponseDto = {
   /**
-   * Override expense account (uses rule default if not provided)
+   * Rule ID
    */
-  expenseAccount?: string;
+  id: string;
   /**
-   * Override payment account (uses rule default if not provided)
+   * User ID
    */
-  paymentAccount?: string;
+  userId: string;
   /**
-   * Override amount (uses expected amount if not provided)
+   * Rule name
    */
-  amount?: number;
+  name: string;
   /**
-   * Override payee (uses rule default if not provided)
+   * Icon emoji
    */
-  payee?: string;
+  icon?: string;
   /**
-   * Optional narration
+   * Recurring frequency
    */
-  narration?: string;
-};
-
-export type ForecastItemDto = {
+  frequency: string;
   /**
-   * Rule name
+   * Expected amount
    */
-  rule: string;
+  expectedAmount: number;
   /**
-   * Rule ID
+   * Expected day of month
    */
-  ruleId: string;
+  expectedDay?: number;
   /**
-   * Expected amount
+   * Custom interval in days
    */
-  amount: number;
+  customIntervalDays?: number;
   /**
-   * Expected date (YYYY-MM-DD)
+   * Currency code
    */
-  date: string;
+  currency: string;
   /**
-   * Rule icon emoji
+   * Payee matching pattern
    */
-  icon: string | null;
+  matchPayeePattern?: string;
   /**
-   * Currency code
+   * Amount tolerance percentage
    */
-  currency: string;
-};
-
-export type MonthlyForecastDto = {
+  matchAmountTolerance: number;
   /**
-   * Month (YYYY-MM)
+   * Default expense account
    */
-  month: string;
+  defaultExpenseAccount?: string;
   /**
-   * Total expected outflow for the month
+   * Default payment account
    */
-  expectedOutflow: number;
+  defaultPaymentAccount?: string;
   /**
-   * Number of expected transactions
+   * Default payee
    */
-  itemCount: number;
+  defaultPayee?: string;
+  /**
+   * Whether rule is active
+   */
+  isActive: boolean;
+  /**
+   * Rule start date (YYYY-MM-DD)
+   */
+  startDate: string;
   /**
-   * Breakdown by currency
+   * Rule end date (YYYY-MM-DD)
    */
-  byCurrency: {
-    [key: string]: unknown;
-  };
+  endDate?: string;
   /**
-   * Individual forecast items
+   * Auto-create transaction on expected date
    */
-  items: Array<ForecastItemDto>;
-};
-
-export type ForecastResponseDto = {
+  autoCreate: boolean;
   /**
-   * Monthly forecast data
+   * Last matched occurrence date (YYYY-MM-DD)
    */
-  forecast: Array<MonthlyForecastDto>;
+  lastOccurrence?: string;
   /**
-   * Total expected outflow across all months
+   * Total matched transactions count
    */
-  totalOutflow: number;
+  totalCount: number;
   /**
-   * Total by currency across all months
+   * Created at timestamp
    */
-  totalByCurrency: {
-    [key: string]: unknown;
-  };
+  createdAt: string;
   /**
-   * Number of active recurring rules included
+   * Updated at timestamp
    */
-  rulesCount: number;
+  updatedAt: string;
   /**
-   * Forecast period start date
+   * Number of pending expected transactions
    */
-  periodStart: string;
+  pendingCount: number;
   /**
-   * Forecast period end date
+   * Number of overdue expected transactions
    */
-  periodEnd: string;
-};
-
-export type CurrencyBalanceDto = {
+  overdueCount: number;
   /**
-   * ISO 4217 currency code
+   * Next expected date (YYYY-MM-DD)
    */
-  currency: string;
+  nextExpectedDate?: string;
   /**
-   * Balance amount
+   * Total amount of all matched transactions
    */
-  balance: string;
-};
-
-export type TimeSeriesPointDto = {
+  totalAmount: number;
   /**
-   * Date in YYYY-MM-DD format
+   * Average amount per transaction
    */
-  date: string;
+  averageAmount: number;
   /**
-   * Value at this date (in base currency)
+   * Number of matched transactions
    */
-  value: string;
+  transactionCount: number;
   /**
-   * Change from previous point
+   * First matched transaction date (YYYY-MM-DD)
    */
-  change?: {
-    [key: string]: unknown;
-  };
+  firstDate?: string;
   /**
-   * Total assets at this date (in base currency)
+   * Last matched transaction date (YYYY-MM-DD)
    */
-  assets?: string;
+  lastDate?: string;
   /**
-   * Total liabilities at this date (in base currency)
+   * Amount variance (standard deviation squared)
    */
-  liabilities?: string;
+  variance: number;
   /**
-   * Multi-currency breakdown for this point
+   * Number of upcoming expected transactions
    */
-  byCurrency?: Array<CurrencyBalanceDto>;
+  upcomingCount: number;
 };
 
-export type TrendSummaryDto = {
+export type UpdateRecurringRuleDto = {
   /**
-   * Value at start of period
+   * Rule name (unique per user)
    */
-  startValue: string;
+  name?: string;
   /**
-   * Value at end of period
+   * Icon emoji
    */
-  endValue: string;
+  icon?: string;
   /**
-   * Total change over period
+   * Recurring frequency
    */
-  totalChange: string;
+  frequency?:
+    | 'WEEKLY'
+    | 'BIWEEKLY'
+    | 'MONTHLY'
+    | 'BIMONTHLY'
+    | 'QUARTERLY'
+    | 'YEARLY'
+    | 'CUSTOM';
   /**
-   * Total change percentage
+   * Expected amount (positive number)
    */
-  totalChangePercentage: string;
-};
-
-export type MultiCurrencyPointDto = {
+  expectedAmount?: number;
   /**
-   * Date in YYYY-MM-DD format
+   * Expected day of month (1-31)
    */
-  date: string;
+  expectedDay?: number;
   /**
-   * Balances by currency
+   * Currency code
    */
-  byCurrency: Array<CurrencyBalanceDto>;
-};
-
-export type PortfolioTrendsResponseDto = {
+  currency?: string;
   /**
-   * Time series data points
+   * Payee matching pattern (supports wildcards)
    */
-  series: Array<TimeSeriesPointDto>;
+  matchPayeePattern?: string;
   /**
-   * Period summary
+   * Amount tolerance percentage (0-1)
    */
-  summary: TrendSummaryDto;
+  matchAmountTolerance?: number;
   /**
-   * Period requested
+   * Default expense account for auto-create
    */
-  period: string;
+  defaultExpenseAccount?: string;
   /**
-   * Data granularity
+   * Default payment account for auto-create
    */
-  granularity: string;
+  defaultPaymentAccount?: string;
   /**
-   * Base currency for converted values
+   * Default payee for auto-create
    */
-  currency: string;
+  defaultPayee?: string;
   /**
-   * Multi-currency time series (each point has currency breakdown)
+   * Auto-create transaction when expected date arrives
    */
-  byCurrency?: Array<MultiCurrencyPointDto>;
+  autoCreate?: boolean;
   /**
-   * Exchange rate warnings
+   * Rule end date (ISO format)
    */
-  warnings?: Array<ExchangeRateWarningDto>;
+  endDate?: string;
+  /**
+   * Custom interval in days
+   */
+  customIntervalDays?: number;
+  /**
+   * Rule active status
+   */
+  isActive?: boolean;
 };
 
-export type CashFlowPointDto = {
+export type ExpectedTransactionRuleDto = {
   /**
-   * Month key (YYYY-MM)
+   * Rule name
    */
-  month: string;
+  name: string;
   /**
-   * Income in base currency (absolute, converted)
+   * Rule icon
    */
-  income: string;
+  icon?: string;
   /**
-   * Expense in base currency (absolute, converted)
+   * Rule frequency
    */
-  expense: string;
+  frequency: string;
   /**
-   * netSavings = income − expense (savings positive)
+   * Currency code
    */
-  netSavings: string;
+  currency: string;
 };
 
-export type CashFlowTrendSummaryDto = {
-  /**
-   * Total income across the period
-   */
-  totalIncome: string;
+export type ExpectedTransactionResponseDto = {
   /**
-   * Total expense across the period
+   * Expected transaction ID
    */
-  totalExpense: string;
+  id: string;
   /**
-   * income − expense across the period
+   * User ID
    */
-  totalNetSavings: string;
+  userId: string;
   /**
-   * totalNetSavings divided by the window length (N months, incl. zero-filled)
+   * Associated rule ID
    */
-  averageMonthlyNetSavings: string;
-};
-
-export type CashFlowTrendsResponseDto = {
+  ruleId: string;
   /**
-   * Monthly cash-flow series (fixed N-month window, zero-filled)
+   * Expected date (YYYY-MM-DD)
    */
-  series: Array<CashFlowPointDto>;
+  expectedDate: string;
   /**
-   * Period totals
+   * Expected amount
    */
-  summary: CashFlowTrendSummaryDto;
+  expectedAmount: number;
   /**
-   * Period requested
+   * Status (PENDING, COMPLETED, SKIPPED)
    */
-  period: string;
+  status: string;
   /**
-   * Data granularity (v1 returns month buckets)
+   * Matched transaction ID
    */
-  granularity: string;
+  matchedTransactionId?: string;
   /**
-   * Base currency for converted values
+   * Match timestamp (ISO 8601)
    */
-  currency: string;
+  matchedAt?: string;
   /**
-   * Exchange rate warnings (e.g. missing rate for a currency)
+   * Match confidence score (0-1)
    */
-  warnings?: Array<ExchangeRateWarningDto>;
-};
-
-export type GenerateSnapshotBody = unknown;
-
-export type GenerateSnapshotResponse = unknown;
-
-export type BackfillSnapshotsBody = unknown;
-
-export type BackfillSnapshotsResponse = unknown;
-
-export type DeleteOwnUserDto = {
+  matchConfidence?: number;
   /**
-   * Access token for user verification
+   * Whether this expected transaction is overdue
    */
-  accessToken: string;
-};
-
-export type SignupDto = {
+  isOverdue: boolean;
   /**
-   * Cloudflare Turnstile verification token (optional when Turnstile disabled)
+   * Rule information
    */
-  turnstileToken?: string;
-};
-
-export type SignupResponseDto = {
+  rule: ExpectedTransactionRuleDto;
   /**
-   * JWT auth token
+   * Created at timestamp
    */
-  authToken: string;
+  createdAt: string;
   /**
-   * Auto-generated access token
+   * Updated at timestamp
    */
-  accessToken: string;
+  updatedAt: string;
+};
+
+export type ExpectedTransactionListResponseDto = {
+  items: Array<ExpectedTransactionResponseDto>;
   /**
-   * Assigned user role
+   * Total count
    */
-  role: 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
+  total: number;
 };
 
-/**
- * Assigned user role
- */
-export type role = 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
+export type ConfirmMatchDto = {
+  /**
+   * Transaction ID to match with
+   */
+  transactionId: string;
+};
 
-export type UpdateUserSettingDto = {
+export type EnterNowDto = {
   /**
-   * Security ID
+   * Override expense account (uses rule default if not provided)
    */
-  secId?: number;
+  expenseAccount?: string;
   /**
-   * Annual interest rate
+   * Override payment account (uses rule default if not provided)
    */
-  annualInterestRate?: number;
+  paymentAccount?: string;
   /**
-   * Currency code
+   * Override amount (uses expected amount if not provided)
    */
-  currency?: string;
+  amount?: number;
   /**
-   * Base currency code
+   * Override payee (uses rule default if not provided)
    */
-  baseCurrency?: string;
+  payee?: string;
   /**
-   * Benchmark symbol
+   * Optional narration
    */
-  benchmark?: string;
+  narration?: string;
+};
+
+export type ForecastItemDto = {
   /**
-   * Color scheme
+   * Rule name
    */
-  colorScheme?: 'DARK' | 'LIGHT';
+  rule: string;
   /**
-   * Date range filter
+   * Rule ID
    */
-  dateRange?: string;
+  ruleId: string;
   /**
-   * Emergency fund amount
+   * Expected amount
    */
-  emergencyFund?: number;
+  amount: number;
   /**
-   * Account filter IDs
+   * Expected date (YYYY-MM-DD)
    */
-  'filters.accounts'?: Array<string>;
+  date: string;
   /**
-   * Asset class filters
+   * Rule icon emoji
    */
-  'filters.assetClasses'?: Array<string>;
+  icon: string | null;
   /**
-   * Data source filter
+   * Currency code
    */
-  'filters.dataSource'?: string;
+  currency: string;
+};
+
+export type MonthlyForecastDto = {
   /**
-   * Symbol filter
+   * Month (YYYY-MM)
    */
-  'filters.symbol'?: string;
+  month: string;
   /**
-   * Tag filters
+   * Total expected outflow for the month
    */
-  'filters.tags'?: Array<string>;
+  expectedOutflow: number;
   /**
-   * Enable experimental features
+   * Number of expected transactions
    */
-  isExperimentalFeatures?: boolean;
+  itemCount: number;
   /**
-   * Enable restricted view mode
+   * Breakdown by currency
    */
-  isRestrictedView?: boolean;
+  byCurrency: {
+    [key: string]: unknown;
+  };
   /**
-   * Language code
+   * Individual forecast items
    */
-  language?: string;
+  items: Array<ForecastItemDto>;
+};
+
+export type ForecastResponseDto = {
   /**
-   * Locale code
+   * Monthly forecast data
    */
-  locale?: string;
+  forecast: Array<MonthlyForecastDto>;
   /**
-   * Projected total amount
+   * Total expected outflow across all months
    */
-  projectedTotalAmount?: number;
+  totalOutflow: number;
   /**
-   * Retirement date in ISO 8601 format
+   * Total by currency across all months
    */
-  retirementDate?: string;
+  totalByCurrency: {
+    [key: string]: unknown;
+  };
   /**
-   * Savings rate percentage
+   * Number of active recurring rules included
    */
-  savingsRate?: number;
+  rulesCount: number;
   /**
-   * View mode
+   * Forecast period start date
    */
-  viewMode?: 'DEFAULT' | 'ZEN';
-};
-
-/**
- * Color scheme
- */
-export type colorScheme = 'DARK' | 'LIGHT';
-
-/**
- * View mode
- */
-export type viewMode = 'DEFAULT' | 'ZEN';
-
-export type UpdatePropertyDto = {
+  periodStart: string;
   /**
-   * Property value
+   * Forecast period end date
    */
-  value: string;
+  periodEnd: string;
 };
 
 export type CreateTransactionRuleDto = {
@@ -3463,14 +3567,14 @@ export type UpdateTransactionRuleDto = {
    */
   amountMax?: number;
   priority?: number;
-  /**
-   * Enable or disable the rule
-   */
-  enabled?: boolean;
   additionalTags?: Array<unknown[]>;
   additionalMetadata?: {
     [key: string]: unknown;
   };
+  /**
+   * Enable or disable the rule
+   */
+  enabled?: boolean;
 };
 
 export type TestRuleDto = {
@@ -3502,6 +3606,57 @@ export type TestRuleResponseDto = {
   };
 };
 
+export type CategoryCatalogEntryDto = {
+  /**
+   * Category slug (single source-of-truth)
+   */
+  slug: string;
+  /**
+   * Display scenario group (maps to frontend picker _scenario)
+   */
+  scenario:
+    | 'expense'
+    | 'income'
+    | 'investment'
+    | 'banking'
+    | 'transfer'
+    | 'payment';
+  /**
+   * Lucide icon name
+   */
+  icon: string;
+  /**
+   * Applicable regions ('*' = all, 'cn' = CN-only)
+   */
+  regions: Array<string>;
+};
+
+/**
+ * Display scenario group (maps to frontend picker _scenario)
+ */
+export type scenario =
+  | 'expense'
+  | 'income'
+  | 'investment'
+  | 'banking'
+  | 'transfer'
+  | 'payment';
+
+export type CategoryCatalogListResponseDto = {
+  /**
+   * Category entries (region-scoped, query-filtered)
+   */
+  items: Array<CategoryCatalogEntryDto>;
+  /**
+   * Total category entries for the region (before query filtering)
+   */
+  total: number;
+  /**
+   * Region code
+   */
+  region: string;
+};
+
 export type CreateBeanEventDto = {
   /**
    * Life event date (ISO 8601)
@@ -4128,66 +4283,143 @@ export type CreateExternalAccountLinkDto = {
   /**
    * Open Banking provider (whitelist)
    */
-  provider:
-    | 'plaid'
-    | 'teller'
-    | 'truelayer'
-    | 'gocardless'
-    | 'simplefin'
-    | 'yodlee'
-    | 'beancount-direct'
-    | 'parsed-bill';
+  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;
+
+export type ClientParsedDataDto = {
+  /**
+   * Transaction amount
+   */
+  amount?: number;
+  /**
+   * Currency code
+   */
+  currency?: string;
+  /**
+   * Transaction date (ISO 8601)
+   */
+  date?: string;
+  /**
+   * Payee/merchant name
+   */
+  payee?: string;
+  /**
+   * Transaction narration
+   */
+  narration?: string;
+  /**
+   * Category slug
+   */
+  category?: string;
+  /**
+   * Income type
+   */
+  incomeType?: string;
+  /**
+   * Income source
+   */
+  incomeSource?: string;
+  /**
+   * Security symbol code (e.g., 600519, AAPL)
+   */
+  symbol?: string;
+  /**
+   * Quantity of shares/units
+   */
+  quantity?: number;
+  /**
+   * Unit price per share/unit
+   */
+  price?: number;
+  /**
+   * Investment action
+   */
+  investmentAction?: 'buy' | 'sell';
+  /**
+   * Payment source: asset (default) or liability (credit card)
+   */
+  paymentSource?: 'asset' | 'liability';
   /**
-   * External account ID from the provider
+   * Liability account hint (CreditCard/Huabei/Baitiao)
    */
-  externalAccountId: string;
+  liabilityHint?: string;
   /**
-   * Target BeanAccount ID (must belong to the JWT user)
+   * Display-only warning from the prior response; accepted but ignored.
    */
-  beanAccountId: string;
+  warning?: string;
 };
 
 /**
- * Open Banking provider (whitelist)
+ * Investment action
  */
-export type provider =
-  | 'plaid'
-  | 'teller'
-  | 'truelayer'
-  | 'gocardless'
-  | 'simplefin'
-  | 'yodlee'
-  | 'beancount-direct'
-  | 'parsed-bill';
+export type investmentAction = 'buy' | 'sell';
 
-export type ExternalAccountLinkResponseDto = {
-  id: string;
-  provider: string;
-  externalAccountId: string;
-  beanAccountId: string;
-  isActive: boolean;
-  createdAt: string;
-  updatedAt: string;
-};
+/**
+ * Payment source: asset (default) or liability (credit card)
+ */
+export type paymentSource = 'asset' | 'liability';
 
-export type ExternalAccountLinkListResponseDto = {
-  items: Array<ExternalAccountLinkResponseDto>;
-  total: number;
+export type ProcessNlpDto = {
   /**
-   * Filter by provider (query param)
+   * Natural language text describing a transaction. Optional when `confirm` is true (structured confirm); otherwise required.
    */
-  provider?: string;
-};
-
-export type ParserTelemetryReportDto = unknown;
-
-export type UncoveredFormatMissDto = unknown;
-
-export type ProcessNlpDto = {
+  message?: string;
   /**
-   * Natural language text describing a transaction (Chinese)
+   * Structured confirm signal — bypasses NL confirm-word matching when true. Send parsedData field edits alongside. The NL word-list path is the fallback.
    */
-  message: string;
+  confirm?: boolean;
   /**
    * Session ID for multi-turn conversation (auto-generated if not provided)
    */
@@ -4195,19 +4427,34 @@ export type ProcessNlpDto = {
   /**
    * Parsed data from previous NLP response for session recovery. Send back the parsedData received in confirm_payee/confirm responses.
    */
-  parsedData?: {
-    [key: string]: unknown;
-  };
+  parsedData?: ClientParsedDataDto;
   /**
    * confirm_rule echo-back: rule id selected from the prior confirm_rule response (matchedRule.id or alternatives[i].ruleId). Applied directly when the session is confirming_rule — no NL re-parse.
    */
   selectedRuleId?: string;
   /**
-   * confirm_account echo-back: account path selected from the prior confirm_account response (suggestedAccount, similarAccounts[i], or a typed path). Applied directly when the session is confirming_account — no NL re-parse.
+   * confirm_account echo-back: account path selected from the prior confirm_account response (suggestedAccount, similarAccounts[i].path, or a typed path). Applied directly when the session is confirming_account — no NL re-parse.
    */
   selectedAccount?: string;
+  /**
+   * Viewpoint account hint: the beancount path the user drilled into (e.g. from an account drill-down). Tie-break only — never overrides accounts resolved from the text. Must be an owned, OPEN Assets:/Liabilities: account; unresolvable hints are silently ignored.
+   */
+  viewpointAccount?: string;
+  /**
+   * Viewpoint category hint: the ADR-0075 Group segment the user drilled into (e.g. 'Food'). Resolved to a concrete OPEN account in that group; tie-break only — never overrides a category resolved from the text.
+   */
+  viewpointCategory?: string;
+  /**
+   * Companion flow root for viewpointCategory ('income' | 'expense'), mirroring the ADR-0126 list-endpoint invariant. Derived from the session's routed intent (multi-turn) when absent; a first-turn flow-less category hint is dropped — send the flow explicitly.
+   */
+  viewpointFlow?: 'income' | 'expense';
 };
 
+/**
+ * Companion flow root for viewpointCategory ('income' | 'expense'), mirroring the ADR-0126 list-endpoint invariant. Derived from the session's routed intent (multi-turn) when absent; a first-turn flow-less category hint is dropped — send the flow explicitly.
+ */
+export type viewpointFlow = 'income' | 'expense';
+
 export type NlpTransactionInfoDto = {
   /**
    * Transaction ID
@@ -4302,16 +4549,6 @@ export type NlpParsedDataDto = {
   warning?: string;
 };
 
-/**
- * Investment action
- */
-export type investmentAction = 'buy' | 'sell';
-
-/**
- * Payment source: asset (default) or liability (credit card)
- */
-export type paymentSource = 'asset' | 'liability';
-
 export type NlpSourceTransactionDto = {
   /**
    * Transaction date (ISO format)
@@ -4443,6 +4680,17 @@ export type NlpRuleConfirmationDataDto = {
   reasons: Array<string>;
 };
 
+export type NlpAccountCandidateDto = {
+  /**
+   * Canonical beancount account path (echo back on selection)
+   */
+  path: string;
+  /**
+   * Localized display name (ADR-0114 read-time projection, user locale)
+   */
+  name: string;
+};
+
 export type NlpAccountConfirmationDataDto = {
   /**
    * The invalid account name
@@ -4453,9 +4701,9 @@ export type NlpAccountConfirmationDataDto = {
    */
   suggestedAccount?: string;
   /**
-   * Similar accounts for user selection
+   * Similar accounts for user selection (path + localized name, #680)
    */
-  similarAccounts: Array<string>;
+  similarAccounts: Array<NlpAccountCandidateDto>;
   /**
    * Error message explaining the issue
    */
@@ -4639,7 +4887,12 @@ export type NlpResponseDto = {
   /**
    * Asset sub-type (only present when intent is "asset"). Determines which asset-related form to render.
    */
-  assetSubType?: 'transfer' | 'banking' | 'investment';
+  assetSubType?:
+    | 'transfer'
+    | 'banking'
+    | 'investment'
+    | 'lend'
+    | 'lend_collect';
   /**
    * Liability sub-type (only present when intent is "liability"). borrow: borrowing money (Liabilities → Assets), repay: repaying debt (Assets → Liabilities).
    */
@@ -4756,7 +5009,12 @@ export type intent = 'expense' | 'asset' | 'income' | 'liability' | 'equity';
 /**
  * Asset sub-type (only present when intent is "asset"). Determines which asset-related form to render.
  */
-export type assetSubType = 'transfer' | 'banking' | 'investment';
+export type assetSubType =
+  | 'transfer'
+  | 'banking'
+  | 'investment'
+  | 'lend'
+  | 'lend_collect';
 
 /**
  * Liability sub-type (only present when intent is "liability"). borrow: borrowing money (Liabilities → Assets), repay: repaying debt (Assets → Liabilities).
@@ -4797,7 +5055,7 @@ export type PlatformListItemDto = {
    */
   canonical: string;
   /**
-   * Suggested path segment — PascalCase of canonical, hyphens removed (e.g. "ApplePay")
+   * Suggested path segment — canonical PascalCased per hyphen-part, hyphens preserved (e.g. "Apple-Pay")
    */
   suggestedSegment: string;
   /**
@@ -4821,7 +5079,7 @@ export type PlatformListItemDto = {
 /**
  * Platform type
  */
-export type type3 =
+export type type4 =
   | 'BANK'
   | 'BROKERAGE'
   | 'CRYPTO_EXCHANGE'
@@ -4855,7 +5113,7 @@ export type PlatformMatchResultDto = {
     | 'INSURANCE'
     | 'OTHER';
   /**
-   * Suggested path segment — PascalCase of canonical, hyphens removed (e.g. "ApplePay")
+   * Suggested path segment — canonical PascalCased per hyphen-part, hyphens preserved (e.g. "Apple-Pay")
    */
   suggestedSegment: string;
   /**
@@ -4905,6 +5163,55 @@ export type PlatformMatchResponseDto = {
  */
 export type matchType2 = 'none' | 'exact' | 'prefix' | 'substring';
 
+export type PlatformStandardsPlatformDto = {
+  /**
+   * Global platform ID
+   */
+  id: string;
+  /**
+   * Platform name (e.g., "ICBC")
+   */
+  name: string;
+  /**
+   * Canonical identifier in ACCOUNT_RE format (e.g., "icbc")
+   */
+  canonical: string;
+  /**
+   * Suggested path segment — canonical PascalCased per hyphen-part, hyphens preserved (e.g. "Apple-Pay")
+   */
+  suggestedSegment: string;
+  /**
+   * Platform type
+   */
+  type:
+    | 'BANK'
+    | 'BROKERAGE'
+    | 'CRYPTO_EXCHANGE'
+    | 'PAYMENT'
+    | 'INVESTMENT'
+    | 'INSURANCE'
+    | 'OTHER';
+  /**
+   * Region-aware category (institution vocab, e.g. DigitalWallet/Bank) resolved against the final region. null = no region-aware suggestion; fall back to type.
+   */
+  category: string | null;
+};
+
+export type PlatformStandardsResponseDto = {
+  /**
+   * The selected platform (institution lock source)
+   */
+  platform: PlatformStandardsPlatformDto;
+  /**
+   * Resolved template region (ISO 3166-1 alpha-2, UPPERCASE): the platform's own countryCode when set, else the region query param. For regions without a regional template file the template list falls back to the universal-only catalog while region still echoes the code.
+   */
+  region: string;
+  /**
+   * Candidate account-standard templates of the resolved region (groupable by productCategory client-side)
+   */
+  templates: Array<AccountStandardResponseDto>;
+};
+
 export type CreatePlatformDto = {
   /**
    * Platform name
@@ -5101,11 +5408,11 @@ export type PlatformGroupDto = {
    */
   platformName: string;
   /**
-   * Accounts within this platform
+   * Accounts within this platform (Assets and Liabilities rows, #696)
    */
   accounts: Array<AccountItemDto>;
   /**
-   * FX-converted total balance in base currency
+   * FX-converted total balance in base currency (nets Assets + Liabilities rows; can be negative)
    */
   totalBalance: string;
   /**
@@ -5117,7 +5424,7 @@ export type PlatformGroupDto = {
    */
   convertedBalance?: string;
   /**
-   * Share of the grand converted total (0-100); 0 when grand total is 0
+   * Share of the converted asset-side grand total (0-100); liability balances are excluded from the basis; 0 when grand total is 0 (#696)
    */
   sharePct: number;
 };
@@ -5143,7 +5450,7 @@ export type AccountExchangeRateWarningDto = {
 
 export type AccountsSummaryDto = {
   /**
-   * Total number of accounts
+   * Total number of accounts (balance sheet: Assets + Liabilities, #696)
    */
   totalAccounts: number;
   /**
@@ -5495,9 +5802,7 @@ export type MonetaryDto = {
   /**
    * Converted to user base currency (Decimal string)
    */
-  baseCcyEquivalent?: {
-    [key: string]: unknown;
-  } | null;
+  baseCcyEquivalent?: string | null;
 };
 
 export type CurrentPriceDto = {
@@ -5549,15 +5854,11 @@ export type HoldingPnlRowDto = {
   /**
    * Account settlement currency (ISO 4217), from cost currency
    */
-  accountCcy?: {
-    [key: string]: unknown;
-  } | null;
+  accountCcy?: string | null;
   /**
    * Broker type derived from Platform.type
    */
-  brokerType?: {
-    [key: string]: unknown;
-  } | null;
+  brokerType?: string | null;
   /**
    * Commodity symbol
    */
@@ -5567,9 +5868,7 @@ export type HoldingPnlRowDto = {
    */
   chartToken: 'equity' | 'fund' | 'bond' | 'cash' | 'other';
   assetClass: string;
-  assetSubClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetSubClass?: string | null;
   /**
    * Net held units (Decimal string)
    */
@@ -5593,15 +5892,11 @@ export type HoldingPnlRowDto = {
   /**
    * Unrealized P&L in base currency (Decimal string); null when any FX/price missing
    */
-  unrealizedPnlBase?: {
-    [key: string]: unknown;
-  } | null;
+  unrealizedPnlBase?: string | null;
   /**
    * Unrealized P&L % (Decimal string)
    */
-  unrealizedPnlPct?: {
-    [key: string]: unknown;
-  } | null;
+  unrealizedPnlPct?: string | null;
   /**
    * Historical FX rate applied to cost basis
    */
@@ -5613,9 +5908,7 @@ export type HoldingPnlRowDto = {
   /**
    * Share of invested assets % (Decimal string); only for invested chartTokens
    */
-  pctOfInvestedAssets?: {
-    [key: string]: unknown;
-  } | null;
+  pctOfInvestedAssets?: string | null;
   /**
    * Cumulative realized P&L on sold lots (asOf-date cutoff); null when the method has no applicable sells, a sell lacks a price, or any required FX rate is missing (never-mix). When a sell spans multiple currencies (cross-currency sale), amount and currency reflect the base currency; baseCcyEquivalent is always the authoritative dual-FX figure
    */
@@ -5639,21 +5932,15 @@ export type HoldingPnlWarningDto = {
     | 'OVERSOLD_LOTS'
     | 'NO_PRICE'
     | 'MIXED_COST_CURRENCY';
-  symbol?: {
-    [key: string]: unknown;
-  } | null;
-  accountId?: {
-    [key: string]: unknown;
-  } | null;
-  currency?: {
-    [key: string]: unknown;
-  } | null;
+  symbol?: string | null;
+  accountId?: string | null;
+  currency?: string | null;
 };
 
 /**
  * Warning type
  */
-export type type4 =
+export type type5 =
   | 'MISSING_COST_FX_RATE'
   | 'MISSING_MARKET_FX_RATE'
   | 'MISSING_SALE_PRICE'
@@ -5692,132 +5979,205 @@ export type AnonymousLoginResponseDto = {
   authToken: string;
 };
 
+export type ParserContributionMetaDto = {
+  /**
+   * Institution slug (lowercase kebab-case)
+   */
+  institution: string;
+  region:
+    | 'cn'
+    | 'us'
+    | 'de'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'jp'
+    | 'sg'
+    | 'au'
+    | 'ca'
+    | 'other';
+  accountType: 'checking' | 'savings' | 'credit' | 'debit' | 'investment';
+  format: 'csv' | 'xlsx' | 'pdf' | 'ofx' | 'qif';
+  institutionDisplayName?: string;
+  encoding?: string;
+  /**
+   * CSV delimiter character: ",", ";", "\t" or "|"
+   */
+  delimiter?: string;
+  /**
+   * Header row count; the client omits the field when it is 1
+   */
+  headerRows?: number;
+  notes?: string;
+};
+
+export type region =
+  | 'cn'
+  | 'us'
+  | 'de'
+  | 'fr'
+  | 'gb'
+  | 'hk'
+  | 'jp'
+  | 'sg'
+  | 'au'
+  | 'ca'
+  | 'other';
+
+export type accountType =
+  | 'checking'
+  | 'savings'
+  | 'credit'
+  | 'debit'
+  | 'investment';
+
+export type format = 'csv' | 'xlsx' | 'pdf' | 'ofx' | 'qif';
+
+export type ParserContributionSamplesDto = {
+  /**
+   * Client-sanitized sample rows (key = column name, value = cell)
+   */
+  rows: Array<{
+    [key: string]: unknown;
+  }>;
+  rawHeaders?: Array<string>;
+};
+
+export type FieldHintDto = {
+  columnName: string;
+  /**
+   * Date format, e.g. yyyy-MM-dd HH:mm
+   */
+  format?: string;
+  signConvention?: 'negative-expense' | 'positive-expense' | 'separate-columns';
+  creditColumn?: string;
+  debitColumn?: string;
+};
+
+export type signConvention =
+  | 'negative-expense'
+  | 'positive-expense'
+  | 'separate-columns';
+
+export type ParserContributionFieldHintsDto = {
+  date: FieldHintDto;
+  amount: FieldHintDto;
+  description?: FieldHintDto;
+  balance?: FieldHintDto;
+  payee?: FieldHintDto;
+  reference?: FieldHintDto;
+  category?: FieldHintDto;
+};
+
+export type ExpectedTransactionDto = {
+  date: string;
+  amount: number;
+  description: string;
+  payee?: string;
+  category?: string;
+};
+
+export type ParserContributionExamplesDto = {
+  expectedTransactions: Array<ExpectedTransactionDto>;
+};
+
+export type ParserContributionRequestDto = {
+  meta: ParserContributionMetaDto;
+  samples: ParserContributionSamplesDto;
+  fieldHints: ParserContributionFieldHintsDto;
+  /**
+   * Omitted entirely by the client when empty
+   */
+  examples?: ParserContributionExamplesDto;
+};
+
+export type ParserContributionRelayResponseDto = {
+  issueUrl: string;
+  issueNumber: number;
+};
+
 export type SymbolSearchResultDto = {
   symbol: string;
-  name?: {
-    [key: string]: unknown;
-  } | null;
-  exchange?: {
-    [key: string]: unknown;
-  } | null;
+  name?: string | null;
+  exchange?: string | null;
   /**
    * OpenBB asset_type (e.g. stock, etf)
    */
-  assetType?: {
-    [key: string]: unknown;
-  } | null;
+  assetType?: string | null;
   /**
    * IGN asset class (region.types.ts ASSET_CLASSES)
    */
-  assetClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetClass?: string | null;
   /**
    * IGN asset sub-class (region.types.ts ASSET_SUB_CLASSES)
    */
-  assetSubClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetSubClass?: string | null;
   /**
    * Trading currency (extra_data or inferred from exchange)
    */
-  currency?: {
-    [key: string]: unknown;
-  } | null;
+  currency?: string | null;
 };
 
 export type SymbolQuoteDto = {
   symbol?: string;
-  name?: {
-    [key: string]: unknown;
-  } | null;
-  exchange?: {
-    [key: string]: unknown;
-  } | null;
+  name?: string | null;
+  exchange?: string | null;
   /**
    * OpenBB asset_type
    */
-  assetType?: {
-    [key: string]: unknown;
-  } | null;
+  assetType?: string | null;
   /**
    * IGN asset class
    */
-  assetClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetClass?: string | null;
   /**
    * IGN asset sub-class
    */
-  assetSubClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetSubClass?: string | null;
   /**
    * Trading currency (extra_data or inferred from exchange)
    */
-  currency?: {
-    [key: string]: unknown;
-  } | null;
+  currency?: string | null;
   /**
    * Latest price (Decimal string)
    */
-  price?: {
-    [key: string]: unknown;
-  } | null;
+  price?: string | null;
   /**
    * Date the price was observed (ISO yyyy-MM-dd)
    */
-  priceDate?: {
-    [key: string]: unknown;
-  } | null;
+  priceDate?: string | null;
   /**
    * Change vs previous close, in percentage points (1.7 == 1.7%). openbb stores change_percent as a normalized decimal; this exposes percentage points for frontend convenience.
    */
-  changePercent?: {
-    [key: string]: unknown;
-  } | null;
+  changePercent?: number | null;
   /**
    * Previous close (Decimal string)
    */
-  prevClose?: {
-    [key: string]: unknown;
-  } | null;
+  prevClose?: string | null;
   /**
    * Day open (Decimal string)
    */
-  open?: {
-    [key: string]: unknown;
-  } | null;
+  open?: string | null;
   /**
    * Day high (Decimal string)
    */
-  high?: {
-    [key: string]: unknown;
-  } | null;
+  high?: string | null;
   /**
    * Day low (Decimal string)
    */
-  low?: {
-    [key: string]: unknown;
-  } | null;
+  low?: string | null;
   /**
    * Day volume (Decimal string)
    */
-  volume?: {
-    [key: string]: unknown;
-  } | null;
+  volume?: string | null;
   /**
    * 52-week high (Decimal string)
    */
-  yearHigh?: {
-    [key: string]: unknown;
-  } | null;
+  yearHigh?: string | null;
   /**
    * 52-week low (Decimal string)
    */
-  yearLow?: {
-    [key: string]: unknown;
-  } | null;
+  yearLow?: string | null;
 };
 
 export type AccountControllerCreateData = {
@@ -6177,7 +6537,7 @@ export type AccountStandardsControllerGetTemplatesData = {
     | 'tw'
     | 'us';
   /**
-   * Search term for path or description
+   * Search term for path, description, aliases, or localized display name
    */
   search?: string;
   /**
@@ -6307,7 +6667,7 @@ export type TransactionControllerListData = {
    */
   accountId?: string;
   /**
-   * Filter by ADR-0075 functional category (Group segment); matches any posting to an Expenses/Income account whose derived Group segment equals this value
+   * Filter by ADR-0075 functional category (Group segment); matches any posting to an account whose derived Group segment equals this value. Must be accompanied by flow (ADR-0126).
    */
   category?: string;
   /**
@@ -6318,6 +6678,10 @@ export type TransactionControllerListData = {
    * Filter by end date (inclusive), format: YYYY-MM-DD
    */
   dateTo?: string;
+  /**
+   * Required when category is present (400 otherwise) and vice versa (ADR-0126). Restricts the category account set to the flow root (income → Income:, expense → Expenses:) and drives the per-leg sign normalization of row viewpointAmount and the summary. OpenAPI cannot express conditional requiredness — the pairing is enforced at runtime.
+   */
+  flow?: 'income' | 'expense';
   /**
    * Number of items per page (1-100, default: 20)
    */
@@ -6360,9 +6724,9 @@ export type TransactionControllerListData = {
    */
   search?: string;
   /**
-   * Filter by transaction status
+   * Filter by transaction status: single value, comma-separated multi-value (e.g. VOIDED,SUPERSEDED), or ALL to include audit rows. Defaults to ACTIVE-only (ADR-0128; previously unfiltered — breaking change).
    */
-  status?: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
+  status?: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED' | 'ALL';
 };
 
 export type TransactionControllerListResponse = TransactionListResponseDto;
@@ -7119,8 +7483,7 @@ export type PayeeProfileAdminControllerUnverifyData = {
   id: string;
 };
 
-export type PayeeProfileAdminControllerUnverifyResponse =
-  PayeeProfileResponseDto;
+export type PayeeProfileAdminControllerUnverifyResponse = void;
 
 export type CommodityControllerCreateData = {
   /**
@@ -7235,48 +7598,9 @@ export type CommodityControllerFindOneData = {
   symbol: string;
 };
 
-export type CommodityControllerFindOneResponse = CommodityResponseDto;
-
-export type CommodityControllerUpdateData = {
-  /**
-   * Region code for tenant context
-   */
-  region:
-    | 'ad'
-    | 'ae'
-    | 'af'
-    | 'ag'
-    | 'al'
-    | 'am'
-    | 'ao'
-    | 'au'
-    | 'br'
-    | 'ca'
-    | 'cn'
-    | 'de'
-    | 'dz'
-    | 'es'
-    | 'fr'
-    | 'gb'
-    | 'hk'
-    | 'in'
-    | 'it'
-    | 'jp'
-    | 'kr'
-    | 'nl'
-    | 'sg'
-    | 'tw'
-    | 'us';
-  requestBody: UpdateCommodityDto;
-  /**
-   * Commodity symbol
-   */
-  symbol: string;
-};
-
-export type CommodityControllerUpdateResponse = CommodityResponseDto;
+export type CommodityControllerFindOneResponse = CommodityResponseDto;
 
-export type CommodityControllerDeleteData = {
+export type CommodityControllerUpdateData = {
   /**
    * Region code for tenant context
    */
@@ -7306,15 +7630,16 @@ export type CommodityControllerDeleteData = {
     | 'sg'
     | 'tw'
     | 'us';
+  requestBody: UpdateCommodityDto;
   /**
    * Commodity symbol
    */
   symbol: string;
 };
 
-export type CommodityControllerDeleteResponse = void;
+export type CommodityControllerUpdateResponse = CommodityResponseDto;
 
-export type CommodityControllerGetOrCreateData = {
+export type CommodityControllerDeleteData = {
   /**
    * Region code for tenant context
    */
@@ -7350,9 +7675,9 @@ export type CommodityControllerGetOrCreateData = {
   symbol: string;
 };
 
-export type CommodityControllerGetOrCreateResponse = CommodityResponseDto;
+export type CommodityControllerDeleteResponse = void;
 
-export type CommodityControllerBulkCreateData = {
+export type CommodityControllerGetOrCreateData = {
   /**
    * Region code for tenant context
    */
@@ -7382,11 +7707,15 @@ export type CommodityControllerBulkCreateData = {
     | 'sg'
     | 'tw'
     | 'us';
+  /**
+   * Commodity symbol
+   */
+  symbol: string;
 };
 
-export type CommodityControllerBulkCreateResponse = Array<CommodityResponseDto>;
+export type CommodityControllerGetOrCreateResponse = CommodityResponseDto;
 
-export type PriceControllerCreateData = {
+export type CommodityControllerBulkCreateData = {
   /**
    * Region code for tenant context
    */
@@ -7416,36 +7745,19 @@ export type PriceControllerCreateData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: CreateBeanPriceDto;
 };
 
-export type PriceControllerCreateResponse = PriceResponseDto;
+export type CommodityControllerBulkCreateResponse = Array<CommodityResponseDto>;
 
-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;
+export type ReportingControllerGetPortfolioTrendsData = {
   /**
-   * Page number for pagination (default: 1)
+   * Data granularity
    */
-  page?: number;
+  granularity?: 'day' | 'week' | 'month';
   /**
-   * Filter by quote currency (pricing currency, e.g., USD, CNY)
+   * Time period
    */
-  quoteCurrency?: string;
+  period?: '1m' | '3m' | '6m' | '1y';
   /**
    * Region code for tenant context
    */
@@ -7475,19 +7787,20 @@ export type PriceControllerFindAllData = {
     | 'sg'
     | 'tw'
     | 'us';
-  /**
-   * Search term for currency or quoteCurrency (case-insensitive partial match)
-   */
-  search?: string;
 };
 
-export type PriceControllerFindAllResponse = PriceListResponseDto;
+export type ReportingControllerGetPortfolioTrendsResponse =
+  PortfolioTrendsResponseDto;
 
-export type PriceControllerFindOneData = {
+export type ReportingControllerGetCashFlowTrendsData = {
   /**
-   * Price ID
+   * Data granularity (accepted for API symmetry; v1 returns month buckets)
    */
-  id: string;
+  granularity?: 'day' | 'week' | 'month';
+  /**
+   * Time period
+   */
+  period?: '1m' | '3m' | '6m' | '1y';
   /**
    * Region code for tenant context
    */
@@ -7519,13 +7832,10 @@ export type PriceControllerFindOneData = {
     | 'us';
 };
 
-export type PriceControllerFindOneResponse = PriceResponseDto;
+export type ReportingControllerGetCashFlowTrendsResponse =
+  CashFlowTrendsResponseDto;
 
-export type PriceControllerUpdateData = {
-  /**
-   * Price ID
-   */
-  id: string;
+export type ReportingControllerGenerateSnapshotData = {
   /**
    * Region code for tenant context
    */
@@ -7555,16 +7865,16 @@ export type PriceControllerUpdateData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: UpdateBeanPriceDto;
+  /**
+   * Optional date (defaults to today)
+   */
+  requestBody: GenerateSnapshotBody;
 };
 
-export type PriceControllerUpdateResponse = PriceResponseDto;
+export type ReportingControllerGenerateSnapshotResponse =
+  GenerateSnapshotResponse;
 
-export type PriceControllerDeleteData = {
-  /**
-   * Price ID
-   */
-  id: string;
+export type ReportingControllerBackfillSnapshotsData = {
   /**
    * Region code for tenant context
    */
@@ -7594,11 +7904,13 @@ export type PriceControllerDeleteData = {
     | 'sg'
     | 'tw'
     | 'us';
+  requestBody: BackfillSnapshotsBody;
 };
 
-export type PriceControllerDeleteResponse = void;
+export type ReportingControllerBackfillSnapshotsResponse =
+  BackfillSnapshotsResponse;
 
-export type PriceControllerBulkCreateData = {
+export type PriceControllerCreateData = {
   /**
    * Region code for tenant context
    */
@@ -7628,12 +7940,36 @@ export type PriceControllerBulkCreateData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: Array<string>;
+  requestBody: CreateBeanPriceDto;
 };
 
-export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
+export type PriceControllerCreateResponse = PriceResponseDto;
 
-export type RecurringRuleControllerCreateData = {
+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
    */
@@ -7663,24 +7999,19 @@ export type RecurringRuleControllerCreateData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: CreateRecurringRuleDto;
+  /**
+   * Search term for currency or quoteCurrency (case-insensitive partial match)
+   */
+  search?: string;
 };
 
-export type RecurringRuleControllerCreateResponse = RecurringRuleResponseDto;
+export type PriceControllerFindAllResponse = PriceListResponseDto;
 
-export type RecurringRuleControllerFindAllData = {
-  /**
-   * Filter by frequency (WEEKLY, MONTHLY, etc.)
-   */
-  frequency?: string;
-  /**
-   * Filter by autoCreate enabled
-   */
-  hasAutoCreate?: boolean;
+export type PriceControllerFindOneData = {
   /**
-   * Filter by active status
+   * Price ID
    */
-  isActive?: boolean;
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -7712,10 +8043,13 @@ export type RecurringRuleControllerFindAllData = {
     | 'us';
 };
 
-export type RecurringRuleControllerFindAllResponse =
-  Array<RecurringRuleResponseDto>;
+export type PriceControllerFindOneResponse = PriceResponseDto;
 
-export type RecurringRuleControllerCreateFromTransactionData = {
+export type PriceControllerUpdateData = {
+  /**
+   * Price ID
+   */
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -7745,19 +8079,14 @@ export type RecurringRuleControllerCreateFromTransactionData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: CreateRuleFromTransactionDto;
-  /**
-   * Source transaction ID
-   */
-  transactionId: string;
+  requestBody: UpdateBeanPriceDto;
 };
 
-export type RecurringRuleControllerCreateFromTransactionResponse =
-  RecurringRuleResponseDto;
+export type PriceControllerUpdateResponse = PriceResponseDto;
 
-export type RecurringRuleControllerFindOneData = {
+export type PriceControllerDeleteData = {
   /**
-   * Rule ID
+   * Price ID
    */
   id: string;
   /**
@@ -7791,13 +8120,9 @@ export type RecurringRuleControllerFindOneData = {
     | 'us';
 };
 
-export type RecurringRuleControllerFindOneResponse = RecurringRuleResponseDto;
+export type PriceControllerDeleteResponse = void;
 
-export type RecurringRuleControllerUpdateData = {
-  /**
-   * Rule ID
-   */
-  id: string;
+export type PriceControllerBulkCreateData = {
   /**
    * Region code for tenant context
    */
@@ -7827,16 +8152,99 @@ export type RecurringRuleControllerUpdateData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: UpdateRecurringRuleDto;
+  requestBody: Array<string>;
+};
+
+export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
+
+export type UserControllerDeleteOwnUserData = {
+  requestBody: DeleteOwnUserDto;
+};
+
+export type UserControllerDeleteOwnUserResponse = void;
+
+export type UserControllerGetUserData = {
+  acceptLanguage: string;
+};
+
+export type UserControllerGetUserResponse = UserResponseDto;
+
+export type UserControllerSignupUserData = {
+  requestBody: SignupDto;
+};
+
+export type UserControllerSignupUserResponse = SignupResponseDto;
+
+export type UserControllerDeleteUserData = {
+  /**
+   * User ID to delete
+   */
+  id: string;
+};
+
+export type UserControllerDeleteUserResponse = void;
+
+export type UserControllerGetUserInfoData = {
+  /**
+   * User ID
+   */
+  id: string;
+};
+
+export type UserControllerGetUserInfoResponse = unknown;
+
+export type UserControllerUpdateUserSettingData = {
+  requestBody: UpdateUserSettingDto;
+};
+
+export type UserControllerUpdateUserSettingResponse = unknown;
+
+export type UserControllerGetAllUserSettingsByPageData = {
+  /**
+   * Page number
+   */
+  pageNo: number;
+  /**
+   * Page size
+   */
+  pageSize: number;
+};
+
+export type UserControllerGetAllUserSettingsByPageResponse = unknown;
+
+export type UserControllerGetAssetLiabilitySummaryResponse = unknown;
+
+export type PropertyControllerGetAllResponse = unknown;
+
+export type PropertyControllerGetByKeyData = {
+  /**
+   * Property key
+   */
+  key: string;
+};
+
+export type PropertyControllerGetByKeyResponse = unknown;
+
+export type PropertyControllerUpdateData = {
+  /**
+   * Property key
+   */
+  key: string;
+  requestBody: UpdatePropertyDto;
 };
 
-export type RecurringRuleControllerUpdateResponse = RecurringRuleResponseDto;
+export type PropertyControllerUpdateResponse = unknown;
 
-export type RecurringRuleControllerDeleteData = {
+export type PropertyControllerDeleteData = {
   /**
-   * Rule ID
+   * Property key
    */
-  id: string;
+  key: string;
+};
+
+export type PropertyControllerDeleteResponse = void;
+
+export type RecurringRuleControllerCreateData = {
   /**
    * Region code for tenant context
    */
@@ -7866,15 +8274,24 @@ export type RecurringRuleControllerDeleteData = {
     | 'sg'
     | 'tw'
     | 'us';
+  requestBody: CreateRecurringRuleDto;
 };
 
-export type RecurringRuleControllerDeleteResponse = void;
+export type RecurringRuleControllerCreateResponse = RecurringRuleResponseDto;
 
-export type RecurringRuleControllerGetWithStatsData = {
+export type RecurringRuleControllerFindAllData = {
   /**
-   * Rule ID
+   * Filter by frequency (WEEKLY, MONTHLY, etc.)
    */
-  id: string;
+  frequency?: string;
+  /**
+   * Filter by autoCreate enabled
+   */
+  hasAutoCreate?: boolean;
+  /**
+   * Filter by active status
+   */
+  isActive?: boolean;
   /**
    * Region code for tenant context
    */
@@ -7906,14 +8323,10 @@ export type RecurringRuleControllerGetWithStatsData = {
     | 'us';
 };
 
-export type RecurringRuleControllerGetWithStatsResponse =
-  RecurringRuleWithStatsResponseDto;
+export type RecurringRuleControllerFindAllResponse =
+  Array<RecurringRuleResponseDto>;
 
-export type ExpectedTransactionControllerFindAllData = {
-  /**
-   * Filter by date range start (YYYY-MM-DD)
-   */
-  fromDate?: string;
+export type RecurringRuleControllerCreateFromTransactionData = {
   /**
    * Region code for tenant context
    */
@@ -7943,24 +8356,21 @@ export type ExpectedTransactionControllerFindAllData = {
     | 'sg'
     | 'tw'
     | 'us';
+  requestBody: CreateRuleFromTransactionDto;
   /**
-   * Filter by recurring rule ID
-   */
-  ruleId?: string;
-  /**
-   * Filter by status (PENDING, COMPLETED, SKIPPED)
-   */
-  status?: string;
-  /**
-   * Filter by date range end (YYYY-MM-DD)
+   * Source transaction ID
    */
-  toDate?: string;
+  transactionId: string;
 };
 
-export type ExpectedTransactionControllerFindAllResponse =
-  ExpectedTransactionListResponseDto;
+export type RecurringRuleControllerCreateFromTransactionResponse =
+  RecurringRuleResponseDto;
 
-export type ExpectedTransactionControllerFindOverdueData = {
+export type RecurringRuleControllerFindOneData = {
+  /**
+   * Rule ID
+   */
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -7992,12 +8402,11 @@ export type ExpectedTransactionControllerFindOverdueData = {
     | 'us';
 };
 
-export type ExpectedTransactionControllerFindOverdueResponse =
-  ExpectedTransactionListResponseDto;
+export type RecurringRuleControllerFindOneResponse = RecurringRuleResponseDto;
 
-export type ExpectedTransactionControllerFindOneData = {
+export type RecurringRuleControllerUpdateData = {
   /**
-   * Expected transaction ID
+   * Rule ID
    */
   id: string;
   /**
@@ -8029,14 +8438,14 @@ export type ExpectedTransactionControllerFindOneData = {
     | 'sg'
     | 'tw'
     | 'us';
+  requestBody: UpdateRecurringRuleDto;
 };
 
-export type ExpectedTransactionControllerFindOneResponse =
-  ExpectedTransactionResponseDto;
+export type RecurringRuleControllerUpdateResponse = RecurringRuleResponseDto;
 
-export type ExpectedTransactionControllerSkipData = {
+export type RecurringRuleControllerDeleteData = {
   /**
-   * Expected transaction ID
+   * Rule ID
    */
   id: string;
   /**
@@ -8070,12 +8479,11 @@ export type ExpectedTransactionControllerSkipData = {
     | 'us';
 };
 
-export type ExpectedTransactionControllerSkipResponse =
-  ExpectedTransactionResponseDto;
+export type RecurringRuleControllerDeleteResponse = void;
 
-export type ExpectedTransactionControllerUndoSkipData = {
+export type RecurringRuleControllerGetWithStatsData = {
   /**
-   * Expected transaction ID
+   * Rule ID
    */
   id: string;
   /**
@@ -8109,14 +8517,14 @@ export type ExpectedTransactionControllerUndoSkipData = {
     | 'us';
 };
 
-export type ExpectedTransactionControllerUndoSkipResponse =
-  ExpectedTransactionResponseDto;
+export type RecurringRuleControllerGetWithStatsResponse =
+  RecurringRuleWithStatsResponseDto;
 
-export type ExpectedTransactionControllerConfirmMatchData = {
+export type ExpectedTransactionControllerFindAllData = {
   /**
-   * Expected transaction ID
+   * Filter by date range start (YYYY-MM-DD)
    */
-  id: string;
+  fromDate?: string;
   /**
    * Region code for tenant context
    */
@@ -8146,16 +8554,24 @@ export type ExpectedTransactionControllerConfirmMatchData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: ConfirmMatchDto;
+  /**
+   * Filter by recurring rule ID
+   */
+  ruleId?: string;
+  /**
+   * Filter by status (PENDING, COMPLETED, SKIPPED)
+   */
+  status?: string;
+  /**
+   * Filter by date range end (YYYY-MM-DD)
+   */
+  toDate?: string;
 };
 
-export type ExpectedTransactionControllerConfirmMatchResponse = unknown;
+export type ExpectedTransactionControllerFindAllResponse =
+  ExpectedTransactionListResponseDto;
 
-export type ExpectedTransactionControllerUnmatchData = {
-  /**
-   * Expected transaction ID
-   */
-  id: string;
+export type ExpectedTransactionControllerFindOverdueData = {
   /**
    * Region code for tenant context
    */
@@ -8187,9 +8603,10 @@ export type ExpectedTransactionControllerUnmatchData = {
     | 'us';
 };
 
-export type ExpectedTransactionControllerUnmatchResponse = unknown;
+export type ExpectedTransactionControllerFindOverdueResponse =
+  ExpectedTransactionListResponseDto;
 
-export type ExpectedTransactionControllerEnterNowData = {
+export type ExpectedTransactionControllerFindOneData = {
   /**
    * Expected transaction ID
    */
@@ -8223,16 +8640,16 @@ export type ExpectedTransactionControllerEnterNowData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: EnterNowDto;
 };
 
-export type ExpectedTransactionControllerEnterNowResponse = unknown;
+export type ExpectedTransactionControllerFindOneResponse =
+  ExpectedTransactionResponseDto;
 
-export type ForecastControllerGetForecastData = {
+export type ExpectedTransactionControllerSkipData = {
   /**
-   * Number of months to forecast (1-12, default 3)
+   * Expected transaction ID
    */
-  months?: number;
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -8264,17 +8681,14 @@ export type ForecastControllerGetForecastData = {
     | 'us';
 };
 
-export type ForecastControllerGetForecastResponse = ForecastResponseDto;
+export type ExpectedTransactionControllerSkipResponse =
+  ExpectedTransactionResponseDto;
 
-export type ReportingControllerGetPortfolioTrendsData = {
-  /**
-   * Data granularity
-   */
-  granularity?: 'day' | 'week' | 'month';
+export type ExpectedTransactionControllerUndoSkipData = {
   /**
-   * Time period
+   * Expected transaction ID
    */
-  period?: '1m' | '3m' | '6m' | '1y';
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -8306,18 +8720,13 @@ export type ReportingControllerGetPortfolioTrendsData = {
     | 'us';
 };
 
-export type ReportingControllerGetPortfolioTrendsResponse =
-  PortfolioTrendsResponseDto;
+export type ExpectedTransactionControllerUndoSkipResponse = void;
 
-export type ReportingControllerGetCashFlowTrendsData = {
-  /**
-   * Data granularity (accepted for API symmetry; v1 returns month buckets)
-   */
-  granularity?: 'day' | 'week' | 'month';
+export type ExpectedTransactionControllerConfirmMatchData = {
   /**
-   * Time period
+   * Expected transaction ID
    */
-  period?: '1m' | '3m' | '6m' | '1y';
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -8347,12 +8756,16 @@ export type ReportingControllerGetCashFlowTrendsData = {
     | 'sg'
     | 'tw'
     | 'us';
+  requestBody: ConfirmMatchDto;
 };
 
-export type ReportingControllerGetCashFlowTrendsResponse =
-  CashFlowTrendsResponseDto;
+export type ExpectedTransactionControllerConfirmMatchResponse = unknown;
 
-export type ReportingControllerGenerateSnapshotData = {
+export type ExpectedTransactionControllerUnmatchData = {
+  /**
+   * Expected transaction ID
+   */
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -8382,16 +8795,15 @@ export type ReportingControllerGenerateSnapshotData = {
     | 'sg'
     | 'tw'
     | 'us';
-  /**
-   * Optional date (defaults to today)
-   */
-  requestBody: GenerateSnapshotBody;
 };
 
-export type ReportingControllerGenerateSnapshotResponse =
-  GenerateSnapshotResponse;
+export type ExpectedTransactionControllerUnmatchResponse = void;
 
-export type ReportingControllerBackfillSnapshotsData = {
+export type ExpectedTransactionControllerEnterNowData = {
+  /**
+   * Expected transaction ID
+   */
+  id: string;
   /**
    * Region code for tenant context
    */
@@ -8411,108 +8823,58 @@ export type ReportingControllerBackfillSnapshotsData = {
     | 'dz'
     | 'es'
     | 'fr'
-    | 'gb'
-    | 'hk'
-    | 'in'
-    | 'it'
-    | 'jp'
-    | 'kr'
-    | 'nl'
-    | 'sg'
-    | 'tw'
-    | 'us';
-  requestBody: BackfillSnapshotsBody;
-};
-
-export type ReportingControllerBackfillSnapshotsResponse =
-  BackfillSnapshotsResponse;
-
-export type UserControllerDeleteOwnUserData = {
-  requestBody: DeleteOwnUserDto;
-};
-
-export type UserControllerDeleteOwnUserResponse = void;
-
-export type UserControllerGetUserData = {
-  acceptLanguage: string;
-};
-
-export type UserControllerGetUserResponse = unknown;
-
-export type UserControllerSignupUserData = {
-  requestBody: SignupDto;
-};
-
-export type UserControllerSignupUserResponse = SignupResponseDto;
-
-export type UserControllerDeleteUserData = {
-  /**
-   * User ID to delete
-   */
-  id: string;
-};
-
-export type UserControllerDeleteUserResponse = void;
-
-export type UserControllerGetUserInfoData = {
-  /**
-   * User ID
-   */
-  id: string;
-};
-
-export type UserControllerGetUserInfoResponse = unknown;
-
-export type UserControllerUpdateUserSettingData = {
-  requestBody: UpdateUserSettingDto;
-};
-
-export type UserControllerUpdateUserSettingResponse = unknown;
-
-export type UserControllerGetAllUserSettingsByPageData = {
-  /**
-   * Page number
-   */
-  pageNo: number;
-  /**
-   * Page size
-   */
-  pageSize: number;
-};
-
-export type UserControllerGetAllUserSettingsByPageResponse = unknown;
-
-export type UserControllerGetAssetLiabilitySummaryResponse = unknown;
-
-export type PropertyControllerGetAllResponse = unknown;
-
-export type PropertyControllerGetByKeyData = {
-  /**
-   * Property key
-   */
-  key: string;
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+  requestBody: EnterNowDto;
 };
 
-export type PropertyControllerGetByKeyResponse = unknown;
+export type ExpectedTransactionControllerEnterNowResponse = unknown;
 
-export type PropertyControllerUpdateData = {
+export type ForecastControllerGetForecastData = {
   /**
-   * Property key
+   * Number of months to forecast (1-12, default 3)
    */
-  key: string;
-  requestBody: UpdatePropertyDto;
-};
-
-export type PropertyControllerUpdateResponse = unknown;
-
-export type PropertyControllerDeleteData = {
+  months?: number;
   /**
-   * Property key
+   * Region code for tenant context
    */
-  key: string;
+  region:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
 };
 
-export type PropertyControllerDeleteResponse = void;
+export type ForecastControllerGetForecastResponse = ForecastResponseDto;
 
 export type TransactionRuleControllerCreateData = {
   /**
@@ -8909,6 +9271,55 @@ export type TransactionRuleControllerTestData = {
 
 export type TransactionRuleControllerTestResponse = TestRuleResponseDto;
 
+export type CategoryCatalogControllerListData = {
+  /**
+   * Region code for tenant context
+   */
+  region:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+  /**
+   * Filter by routeBearing (entity-router route() consumes it)
+   */
+  routeBearing?: boolean;
+  /**
+   * Filter by scenario
+   */
+  scenario?:
+    | 'expense'
+    | 'income'
+    | 'investment'
+    | 'banking'
+    | 'transfer'
+    | 'payment';
+};
+
+export type CategoryCatalogControllerListResponse =
+  CategoryCatalogListResponseDto;
+
 export type EventControllerCreateData = {
   /**
    * Region code for tenant context (decorative for life events)
@@ -9337,7 +9748,7 @@ export type ReconciliationControllerHistoryData = {
 export type ReconciliationControllerHistoryResponse =
   Array<ReconciliationRecordDto>;
 
-export type ExportControllerExportBeancountResponse = unknown;
+export type ExportControllerExportBeancountResponse = Blob | File;
 
 export type FileImportControllerImportFileData = {
   /**
@@ -10095,6 +10506,24 @@ export type PlatformControllerMatchPlatformsData = {
 
 export type PlatformControllerMatchPlatformsResponse = PlatformMatchResponseDto;
 
+export type PlatformControllerGetPlatformStandardsData = {
+  /**
+   * Platform ID (from a match result)
+   */
+  id: string;
+  /**
+   * Region code (ISO 3166-1 alpha-2, case-insensitive). Required for global platforms (countryCode null) — resolved as their template region; ignored when the platform has its own countryCode.
+   */
+  region?: string;
+  /**
+   * Filter templates by account type (path first segment)
+   */
+  type?: 'Assets' | 'Liabilities' | 'Income' | 'Expenses' | 'Equity';
+};
+
+export type PlatformControllerGetPlatformStandardsResponse =
+  PlatformStandardsResponseDto;
+
 export type PlatformControllerUpdateData = {
   /**
    * Platform ID
@@ -10344,6 +10773,42 @@ export type AuthControllerAccessTokenLoginData = {
 
 export type AuthControllerAccessTokenLoginResponse = AnonymousLoginResponseDto;
 
+export type ParserContributionControllerCreateData = {
+  /**
+   * Region code for tenant context (routing only; the institution region rides in the payload meta)
+   */
+  region:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+  requestBody: ParserContributionRequestDto;
+};
+
+export type ParserContributionControllerCreateResponse =
+  ParserContributionRelayResponseDto;
+
 export type CacheControllerFlushCacheResponse = unknown;
 
 export type ExchangeRateControllerGetExchangeRateData = {
@@ -11037,7 +11502,7 @@ export type $OpenApiTs = {
         /**
          * Payee profile unverified successfully
          */
-        200: PayeeProfileResponseDto;
+        204: void;
         /**
          * Admin access required
          */
@@ -11144,598 +11609,598 @@ export type $OpenApiTs = {
       };
     };
   };
-  '/api/v1/{region}/bean/prices': {
-    post: {
-      req: PriceControllerCreateData;
+  '/api/v1/{region}/reporting/portfolio/trends': {
+    get: {
+      req: ReportingControllerGetPortfolioTrendsData;
       res: {
         /**
-         * Price created successfully
-         */
-        201: PriceResponseDto;
-        /**
-         * Currency or quoteCurrency commodity not found
-         */
-        404: unknown;
-        /**
-         * Price already exists for this currency pair and date
+         * Trends retrieved successfully
          */
-        409: unknown;
-      };
-    };
-    get: {
-      req: PriceControllerFindAllData;
-      res: {
+        200: PortfolioTrendsResponseDto;
         /**
-         * Prices retrieved successfully
+         * User not authenticated
          */
-        200: PriceListResponseDto;
+        401: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/prices/{id}': {
+  '/api/v1/{region}/reporting/cash-flow/trends': {
     get: {
-      req: PriceControllerFindOneData;
-      res: {
-        /**
-         * Price retrieved successfully
-         */
-        200: PriceResponseDto;
-        /**
-         * Price not found
-         */
-        404: unknown;
-      };
-    };
-    put: {
-      req: PriceControllerUpdateData;
+      req: ReportingControllerGetCashFlowTrendsData;
       res: {
         /**
-         * Price updated successfully
-         */
-        200: PriceResponseDto;
-        /**
-         * Price not found
+         * Cash-flow trends retrieved successfully
          */
-        404: unknown;
+        200: CashFlowTrendsResponseDto;
         /**
-         * Updated price conflicts with existing price
+         * User not authenticated
          */
-        409: unknown;
+        401: unknown;
       };
     };
-    delete: {
-      req: PriceControllerDeleteData;
+  };
+  '/api/v1/{region}/reporting/snapshots/generate': {
+    post: {
+      req: ReportingControllerGenerateSnapshotData;
       res: {
         /**
-         * Price deleted successfully
+         * Snapshot generated successfully
          */
-        204: void;
+        200: GenerateSnapshotResponse;
         /**
-         * Price not found
+         * Invalid date format
          */
-        404: unknown;
-      };
-    };
-  };
-  '/api/v1/{region}/bean/prices/bulk': {
-    post: {
-      req: PriceControllerBulkCreateData;
-      res: {
+        400: unknown;
         /**
-         * Prices created successfully
+         * User not authenticated
          */
-        201: Array<PriceResponseDto>;
+        401: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules': {
+  '/api/v1/{region}/reporting/snapshots/backfill': {
     post: {
-      req: RecurringRuleControllerCreateData;
+      req: ReportingControllerBackfillSnapshotsData;
       res: {
         /**
-         * Rule created successfully
+         * Backfill completed successfully
          */
-        201: RecurringRuleResponseDto;
+        200: BackfillSnapshotsResponse;
         /**
-         * Invalid input data (e.g., autoCreate without accounts)
+         * Invalid date format or range
          */
         400: unknown;
         /**
-         * Rule with same name already exists
+         * User not authenticated
          */
-        409: unknown;
-      };
-    };
-    get: {
-      req: RecurringRuleControllerFindAllData;
-      res: {
+        401: unknown;
         /**
-         * Rules retrieved successfully
+         * Backfill already in progress for this user
          */
-        200: Array<RecurringRuleResponseDto>;
+        409: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules/from-transaction/{transactionId}': {
+  '/api/v1/{region}/bean/prices': {
     post: {
-      req: RecurringRuleControllerCreateFromTransactionData;
+      req: PriceControllerCreateData;
       res: {
         /**
-         * Rule created successfully
+         * Price created successfully
          */
-        201: RecurringRuleResponseDto;
+        201: PriceResponseDto;
         /**
-         * Transaction not found
+         * Currency or quoteCurrency commodity not found
+         */
+        404: unknown;
+        /**
+         * Price already exists for this currency pair and date
          */
-        404: ApiProblemResponseDto;
+        409: unknown;
+      };
+    };
+    get: {
+      req: PriceControllerFindAllData;
+      res: {
         /**
-         * Rule with same name already exists or transaction already linked
+         * Prices retrieved successfully
          */
-        409: ApiProblemResponseDto;
+        200: PriceListResponseDto;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules/{id}': {
+  '/api/v1/{region}/bean/prices/{id}': {
     get: {
-      req: RecurringRuleControllerFindOneData;
+      req: PriceControllerFindOneData;
       res: {
         /**
-         * Rule retrieved successfully
+         * Price retrieved successfully
          */
-        200: RecurringRuleResponseDto;
+        200: PriceResponseDto;
         /**
-         * Rule not found
+         * Price not found
          */
         404: unknown;
       };
     };
-    patch: {
-      req: RecurringRuleControllerUpdateData;
+    put: {
+      req: PriceControllerUpdateData;
       res: {
         /**
-         * Rule updated successfully
+         * Price updated successfully
          */
-        200: RecurringRuleResponseDto;
+        200: PriceResponseDto;
         /**
-         * Invalid input data
+         * Price not found
          */
-        400: unknown;
+        404: unknown;
         /**
-         * Rule not found
+         * Updated price conflicts with existing price
          */
-        404: unknown;
+        409: unknown;
       };
     };
     delete: {
-      req: RecurringRuleControllerDeleteData;
+      req: PriceControllerDeleteData;
       res: {
         /**
-         * Rule deleted successfully
+         * Price deleted successfully
          */
         204: void;
         /**
-         * Rule not found
+         * Price not found
          */
         404: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules/{id}/stats': {
-    get: {
-      req: RecurringRuleControllerGetWithStatsData;
+  '/api/v1/{region}/bean/prices/bulk': {
+    post: {
+      req: PriceControllerBulkCreateData;
       res: {
         /**
-         * Rule with stats retrieved successfully
-         */
-        200: RecurringRuleWithStatsResponseDto;
-        /**
-         * Rule not found
+         * Prices created successfully
          */
-        404: unknown;
+        201: Array<PriceResponseDto>;
       };
     };
   };
-  '/api/v1/{region}/bean/expected-transactions': {
-    get: {
-      req: ExpectedTransactionControllerFindAllData;
+  '/api/v1/users': {
+    delete: {
+      req: UserControllerDeleteOwnUserData;
       res: {
         /**
-         * Expected transactions retrieved successfully
+         * User deleted successfully
          */
-        200: ExpectedTransactionListResponseDto;
-      };
-    };
-  };
-  '/api/v1/{region}/bean/expected-transactions/overdue': {
-    get: {
-      req: ExpectedTransactionControllerFindOverdueData;
-      res: {
+        204: void;
         /**
-         * Overdue transactions retrieved successfully
+         * Invalid access token
          */
-        200: ExpectedTransactionListResponseDto;
+        403: unknown;
       };
     };
-  };
-  '/api/v1/{region}/bean/expected-transactions/{id}': {
     get: {
-      req: ExpectedTransactionControllerFindOneData;
+      req: UserControllerGetUserData;
       res: {
         /**
-         * Expected transaction retrieved successfully
-         */
-        200: ExpectedTransactionResponseDto;
-        /**
-         * Expected transaction not found
+         * User retrieved successfully
          */
-        404: unknown;
+        200: UserResponseDto;
       };
     };
-  };
-  '/api/v1/{region}/bean/expected-transactions/{id}/skip': {
     post: {
-      req: ExpectedTransactionControllerSkipData;
+      req: UserControllerSignupUserData;
       res: {
         /**
-         * Expected transaction skipped successfully
+         * User created successfully
          */
-        200: ExpectedTransactionResponseDto;
+        201: SignupResponseDto;
         /**
-         * Cannot skip - not in PENDING status
+         * Invalid Turnstile token (when Turnstile is enabled)
          */
         400: unknown;
         /**
-         * Expected transaction not found
+         * User signup is disabled
          */
-        404: unknown;
+        403: unknown;
       };
     };
+  };
+  '/api/v1/users/{id}': {
     delete: {
-      req: ExpectedTransactionControllerUndoSkipData;
+      req: UserControllerDeleteUserData;
       res: {
         /**
-         * Skip undone successfully
-         */
-        200: ExpectedTransactionResponseDto;
-        /**
-         * Cannot undo - not in SKIPPED status
+         * User deleted successfully
          */
-        400: unknown;
+        204: void;
         /**
-         * Expected transaction not found
+         * Cannot delete own account or insufficient permissions
          */
-        404: unknown;
+        403: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/expected-transactions/{id}/match': {
-    post: {
-      req: ExpectedTransactionControllerConfirmMatchData;
+  '/api/v1/users/{id}/info': {
+    get: {
+      req: UserControllerGetUserInfoData;
       res: {
         /**
-         * Match confirmed successfully
+         * User info retrieved successfully
          */
         200: unknown;
         /**
-         * Cannot match - not in PENDING status
-         */
-        400: unknown;
-        /**
-         * Expected or actual transaction not found
-         */
-        404: unknown;
-        /**
-         * Actual transaction already matched to another rule
+         * Cannot access other user info without admin permission
          */
-        409: unknown;
+        403: unknown;
       };
     };
-    delete: {
-      req: ExpectedTransactionControllerUnmatchData;
+  };
+  '/api/v1/users/setting': {
+    put: {
+      req: UserControllerUpdateUserSettingData;
       res: {
         /**
-         * Match removed successfully
+         * Settings updated successfully
          */
         200: unknown;
         /**
-         * Cannot unmatch - not in COMPLETED status
-         */
-        400: unknown;
-        /**
-         * Expected transaction not found
+         * Insufficient permissions
          */
-        404: unknown;
+        403: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/expected-transactions/{id}/enter': {
-    post: {
-      req: ExpectedTransactionControllerEnterNowData;
+  '/api/v1/users/settings-by-page': {
+    get: {
+      req: UserControllerGetAllUserSettingsByPageData;
       res: {
         /**
-         * Transaction created successfully
-         */
-        201: unknown;
-        /**
-         * Cannot enter - not in PENDING status or missing accounts
-         */
-        400: unknown;
-        /**
-         * Expected transaction or accounts not found
+         * Settings list retrieved successfully
          */
-        404: unknown;
+        200: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring/forecast': {
+  '/api/v1/users/asset-liability-summary': {
     get: {
-      req: ForecastControllerGetForecastData;
       res: {
         /**
-         * Forecast retrieved successfully
+         * Summary retrieved successfully
          */
-        200: ForecastResponseDto;
+        200: unknown;
       };
     };
   };
-  '/api/v1/{region}/reporting/portfolio/trends': {
+  '/api/v1/admin/properties': {
     get: {
-      req: ReportingControllerGetPortfolioTrendsData;
       res: {
         /**
-         * Trends retrieved successfully
+         * Properties retrieved successfully
          */
-        200: PortfolioTrendsResponseDto;
+        200: unknown;
         /**
-         * User not authenticated
+         * Unauthorized
          */
         401: unknown;
+        /**
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
       };
     };
   };
-  '/api/v1/{region}/reporting/cash-flow/trends': {
+  '/api/v1/admin/properties/{key}': {
     get: {
-      req: ReportingControllerGetCashFlowTrendsData;
+      req: PropertyControllerGetByKeyData;
       res: {
         /**
-         * Cash-flow trends retrieved successfully
+         * Property retrieved successfully
          */
-        200: CashFlowTrendsResponseDto;
+        200: unknown;
         /**
-         * User not authenticated
+         * Unauthorized
          */
         401: unknown;
+        /**
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
+        /**
+         * Property not found
+         */
+        404: unknown;
       };
     };
-  };
-  '/api/v1/{region}/reporting/snapshots/generate': {
-    post: {
-      req: ReportingControllerGenerateSnapshotData;
+    put: {
+      req: PropertyControllerUpdateData;
       res: {
         /**
-         * Snapshot generated successfully
+         * Property updated successfully
          */
-        200: GenerateSnapshotResponse;
+        200: unknown;
         /**
-         * Invalid date format
+         * Unauthorized
          */
-        400: unknown;
+        401: unknown;
         /**
-         * User not authenticated
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
+      };
+    };
+    delete: {
+      req: PropertyControllerDeleteData;
+      res: {
+        /**
+         * Property deleted successfully
+         */
+        204: void;
+        /**
+         * Unauthorized
          */
         401: unknown;
+        /**
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
+        /**
+         * Property not found
+         */
+        404: unknown;
       };
     };
   };
-  '/api/v1/{region}/reporting/snapshots/backfill': {
+  '/api/v1/{region}/bean/recurring-rules': {
     post: {
-      req: ReportingControllerBackfillSnapshotsData;
+      req: RecurringRuleControllerCreateData;
       res: {
         /**
-         * Backfill completed successfully
+         * Rule created successfully
          */
-        200: BackfillSnapshotsResponse;
+        201: RecurringRuleResponseDto;
         /**
-         * Invalid date format or range
+         * Invalid input data (e.g., autoCreate without accounts)
          */
         400: unknown;
         /**
-         * User not authenticated
+         * Rule with same name already exists
          */
-        401: unknown;
+        409: unknown;
+      };
+    };
+    get: {
+      req: RecurringRuleControllerFindAllData;
+      res: {
         /**
-         * Backfill already in progress for this user
+         * Rules retrieved successfully
          */
-        409: unknown;
+        200: Array<RecurringRuleResponseDto>;
       };
     };
   };
-  '/api/v1/users': {
-    delete: {
-      req: UserControllerDeleteOwnUserData;
+  '/api/v1/{region}/bean/recurring-rules/from-transaction/{transactionId}': {
+    post: {
+      req: RecurringRuleControllerCreateFromTransactionData;
       res: {
         /**
-         * User deleted successfully
+         * Rule created successfully
          */
-        204: void;
+        201: RecurringRuleResponseDto;
         /**
-         * Invalid access token
+         * Transaction not found
          */
-        403: unknown;
+        404: ApiProblemResponseDto;
+        /**
+         * Rule with same name already exists or transaction already linked
+         */
+        409: ApiProblemResponseDto;
       };
     };
+  };
+  '/api/v1/{region}/bean/recurring-rules/{id}': {
     get: {
-      req: UserControllerGetUserData;
+      req: RecurringRuleControllerFindOneData;
       res: {
         /**
-         * User retrieved successfully
+         * Rule retrieved successfully
          */
-        200: unknown;
+        200: RecurringRuleResponseDto;
+        /**
+         * Rule not found
+         */
+        404: unknown;
       };
     };
-    post: {
-      req: UserControllerSignupUserData;
+    patch: {
+      req: RecurringRuleControllerUpdateData;
       res: {
         /**
-         * User created successfully
+         * Rule updated successfully
          */
-        201: SignupResponseDto;
+        200: RecurringRuleResponseDto;
         /**
-         * Invalid Turnstile token (when Turnstile is enabled)
+         * Invalid input data
          */
         400: unknown;
         /**
-         * User signup is disabled
+         * Rule not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
-  };
-  '/api/v1/users/{id}': {
     delete: {
-      req: UserControllerDeleteUserData;
+      req: RecurringRuleControllerDeleteData;
       res: {
         /**
-         * User deleted successfully
+         * Rule deleted successfully
          */
         204: void;
         /**
-         * Cannot delete own account or insufficient permissions
+         * Rule not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
   };
-  '/api/v1/users/{id}/info': {
+  '/api/v1/{region}/bean/recurring-rules/{id}/stats': {
     get: {
-      req: UserControllerGetUserInfoData;
+      req: RecurringRuleControllerGetWithStatsData;
       res: {
         /**
-         * User info retrieved successfully
+         * Rule with stats retrieved successfully
          */
-        200: unknown;
+        200: RecurringRuleWithStatsResponseDto;
         /**
-         * Cannot access other user info without admin permission
+         * Rule not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
   };
-  '/api/v1/users/setting': {
-    put: {
-      req: UserControllerUpdateUserSettingData;
+  '/api/v1/{region}/bean/expected-transactions': {
+    get: {
+      req: ExpectedTransactionControllerFindAllData;
       res: {
         /**
-         * Settings updated successfully
-         */
-        200: unknown;
-        /**
-         * Insufficient permissions
+         * Expected transactions retrieved successfully
          */
-        403: unknown;
+        200: ExpectedTransactionListResponseDto;
       };
     };
   };
-  '/api/v1/users/settings-by-page': {
+  '/api/v1/{region}/bean/expected-transactions/overdue': {
     get: {
-      req: UserControllerGetAllUserSettingsByPageData;
+      req: ExpectedTransactionControllerFindOverdueData;
       res: {
         /**
-         * Settings list retrieved successfully
+         * Overdue transactions retrieved successfully
          */
-        200: unknown;
+        200: ExpectedTransactionListResponseDto;
       };
     };
   };
-  '/api/v1/users/asset-liability-summary': {
+  '/api/v1/{region}/bean/expected-transactions/{id}': {
     get: {
+      req: ExpectedTransactionControllerFindOneData;
       res: {
         /**
-         * Summary retrieved successfully
+         * Expected transaction retrieved successfully
          */
-        200: unknown;
+        200: ExpectedTransactionResponseDto;
+        /**
+         * Expected transaction not found
+         */
+        404: unknown;
       };
     };
   };
-  '/api/v1/admin/properties': {
-    get: {
+  '/api/v1/{region}/bean/expected-transactions/{id}/skip': {
+    post: {
+      req: ExpectedTransactionControllerSkipData;
       res: {
         /**
-         * Properties retrieved successfully
+         * Expected transaction skipped successfully
          */
-        200: unknown;
+        200: ExpectedTransactionResponseDto;
         /**
-         * Unauthorized
+         * Cannot skip - not in PENDING status
          */
-        401: unknown;
+        400: unknown;
         /**
-         * Forbidden - insufficient permissions
+         * Expected transaction not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
-  };
-  '/api/v1/admin/properties/{key}': {
-    get: {
-      req: PropertyControllerGetByKeyData;
+    delete: {
+      req: ExpectedTransactionControllerUndoSkipData;
       res: {
         /**
-         * Property retrieved successfully
-         */
-        200: unknown;
-        /**
-         * Unauthorized
+         * Skip undone successfully
          */
-        401: unknown;
+        204: void;
         /**
-         * Forbidden - insufficient permissions
+         * Cannot undo - not in SKIPPED status
          */
-        403: unknown;
+        400: unknown;
         /**
-         * Property not found
+         * Expected transaction not found
          */
         404: unknown;
       };
     };
-    put: {
-      req: PropertyControllerUpdateData;
+  };
+  '/api/v1/{region}/bean/expected-transactions/{id}/match': {
+    post: {
+      req: ExpectedTransactionControllerConfirmMatchData;
       res: {
         /**
-         * Property updated successfully
+         * Match confirmed successfully
          */
         200: unknown;
         /**
-         * Unauthorized
+         * Cannot match - not in PENDING status
          */
-        401: unknown;
+        400: unknown;
         /**
-         * Forbidden - insufficient permissions
+         * Expected or actual transaction not found
          */
-        403: unknown;
+        404: unknown;
+        /**
+         * Actual transaction already matched to another rule
+         */
+        409: unknown;
       };
     };
     delete: {
-      req: PropertyControllerDeleteData;
+      req: ExpectedTransactionControllerUnmatchData;
       res: {
         /**
-         * Property deleted successfully
+         * Match removed successfully
          */
         204: void;
         /**
-         * Unauthorized
+         * Cannot unmatch - not in COMPLETED status
          */
-        401: unknown;
+        400: unknown;
         /**
-         * Forbidden - insufficient permissions
+         * Expected transaction not found
          */
-        403: unknown;
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/expected-transactions/{id}/enter': {
+    post: {
+      req: ExpectedTransactionControllerEnterNowData;
+      res: {
         /**
-         * Property not found
+         * Transaction created successfully
+         */
+        201: unknown;
+        /**
+         * Cannot enter - not in PENDING status or missing accounts
+         */
+        400: unknown;
+        /**
+         * Expected transaction or accounts not found
          */
         404: unknown;
       };
     };
   };
+  '/api/v1/{region}/bean/recurring/forecast': {
+    get: {
+      req: ForecastControllerGetForecastData;
+      res: {
+        /**
+         * Forecast retrieved successfully
+         */
+        200: ForecastResponseDto;
+      };
+    };
+  };
   '/api/v1/{region}/bean/transaction-rules': {
     post: {
       req: TransactionRuleControllerCreateData;
@@ -11944,6 +12409,17 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/categories': {
+    get: {
+      req: CategoryCatalogControllerListData;
+      res: {
+        /**
+         * Category catalog retrieved successfully
+         */
+        200: CategoryCatalogListResponseDto;
+      };
+    };
+  };
   '/api/v1/{region}/bean/events': {
     post: {
       req: EventControllerCreateData;
@@ -12122,7 +12598,10 @@ export type $OpenApiTs = {
   '/api/v1/{region}/bean/export/beancount': {
     get: {
       res: {
-        200: unknown;
+        /**
+         * ZIP archive (application/zip) streamed as an attachment
+         */
+        200: Blob | File;
       };
     };
   };
@@ -12503,6 +12982,17 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/bean/platforms/{id}/standards': {
+    get: {
+      req: PlatformControllerGetPlatformStandardsData;
+      res: {
+        /**
+         * Resolved region plus the merged account-standard catalog of that region (groupable by productCategory client-side)
+         */
+        200: PlatformStandardsResponseDto;
+      };
+    };
+  };
   '/api/v1/bean/platforms/{id}': {
     put: {
       req: PlatformControllerUpdateData;
@@ -12650,10 +13140,48 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/community/parser-contributions': {
+    post: {
+      req: ParserContributionControllerCreateData;
+      res: {
+        /**
+         * Issue created by the bot
+         */
+        201: ParserContributionRelayResponseDto;
+        /**
+         * Unauthorized
+         */
+        401: ApiProblemResponseDto;
+        /**
+         * Validation failed (institution slug, empty samples, row/cell size limits)
+         */
+        422: ApiProblemResponseDto;
+        /**
+         * Rate limited (5 submissions per user per hour)
+         */
+        429: ApiProblemResponseDto;
+        /**
+         * Relay not configured on this deployment — clients fall back to the clipboard flow
+         */
+        501: ApiProblemResponseDto;
+        /**
+         * GitHub bot failure (upstream), safe to retry
+         */
+        502: ApiProblemResponseDto;
+      };
+    };
+  };
   '/api/v1/cache/flush': {
     post: {
       res: {
-        201: unknown;
+        /**
+         * Cache flushed successfully
+         */
+        200: unknown;
+        /**
+         * Admin access required
+         */
+        403: ApiProblemResponseDto;
       };
     };
   };