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

package/dist/index.js

@@ -720,6 +720,35 @@ var BeanTransactionsService = class {
       }
     });
   }
+  /**
+   * 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
+   */
+  static transactionControllerSuggestTags(data) {
+    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

package/dist/index.mjs

@@ -688,6 +688,35 @@ var BeanTransactionsService = class {
       }
     });
   }
+  /**
+   * 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
+   */
+  static transactionControllerSuggestTags(data) {
+    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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firela/api-types",
-  "version": "0.0.0-canary.ba0a88d9",
+  "version": "0.0.0-canary.da5984a1",
   "description": "TypeScript types generated from IGN OpenAPI specification",
   "license": "MIT",
   "author": "FireLa Team",

package/src/generated/schemas.gen.ts

@@ -329,9 +329,14 @@ export const $AccountStandardResponseDto = {
       description: 'i18n key for localized display name',
       example: 'account.assets.cn.bank.icbc.checking'
     },
+    name: {
+      type: 'string',
+      description: 'Short localized display name',
+      example: 'Housing Fund'
+    },
     description: {
       type: 'string',
-      description: 'Account description',
+      description: 'Account description (stable semantics only)',
       example: 'ICBC checking account for daily transactions'
     },
     tags: {
@@ -348,7 +353,7 @@ export const $AccountStandardResponseDto = {
       example: 'bank-icbc'
     }
   },
-  required: ['path', 'type']
+  required: ['path', 'type', 'i18nKey', 'description', 'tags', 'icon']
 } as const;
 
 export const $AccountStandardListResponseDto = {
@@ -432,11 +437,10 @@ export const $RegionInfoDto = {
       example: 'Germany'
     },
     parent: {
-      type: 'string',
-      example: 'eu-core'
+      type: 'string'
     },
     chain: {
-      example: ['eu-core', 'de'],
+      example: ['de'],
       type: 'array',
       items: {
         type: 'string'
@@ -579,7 +583,8 @@ export const $PostingResponseDto = {
     },
     units: {
       type: 'string',
-      description: 'Amount (may be null if interpolated)',
+      description:
+        'Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.',
       example: '100.50'
     },
     currency: {
@@ -805,6 +810,11 @@ export const $BatchTransactionErrorDto = {
       type: 'string',
       description: 'Error message describing the failure',
       example: 'Transaction does not balance'
+    },
+    errorCode: {
+      type: 'string',
+      description: 'Structured error code for programmatic handling',
+      example: 'INSUFFICIENT_QUANTITY'
     }
   },
   required: ['index', 'error']
@@ -851,7 +861,8 @@ export const $PostingDetailDto = {
     },
     units: {
       type: 'string',
-      description: 'Amount (may be null if interpolated)',
+      description:
+        'Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.',
       example: '100.50'
     },
     currency: {
@@ -1043,6 +1054,37 @@ export const $TransactionListResponseDto = {
   required: ['data', 'total', 'limit', 'offset']
 } as const;
 
+export const $TagSuggestionDto = {
+  type: 'object',
+  properties: {
+    tag: {
+      type: 'string',
+      description: 'Tag name',
+      example: 'Monthly'
+    },
+    count: {
+      type: 'number',
+      description: 'Usage count across ACTIVE transactions',
+      example: 12
+    }
+  },
+  required: ['tag', 'count']
+} as const;
+
+export const $TagSuggestionsResponseDto = {
+  type: 'object',
+  properties: {
+    data: {
+      description: 'Tag suggestions sorted as requested',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/TagSuggestionDto'
+      }
+    }
+  },
+  required: ['data']
+} as const;
+
 export const $UpdateTransactionDto = {
   type: 'object',
   properties: {
@@ -1234,8 +1276,10 @@ export const $ReviewSummaryDto = {
     },
     confidenceLevel: {
       type: 'string',
-      description: 'Confidence level derived from score',
-      enum: ['HIGH', 'MEDIUM', 'LOW']
+      description:
+        'Confidence level derived from score. Null for error-type reviews (ACCOUNT_VALIDATION/PIPELINE_ERROR) which carry no confidence.',
+      enum: ['HIGH', 'MEDIUM', 'LOW'],
+      nullable: true
     },
     summaryKey: {
       type: 'string',
@@ -1417,8 +1461,10 @@ export const $ReviewDetailDto = {
     },
     confidenceLevel: {
       type: 'string',
-      description: 'Confidence level derived from score',
-      enum: ['HIGH', 'MEDIUM', 'LOW']
+      description:
+        'Confidence level derived from score. Null for error-type reviews (ACCOUNT_VALIDATION/PIPELINE_ERROR) which carry no confidence.',
+      enum: ['HIGH', 'MEDIUM', 'LOW'],
+      nullable: true
     },
     summaryKey: {
       type: 'string',
@@ -4688,6 +4734,16 @@ export const $ProcessNlpDto = {
       description:
         'Session ID for multi-turn conversation (auto-generated if not provided)',
       example: 'session_abc123'
+    },
+    parsedData: {
+      type: 'object',
+      description:
+        'Parsed data from previous NLP response for session recovery. Send back the parsedData received in confirm_payee/confirm responses.',
+      example: {
+        amount: 35,
+        currency: 'CNY',
+        payee: 'Starbucks'
+      }
     }
   },
   required: ['message']

package/src/generated/services.gen.ts

@@ -29,6 +29,8 @@ import type {
   TransactionControllerListResponse,
   TransactionControllerCreateBatchData,
   TransactionControllerCreateBatchResponse,
+  TransactionControllerSuggestTagsData,
+  TransactionControllerSuggestTagsResponse,
   TransactionControllerGetDetailData,
   TransactionControllerGetDetailResponse,
   TransactionControllerUpdateData,
@@ -603,6 +605,38 @@ export class BeanTransactionsService {
     });
   }
 
+  /**
+   * 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