@firela/api-types 0.0.0-canary.1917579c → 0.0.0-canary.19fa1e7e

package/src/generated/services.gen.ts

@@ -29,6 +29,10 @@ import type {
   TransactionControllerListResponse,
   TransactionControllerCreateBatchData,
   TransactionControllerCreateBatchResponse,
+  TransactionControllerCorrectData,
+  TransactionControllerCorrectResponse,
+  TransactionControllerSuggestTagsData,
+  TransactionControllerSuggestTagsResponse,
   TransactionControllerGetDetailData,
   TransactionControllerGetDetailResponse,
   TransactionControllerUpdateData,
@@ -167,6 +171,18 @@ import type {
   PropertyControllerUpdateResponse,
   PropertyControllerDeleteData,
   PropertyControllerDeleteResponse,
+  EventControllerCreateData,
+  EventControllerCreateResponse,
+  EventControllerFindAllData,
+  EventControllerFindAllResponse,
+  EventControllerFindOneData,
+  EventControllerFindOneResponse,
+  EventControllerUpdateData,
+  EventControllerUpdateResponse,
+  EventControllerDeleteData,
+  EventControllerDeleteResponse,
+  EventControllerGetSliceData,
+  EventControllerGetSliceResponse,
   ExportControllerExportBeancountResponse,
   FileImportControllerImportFileData,
   FileImportControllerImportFileResponse,
@@ -198,6 +214,10 @@ import type {
   ProviderSyncControllerIsProviderSupportedResponse,
   TelemetryControllerReportTelemetryData,
   TelemetryControllerReportTelemetryResponse,
+  TelemetryControllerReportCoverageMissData,
+  TelemetryControllerReportCoverageMissResponse,
+  TelemetryControllerGetCoverageMetricsData,
+  TelemetryControllerGetCoverageMetricsResponse,
   NlpControllerProcessNaturalLanguageData,
   NlpControllerProcessNaturalLanguageResponse,
   NlpControllerClearSessionData,
@@ -210,8 +230,26 @@ import type {
   DashboardControllerGetAccountsResponse,
   DashboardControllerGetCashFlowData,
   DashboardControllerGetCashFlowResponse,
+  DashboardControllerGetExpensesData,
+  DashboardControllerGetExpensesResponse,
+  HoldingPnlControllerGetHoldingPnlData,
+  HoldingPnlControllerGetHoldingPnlResponse,
+  PriceControllerCreateData,
+  PriceControllerCreateResponse,
+  PriceControllerFindAllData,
+  PriceControllerFindAllResponse,
+  PriceControllerFindOneData,
+  PriceControllerFindOneResponse,
+  PriceControllerUpdateData,
+  PriceControllerUpdateResponse,
+  PriceControllerDeleteData,
+  PriceControllerDeleteResponse,
+  PriceControllerBulkCreateData,
+  PriceControllerBulkCreateResponse,
   ReportingControllerGetPortfolioTrendsData,
   ReportingControllerGetPortfolioTrendsResponse,
+  ReportingControllerGetCashFlowTrendsData,
+  ReportingControllerGetCashFlowTrendsResponse,
   ReportingControllerGenerateSnapshotData,
   ReportingControllerGenerateSnapshotResponse,
   ReportingControllerBackfillSnapshotsData,
@@ -547,6 +585,7 @@ export class BeanTransactionsService {
    * @param data.status Filter by transaction status
    * @param data.search Search in narration and payee fields (max 200 chars)
    * @param data.accountId Filter by account ID (transactions with postings to this account)
+   * @param data.category Filter by ADR-0075 functional category (Group segment); matches any posting to an Expenses/Income account whose derived Group segment equals this value
    * @returns TransactionListResponseDto Transaction list
    * @throws ApiError
    */
@@ -566,7 +605,8 @@ export class BeanTransactionsService {
         dateTo: data.dateTo,
         status: data.status,
         search: data.search,
-        accountId: data.accountId
+        accountId: data.accountId,
+        category: data.category
       },
       errors: {
         400: 'Validation failed',
@@ -603,6 +643,68 @@ 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.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.q Prefix match, case-insensitive (max 50 chars)
+   * @param data.sort usage (default) or name
+   * @param data.limit Max suggestions (1-100, default 10)
+   * @returns TagSuggestionsResponseDto Tag suggestions
+   * @throws ApiError
+   */
+  public static transactionControllerSuggestTags(
+    data: TransactionControllerSuggestTagsData
+  ): CancelablePromise<TransactionControllerSuggestTagsResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/transactions/tags',
+      path: {
+        region: data.region
+      },
+      query: {
+        q: data.q,
+        sort: data.sort,
+        limit: data.limit
+      },
+      errors: {
+        400: 'Validation failed',
+        401: 'Authentication required'
+      }
+    });
+  }
+
   /**
    * Get transaction detail
    * Returns transaction details including all postings
@@ -2376,6 +2478,181 @@ export class PropertiesService {
   }
 }
 
+export class LifeEventsService {
+  /**
+   * Create a new life event
+   * Creates a new life event entry for the authenticated user. Returns ETag header carrying the row updatedAt.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @param data.requestBody
+   * @returns EventResponseDto Life event created successfully
+   * @throws ApiError
+   */
+  public static eventControllerCreate(
+    data: EventControllerCreateData
+  ): CancelablePromise<EventControllerCreateResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/bean/events',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        409: 'Life event already exists for this (userId, type, date) combination'
+      }
+    });
+  }
+
+  /**
+   * List user life events
+   * Returns life events for the authenticated user with optional filtering by type, description search, and date range.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @param data.type Filter by life event type (exact match)
+   * @param data.q Search term for description (case-insensitive partial match)
+   * @param data.from Filter life events from this date (ISO 8601 format)
+   * @param data.to Filter life events to this date (ISO 8601 format)
+   * @param data.page Page number for pagination (default: 1)
+   * @param data.limit Number of items per page (default: 20, max: 100)
+   * @returns EventListResponseDto Life events retrieved successfully
+   * @throws ApiError
+   */
+  public static eventControllerFindAll(
+    data: EventControllerFindAllData
+  ): CancelablePromise<EventControllerFindAllResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/events',
+      path: {
+        region: data.region
+      },
+      query: {
+        type: data.type,
+        q: data.q,
+        from: data.from,
+        to: data.to,
+        page: data.page,
+        limit: data.limit
+      }
+    });
+  }
+
+  /**
+   * Get life event by ID
+   * Returns a single life event by its ID. Returns ETag header.
+   * @param data The data for the request.
+   * @param data.id Life event ID
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @returns EventResponseDto Life event retrieved successfully
+   * @throws ApiError
+   */
+  public static eventControllerFindOne(
+    data: EventControllerFindOneData
+  ): CancelablePromise<EventControllerFindOneResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/events/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: 'Life event not found'
+      }
+    });
+  }
+
+  /**
+   * Update a life event
+   * Updates an existing life event. If If-Match header is provided, performs optimistic concurrency check; mismatched updatedAt returns 412.
+   * @param data The data for the request.
+   * @param data.id Life event ID
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @param data.requestBody
+   * @returns EventResponseDto Life event updated successfully
+   * @throws ApiError
+   */
+  public static eventControllerUpdate(
+    data: EventControllerUpdateData
+  ): CancelablePromise<EventControllerUpdateResponse> {
+    return __request(OpenAPI, {
+      method: 'PUT',
+      url: '/api/v1/{region}/bean/events/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        400: 'If-Match header is not a valid ISO 8601 date',
+        404: 'Life event not found',
+        409: 'Updated event conflicts with an existing (userId, type, date) combination',
+        412: 'If-Match precondition failed (updatedAt mismatch)'
+      }
+    });
+  }
+
+  /**
+   * Delete a life event
+   * Deletes a life event entry (hard delete). Returns 204.
+   * @param data The data for the request.
+   * @param data.id Life event ID
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @returns void Life event deleted successfully
+   * @throws ApiError
+   */
+  public static eventControllerDelete(
+    data: EventControllerDeleteData
+  ): CancelablePromise<EventControllerDeleteResponse> {
+    return __request(OpenAPI, {
+      method: 'DELETE',
+      url: '/api/v1/{region}/bean/events/{id}',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: 'Life event not found'
+      }
+    });
+  }
+
+  /**
+   * Slice time-series by a life event (Phase 79)
+   * Returns aggregated time-series for postings matching accountPattern within the half-open date range of the given life event.
+   * @param data The data for the request.
+   * @param data.id Life event ID
+   * @param data.accountPattern
+   * @param data.granularity
+   * @param data.region Region code for tenant context (decorative for life events)
+   * @returns unknown Time-series sliced by the life event range
+   * @throws ApiError
+   */
+  public static eventControllerGetSlice(
+    data: EventControllerGetSliceData
+  ): CancelablePromise<EventControllerGetSliceResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/events/{id}/slice',
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      query: {
+        accountPattern: data.accountPattern,
+        granularity: data.granularity
+      },
+      errors: {
+        400: 'accountPattern query param is empty',
+        404: 'Life event not found'
+      }
+    });
+  }
+}
+
 export class BeanExportService {
   /**
    * Export Beancount ledger as ZIP
@@ -2695,7 +2972,7 @@ export class ProviderSyncService {
    *
    * @param data The data for the request.
    * @param data.providerName Provider name
-   * @param data.region Region code
+   * @param data.region Region code for tenant context
    * @param data.requestBody
    * @returns ProviderSyncResponseDto Sync completed successfully
    * @throws ApiError
@@ -2794,6 +3071,54 @@ 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 {
@@ -2914,6 +3239,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
    */
@@ -2928,7 +3254,8 @@ export class DashboardService {
       },
       query: {
         groupBy: data.groupBy,
-        date: data.date
+        date: data.date,
+        accountId: data.accountId
       },
       errors: {
         401: 'User not authenticated'
@@ -2963,6 +3290,237 @@ export class DashboardService {
       }
     });
   }
+
+  /**
+   * Get expenses grouped by functional category
+   * Returns expenses pre-aggregated by functional category (account-path Group segment) with server-side multi-currency conversion
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.groupBy Grouping strategy
+   * @param data.period Time window (1m = current calendar month)
+   * @returns ExpensesByCategoryResponseDto Expenses retrieved successfully
+   * @throws ApiError
+   */
+  public static dashboardControllerGetExpenses(
+    data: DashboardControllerGetExpensesData
+  ): CancelablePromise<DashboardControllerGetExpensesResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/dashboard/expenses',
+      path: {
+        region: data.region
+      },
+      query: {
+        groupBy: data.groupBy,
+        period: data.period
+      },
+      errors: {
+        400: 'Invalid groupBy or period',
+        401: 'User not authenticated'
+      }
+    });
+  }
+}
+
+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 {
@@ -3006,6 +3564,42 @@ export class ReportingService {
     });
   }
 
+  /**
+   * Get cash-flow trends
+   *
+   * Monthly income / expense / netSavings over a fixed N-month window
+   * (current month + N−1 prior). Missing months are zero-filled (flow metric).
+   *
+   * **Parameters:**
+   * - `period`: 1m | 3m | 6m | 1y (default 6m)
+   * - `granularity`: accepted for API symmetry; v1 returns month buckets
+   *
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.period Time period
+   * @param data.granularity Data granularity (accepted for API symmetry; v1 returns month buckets)
+   * @returns CashFlowTrendsResponseDto Cash-flow trends retrieved successfully
+   * @throws ApiError
+   */
+  public static reportingControllerGetCashFlowTrends(
+    data: ReportingControllerGetCashFlowTrendsData
+  ): CancelablePromise<ReportingControllerGetCashFlowTrendsResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/reporting/cash-flow/trends',
+      path: {
+        region: data.region
+      },
+      query: {
+        period: data.period,
+        granularity: data.granularity
+      },
+      errors: {
+        401: 'User not authenticated'
+      }
+    });
+  }
+
   /**
    * Generate portfolio snapshot
    *