@firela/api-types 0.0.0-canary.ce7c9749 → 0.0.0-canary.d41ffbd5

package/dist/index.js

@@ -556,7 +556,7 @@ var BeanAccountsService = class {
   }
   /**
    * Delete account
-   * Deletes an account (only if no transactions)
+   * Deletes an account (only if no active transactions; voided/superseded residual postings are cleaned up)
    * @param data The data for the request.
    * @param data.id Account UUID
    * @param data.region Region code for tenant context
@@ -573,7 +573,7 @@ var BeanAccountsService = class {
       },
       errors: {
         404: "Account not found",
-        409: "Account has transactions and cannot be deleted"
+        409: "Account has active transactions and cannot be deleted"
       }
     });
   }

package/dist/index.mjs

@@ -524,7 +524,7 @@ var BeanAccountsService = class {
   }
   /**
    * Delete account
-   * Deletes an account (only if no transactions)
+   * Deletes an account (only if no active transactions; voided/superseded residual postings are cleaned up)
    * @param data The data for the request.
    * @param data.id Account UUID
    * @param data.region Region code for tenant context
@@ -541,7 +541,7 @@ var BeanAccountsService = class {
       },
       errors: {
         404: "Account not found",
-        409: "Account has transactions and cannot be deleted"
+        409: "Account has active transactions and cannot be deleted"
       }
     });
   }

package/package.json

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

package/src/generated/schemas.gen.ts

@@ -124,6 +124,8 @@ export const $AccountResponseDto = {
         'STUDENT_LOAN',
         'CREDIT_CARD',
         'PERSONAL_LOAN',
+        'ACCOUNTS_PAYABLE',
+        'TAX_PAYABLE',
         'OTHER'
       ],
       nullable: true,
@@ -395,9 +397,47 @@ export const $AccountStandardResponseDto = {
       type: 'string',
       description: 'Icon identifier for UI display',
       example: 'bank-icbc'
+    },
+    productCategory: {
+      type: 'string',
+      description:
+        'Onboarding product category (coarse grouping derived from assetSubClass)',
+      enum: [
+        'cash',
+        'investment',
+        'credit_card',
+        'loan',
+        'payable_tax',
+        'other'
+      ],
+      example: 'investment'
+    },
+    assetClass: {
+      type: 'string',
+      description:
+        'Asset class (LIQUIDITY/EQUITY/.../LIABILITY), derived at read time from classification rules',
+      enum: [
+        'LIQUIDITY',
+        'EQUITY',
+        'FIXED_INCOME',
+        'PRECIOUS_METALS',
+        'COMMODITY',
+        'INSURANCE',
+        'ALTERNATIVE_INVESTMENT',
+        'PERSONAL_ASSETS',
+        'LIABILITY',
+        'REAL_ESTATE',
+        'INDEX'
+      ]
+    },
+    assetSubClass: {
+      type: 'string',
+      description:
+        'Asset sub-class (product type, derived at read time from classification rules)',
+      example: 'STOCK'
     }
   },
-  required: ['path', 'type', 'description', 'tags', 'icon']
+  required: ['path', 'type', 'description', 'tags', 'icon', 'productCategory']
 } as const;
 
 export const $AccountStandardListResponseDto = {
@@ -5630,7 +5670,8 @@ export const $UpdateMapperDefaultsDto = {
       type: 'string',
       description: 'Source account for transactions (Beancount format)',
       example: 'Assets:CN:Alipay:Balance',
-      pattern: '^[A-Z][a-zA-Z0-9-]*:[a-zA-Z0-9-:]+$'
+      pattern:
+        '^(Assets|Liabilities|Income|Expenses|Equity)(:[A-Za-z0-9][A-Za-z0-9-]*)+$'
     },
     currency: {
       type: 'string',
@@ -5644,13 +5685,15 @@ export const $UpdateMapperDefaultsDto = {
       type: 'string',
       description: 'Default expense account (optional)',
       example: 'Expenses:Unknown',
-      pattern: '^[A-Z][a-zA-Z0-9-]*:[a-zA-Z0-9-:]+$'
+      pattern:
+        '^(Assets|Liabilities|Income|Expenses|Equity)(:[A-Za-z0-9][A-Za-z0-9-]*)+$'
     },
     incomeAccount: {
       type: 'string',
       description: 'Default income account (optional)',
       example: 'Income:Unknown',
-      pattern: '^[A-Z][a-zA-Z0-9-]*:[a-zA-Z0-9-:]+$'
+      pattern:
+        '^(Assets|Liabilities|Income|Expenses|Equity)(:[A-Za-z0-9][A-Za-z0-9-]*)+$'
     },
     methodAccountMapping: {
       type: 'object',
@@ -5707,12 +5750,14 @@ export const $ProviderSyncConfigDto = {
     },
     defaultExpenseAccount: {
       type: 'string',
-      description: 'Default expense account for the second posting',
+      description:
+        'Default expense account for the second posting. Omit when no real default exists; the pipeline routes to Review via the Uncategorized sentinel (#618).',
       example: 'Expenses:Unknown'
     },
     defaultIncomeAccount: {
       type: 'string',
-      description: 'Default income account for the second posting',
+      description:
+        'Default income account for the second posting. Omit when no real default exists; the pipeline routes to Review via the Uncategorized sentinel (#618).',
       example: 'Income:Unknown'
     },
     filterPending: {
@@ -5727,12 +5772,7 @@ export const $ProviderSyncConfigDto = {
       example: 'acc_gocardless_001'
     }
   },
-  required: [
-    'sourceAccount',
-    'defaultCurrency',
-    'defaultExpenseAccount',
-    'defaultIncomeAccount'
-  ]
+  required: ['sourceAccount', 'defaultCurrency']
 } as const;
 
 export const $ProviderSyncDto = {
@@ -5947,10 +5987,17 @@ export const $ProcessNlpDto = {
   properties: {
     message: {
       type: 'string',
-      description: 'Natural language text describing a transaction (Chinese)',
-      example: 'yesterday Starbucks spent 35 yuan',
+      description:
+        'Natural language text describing a transaction. Optional when `confirm` is true (structured confirm); otherwise required.',
+      example: 'Starbucks 35',
       maxLength: 500
     },
+    confirm: {
+      type: 'boolean',
+      description:
+        'Structured confirm signal — bypasses NL confirm-word matching when true. Send parsedData field edits alongside. The NL word-list path is the fallback.',
+      example: true
+    },
     sessionId: {
       type: 'string',
       description:
@@ -5966,9 +6013,20 @@ export const $ProcessNlpDto = {
         currency: 'CNY',
         payee: 'Starbucks'
       }
+    },
+    selectedRuleId: {
+      type: 'string',
+      description:
+        'confirm_rule echo-back: rule id selected from the prior confirm_rule response (matchedRule.id or alternatives[i].ruleId). Applied directly when the session is confirming_rule — no NL re-parse.',
+      example: 'rule_abc123'
+    },
+    selectedAccount: {
+      type: 'string',
+      description:
+        'confirm_account echo-back: account path selected from the prior confirm_account response (suggestedAccount, similarAccounts[i], or a typed path). Applied directly when the session is confirming_account — no NL re-parse.',
+      example: 'Expenses:Food:Coffee'
     }
-  },
-  required: ['message']
+  }
 } as const;
 
 export const $NlpTransactionInfoDto = {
@@ -6290,7 +6348,8 @@ export const $NlpAccountConfirmationDataDto = {
     },
     suggestedAccount: {
       type: 'string',
-      description: 'Suggested replacement account',
+      description:
+        'Suggested replacement account (omitted when no clear candidate)',
       example: 'Expenses:Food:Drinks'
     },
     similarAccounts: {
@@ -6312,7 +6371,6 @@ export const $NlpAccountConfirmationDataDto = {
   },
   required: [
     'invalidAccount',
-    'suggestedAccount',
     'similarAccounts',
     'errorMessage',
     'transactionContext'
@@ -6485,7 +6543,8 @@ export const $NlpSuggestedAccountDto = {
     },
     confidence: {
       type: 'number',
-      description: 'Confidence score for this suggestion (0-1)',
+      description:
+        'Confidence score for this suggestion (0-1). Present = predicted (confirm/confirm_rule/confirm_account); omitted = actual persisted account (created). (#586)',
       example: 0.9
     }
   },
@@ -6521,23 +6580,31 @@ export const $NlpDefaultAccountsDto = {
   properties: {
     asset: {
       type: 'string',
-      description: 'Default asset account',
-      example: 'Assets:Checking'
+      description:
+        'Default OPEN asset account (MRU when multiple), or null when none/ambiguous',
+      example: 'Assets:Checking',
+      nullable: true
     },
     expense: {
       type: 'string',
-      description: 'Default expense account',
-      example: 'Expenses:Uncategorized'
+      description:
+        'Default OPEN expense account (MRU when multiple), or null when none/ambiguous',
+      example: 'Expenses:Food:Coffee',
+      nullable: true
     },
     income: {
       type: 'string',
-      description: 'Default income account',
-      example: 'Income:Uncategorized'
+      description:
+        'Default OPEN income account (MRU when multiple), or null when none/ambiguous',
+      example: 'Income:Salary',
+      nullable: true
     },
     liability: {
       type: 'string',
-      description: 'Default liability account',
-      example: 'Liabilities:CreditCard'
+      description:
+        'Default OPEN liability account (MRU when multiple), or null when none/ambiguous',
+      example: 'Liabilities:CreditCard',
+      nullable: true
     }
   },
   required: ['asset', 'expense', 'income', 'liability']
@@ -6725,7 +6792,7 @@ export const $NlpResponseDto = {
     },
     suggestedAccounts: {
       description:
-        'Suggested accounts for this transaction. Contains recommended source and destination accounts based on the detected intent and rules.',
+        'Suggested accounts for this transaction (#586). confirm/confirm_rule/confirm_account: predicted (source/destination carry confidence); created: actual persisted accounts (confidence omitted). confirm_account destination is the suggested replacement, never the invalid account.',
       allOf: [
         {
           $ref: '#/components/schemas/NlpSuggestedAccountsDto'
@@ -6734,7 +6801,7 @@ export const $NlpResponseDto = {
     },
     defaultAccounts: {
       description:
-        'Default accounts for the user/region. These are fallback accounts used when no specific suggestion is available.',
+        'Default fallback accounts for the user/region (#586). v1 returns universal constants; per-user personalization is planned.',
       allOf: [
         {
           $ref: '#/components/schemas/NlpDefaultAccountsDto'
@@ -6780,13 +6847,26 @@ export const $PlatformListItemDto = {
     suggestedSegment: {
       type: 'string',
       description:
-        'Suggested path segment — canonical with first char uppercased (ACC_COMP_NAME_RE)'
+        'Suggested path segment — canonical PascalCased per hyphen-part, hyphens preserved (e.g. "Apple-Pay")'
     },
     logoUrl: {
       type: 'string',
       description: 'Logo URL',
       nullable: true
     },
+    countryCode: {
+      type: 'string',
+      description: 'ISO 3166-1 alpha-2 (UPPERCASE); null = global platform',
+      example: 'CN',
+      nullable: true
+    },
+    category: {
+      type: 'string',
+      description:
+        'Region-aware category (institution vocab, e.g. DigitalWallet/Bank). null = no region-aware suggestion; fall back to type.',
+      nullable: true,
+      example: 'DigitalWallet'
+    },
     isBound: {
       type: 'boolean',
       description: 'Whether user has accounts using this platform'
@@ -6800,6 +6880,8 @@ export const $PlatformListItemDto = {
     'canonical',
     'suggestedSegment',
     'logoUrl',
+    'countryCode',
+    'category',
     'isBound'
   ]
 } as const;
@@ -6835,13 +6917,26 @@ export const $PlatformMatchResultDto = {
     suggestedSegment: {
       type: 'string',
       description:
-        'Suggested path segment — canonical, already in ACCOUNT_RE format'
+        'Suggested path segment — canonical PascalCased per hyphen-part, hyphens preserved (e.g. "Apple-Pay")'
     },
     logoUrl: {
       type: 'string',
       description: 'Logo URL',
       nullable: true
     },
+    countryCode: {
+      type: 'string',
+      description: 'ISO 3166-1 alpha-2 (UPPERCASE); null = global platform',
+      example: 'CN',
+      nullable: true
+    },
+    category: {
+      type: 'string',
+      description:
+        'Region-aware category (institution vocab, e.g. DigitalWallet/Bank). null = no region-aware suggestion; fall back to type.',
+      nullable: true,
+      example: 'DigitalWallet'
+    },
     matchType: {
       type: 'string',
       description: "How this row matched: 'exact' > 'prefix' > 'substring'",
@@ -6855,6 +6950,8 @@ export const $PlatformMatchResultDto = {
     'type',
     'suggestedSegment',
     'logoUrl',
+    'countryCode',
+    'category',
     'matchType'
   ]
 } as const;
@@ -8103,3 +8200,146 @@ export const $AnonymousLoginResponseDto = {
   },
   required: ['authToken']
 } as const;
+
+export const $SymbolSearchResultDto = {
+  type: 'object',
+  properties: {
+    symbol: {
+      type: 'string',
+      example: 'AAPL'
+    },
+    name: {
+      type: 'object',
+      example: 'Apple Inc.',
+      nullable: true
+    },
+    exchange: {
+      type: 'object',
+      example: 'US',
+      nullable: true
+    },
+    assetType: {
+      type: 'object',
+      description: 'OpenBB asset_type (e.g. stock, etf)',
+      example: 'stock',
+      nullable: true
+    },
+    assetClass: {
+      type: 'object',
+      description: 'IGN asset class (region.types.ts ASSET_CLASSES)',
+      example: 'EQUITY',
+      nullable: true
+    },
+    assetSubClass: {
+      type: 'object',
+      description: 'IGN asset sub-class (region.types.ts ASSET_SUB_CLASSES)',
+      example: 'STOCK',
+      nullable: true
+    },
+    currency: {
+      type: 'object',
+      description: 'Trading currency (extra_data or inferred from exchange)',
+      example: 'USD',
+      nullable: true
+    }
+  },
+  required: ['symbol']
+} as const;
+
+export const $SymbolQuoteDto = {
+  type: 'object',
+  properties: {
+    symbol: {
+      type: 'string',
+      example: 'AAPL'
+    },
+    name: {
+      type: 'object',
+      example: 'Apple Inc.',
+      nullable: true
+    },
+    exchange: {
+      type: 'object',
+      example: 'US',
+      nullable: true
+    },
+    assetType: {
+      type: 'object',
+      description: 'OpenBB asset_type',
+      example: 'stock',
+      nullable: true
+    },
+    assetClass: {
+      type: 'object',
+      description: 'IGN asset class',
+      example: 'EQUITY',
+      nullable: true
+    },
+    assetSubClass: {
+      type: 'object',
+      description: 'IGN asset sub-class',
+      example: 'STOCK',
+      nullable: true
+    },
+    currency: {
+      type: 'object',
+      description: 'Trading currency (extra_data or inferred from exchange)',
+      example: 'USD',
+      nullable: true
+    },
+    price: {
+      type: 'object',
+      description: 'Latest price (Decimal string)',
+      example: '189.84',
+      nullable: true
+    },
+    priceDate: {
+      type: 'object',
+      description: 'Date the price was observed (ISO yyyy-MM-dd)',
+      example: '2026-08-05',
+      nullable: true
+    },
+    changePercent: {
+      type: 'object',
+      description:
+        'Change vs previous close, in percentage points (1.7 == 1.7%). openbb stores change_percent as a normalized decimal; this exposes percentage points for frontend convenience.',
+      example: 1.7,
+      nullable: true
+    },
+    prevClose: {
+      type: 'object',
+      description: 'Previous close (Decimal string)',
+      nullable: true
+    },
+    open: {
+      type: 'object',
+      description: 'Day open (Decimal string)',
+      nullable: true
+    },
+    high: {
+      type: 'object',
+      description: 'Day high (Decimal string)',
+      nullable: true
+    },
+    low: {
+      type: 'object',
+      description: 'Day low (Decimal string)',
+      nullable: true
+    },
+    volume: {
+      type: 'object',
+      description: 'Day volume (Decimal string)',
+      nullable: true
+    },
+    yearHigh: {
+      type: 'object',
+      description: '52-week high (Decimal string)',
+      nullable: true
+    },
+    yearLow: {
+      type: 'object',
+      description: '52-week low (Decimal string)',
+      nullable: true
+    }
+  }
+} as const;

package/src/generated/services.gen.ts

@@ -257,6 +257,7 @@ import type {
   PlatformControllerFindAllResponse,
   PlatformControllerCreateData,
   PlatformControllerCreateResponse,
+  PlatformControllerGetPlatformListData,
   PlatformControllerGetPlatformListResponse,
   PlatformControllerMatchPlatformsData,
   PlatformControllerMatchPlatformsResponse,
@@ -288,7 +289,11 @@ import type {
   HealthControllerResetCircuitBreakerData,
   HealthControllerResetCircuitBreakerResponse,
   HealthControllerGetMetricsResponse,
-  InfoControllerGetInfoResponse
+  InfoControllerGetInfoResponse,
+  SymbolControllerSearchData,
+  SymbolControllerSearchResponse,
+  SymbolControllerGetQuoteData,
+  SymbolControllerGetQuoteResponse
 } from './types.gen';
 
 export class BeanAccountsService {
@@ -407,7 +412,7 @@ export class BeanAccountsService {
 
   /**
    * Delete account
-   * Deletes an account (only if no transactions)
+   * Deletes an account (only if no active transactions; voided/superseded residual postings are cleaned up)
    * @param data The data for the request.
    * @param data.id Account UUID
    * @param data.region Region code for tenant context
@@ -426,7 +431,7 @@ export class BeanAccountsService {
       },
       errors: {
         404: 'Account not found',
-        409: 'Account has transactions and cannot be deleted'
+        409: 'Account has active transactions and cannot be deleted'
       }
     });
   }
@@ -3726,13 +3731,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
+      }
     });
   }
 
@@ -3740,7 +3752,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
    */
@@ -4169,3 +4181,53 @@ export class InfoService {
     });
   }
 }
+
+export class MarketDataService {
+  /**
+   * Search market symbols by name or code
+   * Ranked search over the openbb catalog. Empty `q` returns [].
+   * @param data The data for the request.
+   * @param data.q Search term — matched against symbol and instrument name. Empty string returns [].
+   * @param data.limit Maximum number of results (clamped 1..50)
+   * @param data.exchange Filter by exchange code (e.g. US, HK, SS, SZ)
+   * @param data.assetType Filter by OpenBB asset_type (e.g. stock, etf)
+   * @returns SymbolSearchResultDto Ranked search results
+   * @throws ApiError
+   */
+  public static symbolControllerSearch(
+    data: SymbolControllerSearchData
+  ): CancelablePromise<SymbolControllerSearchResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/market/symbols/search',
+      query: {
+        q: data.q,
+        limit: data.limit,
+        exchange: data.exchange,
+        assetType: data.assetType
+      }
+    });
+  }
+
+  /**
+   * Get a market symbol quote
+   * @param data The data for the request.
+   * @param data.symbol
+   * @returns SymbolQuoteDto Symbol quote
+   * @throws ApiError
+   */
+  public static symbolControllerGetQuote(
+    data: SymbolControllerGetQuoteData
+  ): CancelablePromise<SymbolControllerGetQuoteResponse> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/market/symbols/{symbol}/quote',
+      path: {
+        symbol: data.symbol
+      },
+      errors: {
+        404: 'Symbol not found in the openbb catalog'
+      }
+    });
+  }
+}