@firela/api-types 0.0.0-canary.da5984a1 → 0.0.0-canary.ebb51de2

package/src/generated/services.gen.ts

@@ -29,6 +29,8 @@ import type {
   TransactionControllerListResponse,
   TransactionControllerCreateBatchData,
   TransactionControllerCreateBatchResponse,
+  TransactionControllerCorrectData,
+  TransactionControllerCorrectResponse,
   TransactionControllerSuggestTagsData,
   TransactionControllerSuggestTagsResponse,
   TransactionControllerGetDetailData,
@@ -200,6 +202,10 @@ import type {
   ProviderSyncControllerIsProviderSupportedResponse,
   TelemetryControllerReportTelemetryData,
   TelemetryControllerReportTelemetryResponse,
+  TelemetryControllerReportCoverageMissData,
+  TelemetryControllerReportCoverageMissResponse,
+  TelemetryControllerGetCoverageMetricsData,
+  TelemetryControllerGetCoverageMetricsResponse,
   NlpControllerProcessNaturalLanguageData,
   NlpControllerProcessNaturalLanguageResponse,
   NlpControllerClearSessionData,
@@ -212,6 +218,20 @@ import type {
   DashboardControllerGetAccountsResponse,
   DashboardControllerGetCashFlowData,
   DashboardControllerGetCashFlowResponse,
+  HoldingPnlControllerGetHoldingPnlData,
+  HoldingPnlControllerGetHoldingPnlResponse,
+  PriceControllerCreateData,
+  PriceControllerCreateResponse,
+  PriceControllerFindAllData,
+  PriceControllerFindAllResponse,
+  PriceControllerFindOneData,
+  PriceControllerFindOneResponse,
+  PriceControllerUpdateData,
+  PriceControllerUpdateResponse,
+  PriceControllerDeleteData,
+  PriceControllerDeleteResponse,
+  PriceControllerBulkCreateData,
+  PriceControllerBulkCreateResponse,
   ReportingControllerGetPortfolioTrendsData,
   ReportingControllerGetPortfolioTrendsResponse,
   ReportingControllerGenerateSnapshotData,
@@ -237,12 +257,10 @@ import type {
 
 export class BeanAccountsService {
   /**
-   * Create a new account
-   * Creates a new account (Beancount Open directive)
    * @param data The data for the request.
    * @param data.region Region code for tenant context
    * @param data.requestBody
-   * @returns AccountResponseDto Account created successfully
+   * @returns unknown
    * @throws ApiError
    */
   public static accountControllerCreate(
@@ -255,10 +273,7 @@ export class BeanAccountsService {
         region: data.region
       },
       body: data.requestBody,
-      mediaType: 'application/json',
-      errors: {
-        409: 'Account already exists'
-      }
+      mediaType: 'application/json'
     });
   }
 
@@ -322,13 +337,11 @@ export class BeanAccountsService {
   }
 
   /**
-   * Update account
-   * Updates account metadata (path cannot be changed)
    * @param data The data for the request.
-   * @param data.id Account UUID
+   * @param data.id
    * @param data.region Region code for tenant context
    * @param data.requestBody
-   * @returns AccountResponseDto Account updated successfully
+   * @returns unknown
    * @throws ApiError
    */
   public static accountControllerUpdate(
@@ -342,20 +355,15 @@ export class BeanAccountsService {
         region: data.region
       },
       body: data.requestBody,
-      mediaType: 'application/json',
-      errors: {
-        404: 'Account not found'
-      }
+      mediaType: 'application/json'
     });
   }
 
   /**
-   * Delete account
-   * Deletes an account (only if no transactions)
    * @param data The data for the request.
-   * @param data.id Account UUID
+   * @param data.id
    * @param data.region Region code for tenant context
-   * @returns void Account deleted successfully
+   * @returns unknown
    * @throws ApiError
    */
   public static accountControllerDelete(
@@ -367,22 +375,16 @@ export class BeanAccountsService {
       path: {
         id: data.id,
         region: data.region
-      },
-      errors: {
-        404: 'Account not found',
-        409: 'Account has transactions and cannot be deleted'
       }
     });
   }
 
   /**
-   * Close account
-   * Closes an account (Beancount Close directive)
    * @param data The data for the request.
-   * @param data.id Account UUID
+   * @param data.id
    * @param data.region Region code for tenant context
    * @param data.requestBody
-   * @returns AccountResponseDto Account closed successfully
+   * @returns unknown
    * @throws ApiError
    */
   public static accountControllerClose(
@@ -396,22 +398,16 @@ export class BeanAccountsService {
         region: data.region
       },
       body: data.requestBody,
-      mediaType: 'application/json',
-      errors: {
-        400: 'Account is already closed',
-        404: 'Account not found'
-      }
+      mediaType: 'application/json'
     });
   }
 
   /**
-   * Reopen account
-   * Reopens a previously closed account
    * @param data The data for the request.
-   * @param data.id Account UUID
+   * @param data.id
    * @param data.region Region code for tenant context
    * @param data.requestBody
-   * @returns AccountResponseDto Account reopened successfully
+   * @returns unknown
    * @throws ApiError
    */
   public static accountControllerReopen(
@@ -425,11 +421,7 @@ export class BeanAccountsService {
         region: data.region
       },
       body: data.requestBody,
-      mediaType: 'application/json',
-      errors: {
-        400: 'Account is not closed',
-        404: 'Account not found'
-      }
+      mediaType: 'application/json'
     });
   }
 }
@@ -605,6 +597,36 @@ export class BeanTransactionsService {
     });
   }
 
+  /**
+   * Correct (supersede) a transaction
+   * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
+   * @param data The data for the request.
+   * @param data.id Original transaction ID to correct
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns TransactionDetailDto Corrected transaction created
+   * @throws ApiError
+   */
+  public static transactionControllerCorrect(
+    data: TransactionControllerCorrectData
+  ): CancelablePromise<TransactionControllerCorrectResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/transactions/{id}/correct',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        404: 'Original transaction not found',
+        409: 'Original no longer ACTIVE (concurrent modification)',
+        422: 'Pipeline validation failed (does not balance, invalid accounts)'
+      }
+    });
+  }
+
   /**
    * Suggest transaction tags
    * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.
@@ -2482,12 +2504,9 @@ export class BeanImportService {
   }
 
   /**
-   * Import a Beancount file in community format
-   * Upload a .beancount file to import. The system parses community-format paths, converts to internal format using category metadata, auto-creates accounts, and imports transactions with deduplication. Maximum file size: 50MB. Only 1 import per user at a time.
    * @param data The data for the request.
    * @param data.region Region code for tenant context
-   * @param data.formData Beancount file to import
-   * @returns unknown Beancount file imported successfully
+   * @returns unknown
    * @throws ApiError
    */
   public static fileImportControllerImportBeancount(
@@ -2498,11 +2517,6 @@ export class BeanImportService {
       url: '/api/v1/{region}/bean/import/beancount',
       path: {
         region: data.region
-      },
-      formData: data.formData,
-      mediaType: 'multipart/form-data',
-      errors: {
-        400: 'Bad request - invalid file or no file uploaded'
       }
     });
   }
@@ -2705,33 +2719,11 @@ export class BeanPlatformsService {
 
 export class ProviderSyncService {
   /**
-   * Sync transactions from financial data provider
-   *
-   * Accepts raw transactions from external financial data providers, transforms them to Beancount format, and processes them through the ingestion pipeline.
-   *
-   * **Supported Providers:**
-   * - **plaid**: Plaid API (US, Canada, Europe)
-   * - **teller**: Teller API (US)
-   * - **truelayer**: TrueLayer Open Banking (UK, Europe)
-   * - **gocardless**: GoCardless Bank Account Data (Europe)
-   * - **simplefin**: SimpleFIN (Self-hosted)
-   * - **yodlee**: Yodlee (Global)
-   * - **beancount-direct**: Beancount format transactions
-   * - **parsed-bill**: Client-side parsed bill transactions
-   *
-   * **Processing Flow:**
-   * 1. Transform raw data via provider adapter
-   * 2. Validate transaction format
-   * 3. Deduplicate using originalId
-   * 4. Classify using rule engine
-   * 5. Route low-confidence to Review Center
-   * 6. Persist validated transactions
-   *
    * @param data The data for the request.
-   * @param data.providerName Provider name
-   * @param data.region Region code
+   * @param data.providerName
+   * @param data.region Region code for tenant context
    * @param data.requestBody
-   * @returns ProviderSyncResponseDto Sync completed successfully
+   * @returns unknown
    * @throws ApiError
    */
   public static providerSyncControllerSync(
@@ -2745,12 +2737,7 @@ export class ProviderSyncService {
         region: data.region
       },
       body: data.requestBody,
-      mediaType: 'application/json',
-      errors: {
-        400: 'Invalid request data',
-        401: 'Missing or invalid authentication',
-        404: 'Provider not supported'
-      }
+      mediaType: 'application/json'
     });
   }
 
@@ -2828,16 +2815,62 @@ export class ImportTelemetryService {
       }
     });
   }
+
+  /**
+   * Receive anonymous zero-hit coverage miss report
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns unknown Coverage miss report received
+   * @throws ApiError
+   */
+  public static telemetryControllerReportCoverageMiss(
+    data: TelemetryControllerReportCoverageMissData
+  ): CancelablePromise<TelemetryControllerReportCoverageMissResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/import/parser-coverage-miss',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        401: 'Unauthorized'
+      }
+    });
+  }
+
+  /**
+   * Coverage metrics (uncovered format aggregation)
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.topN Top-N uncovered formats (default 10)
+   * @returns unknown Coverage metrics
+   * @throws ApiError
+   */
+  public static telemetryControllerGetCoverageMetrics(
+    data: TelemetryControllerGetCoverageMetricsData
+  ): CancelablePromise<TelemetryControllerGetCoverageMetricsResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/import/parser-coverage-metrics',
+      path: {
+        region: data.region
+      },
+      query: {
+        topN: data.topN
+      }
+    });
+  }
 }
 
 export class BeanNlpService {
   /**
-   * Process natural language input
-   * Parse natural language text (Chinese/English) describing a transaction. Supports multi-turn dialogue for collecting missing information. When confidence < 0.75, returns "confirm" action requiring user verification. User can reply with confirmation words (确认/yes/ok) or provide corrections. Examples: "yesterday Starbucks spent 35 yuan", "today lunch 28 yuan", "spent $50 at Walmart"
    * @param data The data for the request.
    * @param data.region Region code for tenant context
-   * @param data.requestBody Natural language transaction input with optional session ID
-   * @returns NlpResponseDto NLP processing result - either created transaction or asking for more info
+   * @param data.requestBody
+   * @returns unknown
    * @throws ApiError
    */
   public static nlpControllerProcessNaturalLanguage(
@@ -2850,11 +2883,7 @@ export class BeanNlpService {
         region: data.region
       },
       body: data.requestBody,
-      mediaType: 'application/json',
-      errors: {
-        400: 'Invalid input',
-        401: 'Unauthorized'
-      }
+      mediaType: 'application/json'
     });
   }
 
@@ -2948,6 +2977,7 @@ export class DashboardService {
    * @param data.region Region code for tenant context
    * @param data.groupBy Grouping strategy
    * @param data.date Date for balance calculation (ISO 8601 format)
+   * @param data.accountId Scope to a single account (only valid with groupBy=holdingAssetClass, ADR-0105 §6)
    * @returns unknown Accounts retrieved successfully. Response type depends on groupBy parameter.
    * @throws ApiError
    */
@@ -2962,7 +2992,8 @@ export class DashboardService {
       },
       query: {
         groupBy: data.groupBy,
-        date: data.date
+        date: data.date,
+        accountId: data.accountId
       },
       errors: {
         401: 'User not authenticated'
@@ -2999,6 +3030,207 @@ export class DashboardService {
   }
 }
 
+export class InvestmentService {
+  /**
+   * Get per-holding unrealized + realized P&L
+   * Average-cost unrealized P&L per account × commodity, plus cumulative realized P&L on sold lots (method = FIFO | average, default average).
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.asOf As-of date (ISO 8601), defaults to today
+   * @param data.accountId Scope to a single account
+   * @param data.method Realized-P&L lot-matching method (default average). Does not affect the average-cost unrealized basis.
+   * @returns HoldingPnlResponseDto Holding P&L retrieved successfully
+   * @throws ApiError
+   */
+  public static holdingPnlControllerGetHoldingPnl(
+    data: HoldingPnlControllerGetHoldingPnlData
+  ): CancelablePromise<HoldingPnlControllerGetHoldingPnlResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/investment/holdings/pnl',
+      path: {
+        region: data.region
+      },
+      query: {
+        asOf: data.asOf,
+        accountId: data.accountId,
+        method: data.method
+      },
+      errors: {
+        400: 'Invalid asOf format/value/future date, invalid accountId format, or unsupported method',
+        401: 'User not authenticated'
+      }
+    });
+  }
+}
+
+export class BeanPricesService {
+  /**
+   * Create a new price
+   * Creates a new price entry for the authenticated user
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns PriceResponseDto Price created successfully
+   * @throws ApiError
+   */
+  public static priceControllerCreate(
+    data: PriceControllerCreateData
+  ): CancelablePromise<PriceControllerCreateResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/prices',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        404: 'Currency or quoteCurrency commodity not found',
+        409: 'Price already exists for this currency pair and date'
+      }
+    });
+  }
+
+  /**
+   * List user prices
+   * Returns all price entries for the authenticated user with optional filtering
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.currency Filter by currency (e.g., BTC, AAPL, USD)
+   * @param data.quoteCurrency Filter by quote currency (pricing currency, e.g., USD, CNY)
+   * @param data.dateFrom Filter prices from this date (ISO 8601 format)
+   * @param data.dateTo Filter prices to this date (ISO 8601 format)
+   * @param data.search Search term for currency or quoteCurrency (case-insensitive partial match)
+   * @param data.page Page number for pagination (default: 1)
+   * @param data.limit Number of items per page (default: 20, max: 100)
+   * @returns PriceListResponseDto Prices retrieved successfully
+   * @throws ApiError
+   */
+  public static priceControllerFindAll(
+    data: PriceControllerFindAllData
+  ): CancelablePromise<PriceControllerFindAllResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/prices',
+      path: {
+        region: data.region
+      },
+      query: {
+        currency: data.currency,
+        quoteCurrency: data.quoteCurrency,
+        dateFrom: data.dateFrom,
+        dateTo: data.dateTo,
+        search: data.search,
+        page: data.page,
+        limit: data.limit
+      }
+    });
+  }
+
+  /**
+   * Get price by ID
+   * Returns a single price entry by its ID
+   * @param data The data for the request.
+   * @param data.id Price ID
+   * @param data.region Region code for tenant context
+   * @returns PriceResponseDto Price retrieved successfully
+   * @throws ApiError
+   */
+  public static priceControllerFindOne(
+    data: PriceControllerFindOneData
+  ): CancelablePromise<PriceControllerFindOneResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/prices/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: 'Price not found'
+      }
+    });
+  }
+
+  /**
+   * Update a price
+   * Updates an existing price entry
+   * @param data The data for the request.
+   * @param data.id Price ID
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns PriceResponseDto Price updated successfully
+   * @throws ApiError
+   */
+  public static priceControllerUpdate(
+    data: PriceControllerUpdateData
+  ): CancelablePromise<PriceControllerUpdateResponse> {
+    return __request(OpenAPI, {
+      method: 'PUT',
+      url: '/api/v1/{region}/bean/prices/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        404: 'Price not found',
+        409: 'Updated price conflicts with existing price'
+      }
+    });
+  }
+
+  /**
+   * Delete a price
+   * Deletes a price entry (hard delete)
+   * @param data The data for the request.
+   * @param data.id Price ID
+   * @param data.region Region code for tenant context
+   * @returns void Price deleted successfully
+   * @throws ApiError
+   */
+  public static priceControllerDelete(
+    data: PriceControllerDeleteData
+  ): CancelablePromise<PriceControllerDeleteResponse> {
+    return __request(OpenAPI, {
+      method: 'DELETE',
+      url: '/api/v1/{region}/bean/prices/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: 'Price not found'
+      }
+    });
+  }
+
+  /**
+   * Bulk create prices
+   * Creates multiple price entries at once (skips duplicates)
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns PriceResponseDto Prices created successfully
+   * @throws ApiError
+   */
+  public static priceControllerBulkCreate(
+    data: PriceControllerBulkCreateData
+  ): CancelablePromise<PriceControllerBulkCreateResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/prices/bulk',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json'
+    });
+  }
+}
+
 export class ReportingService {
   /**
    * Get portfolio value trends