@firela/api-types 0.0.0-canary.610daafc → 0.0.0-canary.6a42fd0e

package/src/generated/services.gen.ts

@@ -97,6 +97,18 @@ import type {
   CommodityControllerGetOrCreateResponse,
   CommodityControllerBulkCreateData,
   CommodityControllerBulkCreateResponse,
+  PriceControllerCreateData,
+  PriceControllerCreateResponse,
+  PriceControllerFindAllData,
+  PriceControllerFindAllResponse,
+  PriceControllerFindOneData,
+  PriceControllerFindOneResponse,
+  PriceControllerUpdateData,
+  PriceControllerUpdateResponse,
+  PriceControllerDeleteData,
+  PriceControllerDeleteResponse,
+  PriceControllerBulkCreateData,
+  PriceControllerBulkCreateResponse,
   RecurringRuleControllerCreateData,
   RecurringRuleControllerCreateResponse,
   RecurringRuleControllerFindAllData,
@@ -183,6 +195,14 @@ import type {
   EventControllerDeleteResponse,
   EventControllerGetSliceData,
   EventControllerGetSliceResponse,
+  ReconciliationControllerComputeData,
+  ReconciliationControllerComputeResponse,
+  ReconciliationControllerAssertData,
+  ReconciliationControllerAssertResponse,
+  ReconciliationControllerPadData,
+  ReconciliationControllerPadResponse,
+  ReconciliationControllerHistoryData,
+  ReconciliationControllerHistoryResponse,
   ExportControllerExportBeancountResponse,
   FileImportControllerImportFileData,
   FileImportControllerImportFileResponse,
@@ -234,18 +254,6 @@ import type {
   DashboardControllerGetExpensesResponse,
   HoldingPnlControllerGetHoldingPnlData,
   HoldingPnlControllerGetHoldingPnlResponse,
-  PriceControllerCreateData,
-  PriceControllerCreateResponse,
-  PriceControllerFindAllData,
-  PriceControllerFindAllResponse,
-  PriceControllerFindOneData,
-  PriceControllerFindOneResponse,
-  PriceControllerUpdateData,
-  PriceControllerUpdateResponse,
-  PriceControllerDeleteData,
-  PriceControllerDeleteResponse,
-  PriceControllerBulkCreateData,
-  PriceControllerBulkCreateResponse,
   ReportingControllerGetPortfolioTrendsData,
   ReportingControllerGetPortfolioTrendsResponse,
   ReportingControllerGetCashFlowTrendsData,
@@ -1515,6 +1523,173 @@ export class BeanCommoditiesService {
   }
 }
 
+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 RecurringRulesService {
   /**
    * Create a new recurring rule
@@ -2653,6 +2828,112 @@ export class LifeEventsService {
   }
 }
 
+export class BalanceReconciliationService {
+  /**
+   * Preview reconciliation (book vs actual)
+   * Computes book balance, diff, Beancount-inferred tolerance, and suggested action without persisting.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (decorative for reconciliation)
+   * @param data.requestBody
+   * @returns ReconciliationComputeResultDto Reconciliation preview
+   * @throws ApiError
+   */
+  public static reconciliationControllerCompute(
+    data: ReconciliationControllerComputeData
+  ): CancelablePromise<ReconciliationControllerComputeResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/reconciliations',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        404: 'Account not found'
+      }
+    });
+  }
+
+  /**
+   * Record a balance assertion
+   * Persists the reconciliation as a BeanBalance assertion (amount = actual, diffAmount = book − actual). Re-reconciling the same day/currency upserts.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (decorative for reconciliation)
+   * @param data.requestBody
+   * @returns ReconciliationRecordDto Balance assertion recorded
+   * @throws ApiError
+   */
+  public static reconciliationControllerAssert(
+    data: ReconciliationControllerAssertData
+  ): CancelablePromise<ReconciliationControllerAssertResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/reconciliations/assert',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        404: 'Account not found'
+      }
+    });
+  }
+
+  /**
+   * Generate a pad adjusting entry
+   * When book is outside tolerance, synthesizes a Beancount pad transaction (flag P) booking the diff from source_account and persists it. Source defaults to Equity:Opening-Balances.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (decorative for reconciliation)
+   * @param data.requestBody
+   * @returns PadResultDto Pad adjusting entry generated
+   * @throws ApiError
+   */
+  public static reconciliationControllerPad(
+    data: ReconciliationControllerPadData
+  ): CancelablePromise<ReconciliationControllerPadResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/reconciliations/pad',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        400: 'Book already within tolerance — no pad needed',
+        404: 'Account not found'
+      }
+    });
+  }
+
+  /**
+   * List reconciliation history for an account
+   * Returns recorded balance assertions (most recent first). The latest drives the account-detail "Last <date>" badge.
+   * @param data The data for the request.
+   * @param data.accountId BeanAccount id
+   * @param data.region Region code for tenant context (decorative for reconciliation)
+   * @returns ReconciliationRecordDto Reconciliation history
+   * @throws ApiError
+   */
+  public static reconciliationControllerHistory(
+    data: ReconciliationControllerHistoryData
+  ): CancelablePromise<ReconciliationControllerHistoryResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/accounts/{accountId}/reconciliations',
+      path: {
+        accountId: data.accountId,
+        region: data.region
+      },
+      errors: {
+        404: 'Account not found'
+      }
+    });
+  }
+}
+
 export class BeanExportService {
   /**
    * Export Beancount ledger as ZIP
@@ -3358,173 +3639,6 @@ export class InvestmentService {
   }
 }
 
-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