@firela/api-types 0.0.0-canary.aba78d68 → 0.0.0-canary.ad70e5a

package/dist/index.js

@@ -484,7 +484,7 @@ var BeanAccountsService = class {
    * @param data.type Filter by account type
    * @param data.status Filter by status
    * @param data.isCustom Filter by custom (user-created) accounts only
-   * @param data.search Search term for path or i18nKey
+   * @param data.search Search term matched against account path and user-set display name (case-insensitive)
    * @param data.limit Maximum number of results
    * @param data.offset Number of results to skip
    * @returns AccountListResponseDto Accounts retrieved successfully
@@ -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"
       }
     });
   }
@@ -629,6 +629,32 @@ var BeanAccountsService = class {
       }
     });
   }
+  /**
+   * Post an opening-balance transaction
+   * Posts a double-entry opening-balance transaction against Equity:Opening-Balances for an existing Assets/Liabilities account. At most one active opening balance per account.
+   * @param data The data for the request.
+   * @param data.id Account UUID
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns OpeningBalanceResultDto Opening-balance transaction created
+   * @throws ApiError
+   */
+  static accountControllerAddOpeningBalance(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/accounts/{id}/opening-balance",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        404: "Account not found",
+        409: "An opening balance already exists for this account"
+      }
+    });
+  }
 };
 var BeanTransactionsService = class {
   /**
@@ -667,9 +693,11 @@ var BeanTransactionsService = class {
    * @param data.offset Number of items to skip (default: 0)
    * @param data.dateFrom Filter by start date (inclusive), format: YYYY-MM-DD
    * @param data.dateTo Filter by end date (inclusive), format: YYYY-MM-DD
-   * @param data.status Filter by transaction status
+   * @param data.status Filter by transaction status: single value, comma-separated multi-value (e.g. VOIDED,SUPERSEDED), or ALL to include audit rows. Defaults to ACTIVE-only (ADR-0128; previously unfiltered — breaking change).
    * @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 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
    */
@@ -687,7 +715,9 @@ var BeanTransactionsService = class {
         dateTo: data.dateTo,
         status: data.status,
         search: data.search,
-        accountId: data.accountId
+        accountId: data.accountId,
+        category: data.category,
+        flow: data.flow
       },
       errors: {
         400: "Validation failed",
@@ -720,6 +750,31 @@ var BeanTransactionsService = class {
       }
     });
   }
+  /**
+   * Batch void transactions
+   * Soft-deletes (VOIDED) a batch of the caller's ACTIVE transactions in one DB transaction. Voiding releases each row's importId dedup slot, so re-importing the same file after an undo batch-void imports every row again instead of skipping them as duplicates.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody Batch void request (1-500 unique transaction IDs)
+   * @returns BatchVoidResultDto Batch void result: count of rows voided plus ids not found / no longer ACTIVE
+   * @throws ApiError
+   */
+  static transactionControllerBatchVoid(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/transactions/batch-void",
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Validation failed (empty, over 500, duplicate or non-string ids)",
+        401: "Authentication required",
+        403: "Batch contains ids owned by another user \u2014 whole request rejected, nothing committed"
+      }
+    });
+  }
   /**
    * Correct (supersede) a transaction
    * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
@@ -856,7 +911,7 @@ var BeanBalancesService = class {
    * Query account balance
    * Calculate account balance at a specific date for a single currency
    * @param data The data for the request.
-   * @param data.account Account name (e.g., "Assets:Bank:Checking")
+   * @param data.account Account name (e.g., "Assets:Checking")
    * @param data.region Region code for tenant context
    * @param data.date Date to calculate balance at (ISO 8601 format)
    * @param data.currency Currency to query (e.g., "USD", "CNY")

package/dist/index.mjs

@@ -452,7 +452,7 @@ var BeanAccountsService = class {
    * @param data.type Filter by account type
    * @param data.status Filter by status
    * @param data.isCustom Filter by custom (user-created) accounts only
-   * @param data.search Search term for path or i18nKey
+   * @param data.search Search term matched against account path and user-set display name (case-insensitive)
    * @param data.limit Maximum number of results
    * @param data.offset Number of results to skip
    * @returns AccountListResponseDto Accounts retrieved successfully
@@ -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"
       }
     });
   }
@@ -597,6 +597,32 @@ var BeanAccountsService = class {
       }
     });
   }
+  /**
+   * Post an opening-balance transaction
+   * Posts a double-entry opening-balance transaction against Equity:Opening-Balances for an existing Assets/Liabilities account. At most one active opening balance per account.
+   * @param data The data for the request.
+   * @param data.id Account UUID
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns OpeningBalanceResultDto Opening-balance transaction created
+   * @throws ApiError
+   */
+  static accountControllerAddOpeningBalance(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/accounts/{id}/opening-balance",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        404: "Account not found",
+        409: "An opening balance already exists for this account"
+      }
+    });
+  }
 };
 var BeanTransactionsService = class {
   /**
@@ -635,9 +661,11 @@ var BeanTransactionsService = class {
    * @param data.offset Number of items to skip (default: 0)
    * @param data.dateFrom Filter by start date (inclusive), format: YYYY-MM-DD
    * @param data.dateTo Filter by end date (inclusive), format: YYYY-MM-DD
-   * @param data.status Filter by transaction status
+   * @param data.status Filter by transaction status: single value, comma-separated multi-value (e.g. VOIDED,SUPERSEDED), or ALL to include audit rows. Defaults to ACTIVE-only (ADR-0128; previously unfiltered — breaking change).
    * @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 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
    */
@@ -655,7 +683,9 @@ var BeanTransactionsService = class {
         dateTo: data.dateTo,
         status: data.status,
         search: data.search,
-        accountId: data.accountId
+        accountId: data.accountId,
+        category: data.category,
+        flow: data.flow
       },
       errors: {
         400: "Validation failed",
@@ -688,6 +718,31 @@ var BeanTransactionsService = class {
       }
     });
   }
+  /**
+   * Batch void transactions
+   * Soft-deletes (VOIDED) a batch of the caller's ACTIVE transactions in one DB transaction. Voiding releases each row's importId dedup slot, so re-importing the same file after an undo batch-void imports every row again instead of skipping them as duplicates.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody Batch void request (1-500 unique transaction IDs)
+   * @returns BatchVoidResultDto Batch void result: count of rows voided plus ids not found / no longer ACTIVE
+   * @throws ApiError
+   */
+  static transactionControllerBatchVoid(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/transactions/batch-void",
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Validation failed (empty, over 500, duplicate or non-string ids)",
+        401: "Authentication required",
+        403: "Batch contains ids owned by another user \u2014 whole request rejected, nothing committed"
+      }
+    });
+  }
   /**
    * Correct (supersede) a transaction
    * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
@@ -824,7 +879,7 @@ var BeanBalancesService = class {
    * Query account balance
    * Calculate account balance at a specific date for a single currency
    * @param data The data for the request.
-   * @param data.account Account name (e.g., "Assets:Bank:Checking")
+   * @param data.account Account name (e.g., "Assets:Checking")
    * @param data.region Region code for tenant context
    * @param data.date Date to calculate balance at (ISO 8601 format)
    * @param data.currency Currency to query (e.g., "USD", "CNY")

package/package.json

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