@firela/api-types 0.0.0-canary.feeae929 → 0.0.0-canary.ffdf0021

package/src/generated/services.gen.ts

@@ -193,6 +193,8 @@ import type {
   TransactionRuleControllerDeleteResponse,
   TransactionRuleControllerTestData,
   TransactionRuleControllerTestResponse,
+  CategoryCatalogControllerListData,
+  CategoryCatalogControllerListResponse,
   EventControllerCreateData,
   EventControllerCreateResponse,
   EventControllerFindAllData,
@@ -257,6 +259,7 @@ import type {
   PlatformControllerFindAllResponse,
   PlatformControllerCreateData,
   PlatformControllerCreateResponse,
+  PlatformControllerGetPlatformListData,
   PlatformControllerGetPlatformListResponse,
   PlatformControllerMatchPlatformsData,
   PlatformControllerMatchPlatformsResponse,
@@ -277,6 +280,8 @@ import type {
   ApiKeysControllerCreateApiKeyResponse,
   AuthControllerAccessTokenLoginData,
   AuthControllerAccessTokenLoginResponse,
+  ParserContributionControllerCreateData,
+  ParserContributionControllerCreateResponse,
   CacheControllerFlushCacheResponse,
   ExchangeRateControllerGetExchangeRateData,
   ExchangeRateControllerGetExchangeRateResponse,
@@ -638,7 +643,8 @@ 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
+   * @param data.category 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).
+   * @param data.flow 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.
    * @returns TransactionListResponseDto Transaction list
    * @throws ApiError
    */
@@ -659,7 +665,8 @@ export class BeanTransactionsService {
         status: data.status,
         search: data.search,
         accountId: data.accountId,
-        category: data.category
+        category: data.category,
+        flow: data.flow
       },
       errors: {
         400: 'Validation failed',
@@ -2348,7 +2355,7 @@ export class UsersService {
    * Get current authenticated user
    * @param data The data for the request.
    * @param data.acceptLanguage
-   * @returns unknown User retrieved successfully
+   * @returns UserResponseDto User retrieved successfully
    * @throws ApiError
    */
   public static userControllerGetUser(
@@ -2855,6 +2862,34 @@ export class BeanTransactionRulesService {
   }
 }
 
+export class BeanCategoryCatalogService {
+  /**
+   * List category catalog for a region
+   * Returns the region-scoped category slugs (expense/income/investment/banking/transfer/payment) for the NLP result picker. CN-exclusive payment instruments (huabei/baitiao) appear only under /cn.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.scenario Filter by scenario
+   * @param data.routeBearing Filter by routeBearing (entity-router route() consumes it)
+   * @returns CategoryCatalogListResponseDto Category catalog retrieved successfully
+   * @throws ApiError
+   */
+  public static categoryCatalogControllerList(
+    data: CategoryCatalogControllerListData
+  ): CancelablePromise<CategoryCatalogControllerListResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/{region}/bean/categories',
+      path: {
+        region: data.region
+      },
+      query: {
+        scenario: data.scenario,
+        routeBearing: data.routeBearing
+      }
+    });
+  }
+}
+
 export class LifeEventsService {
   /**
    * Create a new life event
@@ -3730,13 +3765,20 @@ export class BeanPlatformsService {
 
   /**
    * Get platform list for current user
+   * @param data The data for the request.
+   * @param data.region Region code (ISO 3166-1 alpha-2) that biases within-type-bucket ordering (local-region platforms first). Case-insensitive — stored/compared UPPERCASE ("cn" == "CN").
    * @returns PlatformListItemDto List of platforms with user binding status
    * @throws ApiError
    */
-  public static platformControllerGetPlatformList(): CancelablePromise<PlatformControllerGetPlatformListResponse> {
+  public static platformControllerGetPlatformList(
+    data: PlatformControllerGetPlatformListData = {}
+  ): CancelablePromise<PlatformControllerGetPlatformListResponse> {
     return __request(OpenAPI, {
       method: 'GET',
-      url: '/api/v1/bean/platforms/list'
+      url: '/api/v1/bean/platforms/list',
+      query: {
+        region: data.region
+      }
     });
   }
 
@@ -3744,7 +3786,7 @@ export class BeanPlatformsService {
    * Match platforms by name or alias
    * @param data The data for the request.
    * @param data.q Search query — Chinese name, English name, or abbreviation
-   * @param data.region Region code for category override lookup
+   * @param data.region Region code (ISO 3166-1 alpha-2) that biases within-tier ordering (local-region platforms first); also the intended categoryOverrides key. Case-insensitive — stored/compared UPPERCASE ("cn" == "CN").
    * @returns PlatformMatchResponseDto Matching platforms with overall match type and truncation flag
    * @throws ApiError
    */
@@ -4004,6 +4046,38 @@ export class AuthService {
   }
 }
 
+export class CommunityService {
+  /**
+   * Relay a sanitized parser-contribution payload
+   * A server-side bot re-sanitizes the payload and opens an issue on the target repository; the issue URL is returned. The payload is never persisted or logged (forward-and-drop).
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context (routing only; the institution region rides in the payload meta)
+   * @param data.requestBody
+   * @returns ParserContributionRelayResponseDto Issue created by the bot
+   * @throws ApiError
+   */
+  public static parserContributionControllerCreate(
+    data: ParserContributionControllerCreateData
+  ): CancelablePromise<ParserContributionControllerCreateResponse> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/{region}/community/parser-contributions',
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: 'application/json',
+      errors: {
+        401: 'Unauthorized',
+        422: 'Validation failed (institution slug, empty samples, row/cell size limits)',
+        429: 'Rate limited (5 submissions per user per hour)',
+        501: 'Relay not configured on this deployment — clients fall back to the clipboard flow',
+        502: 'GitHub bot failure (upstream), safe to retry'
+      }
+    });
+  }
+}
+
 export class DefaultService {
   /**
    * @returns unknown