@firela/api-types 0.0.0-canary.a7bda42 → 0.0.0-canary.a90bdd3

package/dist/index.js

@@ -1,3 +1,1298 @@
-// Entry point for @firela/api-types
-// Generated types will be exported from ./generated
-export * from './generated';
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BeanAccountsService: () => BeanAccountsService,
+  BeanBalancesService: () => BeanBalancesService,
+  BeanCommoditiesService: () => BeanCommoditiesService,
+  BeanTransactionsService: () => BeanTransactionsService,
+  HealthService: () => HealthService,
+  OpenAPI: () => OpenAPI,
+  ProviderSyncService: () => ProviderSyncService
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/generated/core/OpenAPI.ts
+var Interceptors = class {
+  constructor() {
+    this._fns = [];
+  }
+  eject(fn) {
+    const index = this._fns.indexOf(fn);
+    if (index !== -1) {
+      this._fns = [...this._fns.slice(0, index), ...this._fns.slice(index + 1)];
+    }
+  }
+  use(fn) {
+    this._fns = [...this._fns, fn];
+  }
+};
+var OpenAPI = {
+  BASE: "",
+  CREDENTIALS: "include",
+  ENCODE_PATH: void 0,
+  HEADERS: void 0,
+  PASSWORD: void 0,
+  TOKEN: void 0,
+  USERNAME: void 0,
+  VERSION: "dev",
+  WITH_CREDENTIALS: false,
+  interceptors: {
+    request: new Interceptors(),
+    response: new Interceptors()
+  }
+};
+
+// src/generated/core/ApiError.ts
+var ApiError = class extends Error {
+  constructor(request2, response, message) {
+    super(message);
+    this.name = "ApiError";
+    this.url = response.url;
+    this.status = response.status;
+    this.statusText = response.statusText;
+    this.body = response.body;
+    this.request = request2;
+  }
+};
+
+// src/generated/core/CancelablePromise.ts
+var CancelError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CancelError";
+  }
+  get isCancelled() {
+    return true;
+  }
+};
+var CancelablePromise = class {
+  constructor(executor) {
+    this._isResolved = false;
+    this._isRejected = false;
+    this._isCancelled = false;
+    this.cancelHandlers = [];
+    this.promise = new Promise((resolve2, reject) => {
+      this._resolve = resolve2;
+      this._reject = reject;
+      const onResolve = (value) => {
+        if (this._isResolved || this._isRejected || this._isCancelled) {
+          return;
+        }
+        this._isResolved = true;
+        if (this._resolve) this._resolve(value);
+      };
+      const onReject = (reason) => {
+        if (this._isResolved || this._isRejected || this._isCancelled) {
+          return;
+        }
+        this._isRejected = true;
+        if (this._reject) this._reject(reason);
+      };
+      const onCancel = (cancelHandler) => {
+        if (this._isResolved || this._isRejected || this._isCancelled) {
+          return;
+        }
+        this.cancelHandlers.push(cancelHandler);
+      };
+      Object.defineProperty(onCancel, "isResolved", {
+        get: () => this._isResolved
+      });
+      Object.defineProperty(onCancel, "isRejected", {
+        get: () => this._isRejected
+      });
+      Object.defineProperty(onCancel, "isCancelled", {
+        get: () => this._isCancelled
+      });
+      return executor(onResolve, onReject, onCancel);
+    });
+  }
+  get [Symbol.toStringTag]() {
+    return "Cancellable Promise";
+  }
+  then(onFulfilled, onRejected) {
+    return this.promise.then(onFulfilled, onRejected);
+  }
+  catch(onRejected) {
+    return this.promise.catch(onRejected);
+  }
+  finally(onFinally) {
+    return this.promise.finally(onFinally);
+  }
+  cancel() {
+    if (this._isResolved || this._isRejected || this._isCancelled) {
+      return;
+    }
+    this._isCancelled = true;
+    if (this.cancelHandlers.length) {
+      try {
+        for (const cancelHandler of this.cancelHandlers) {
+          cancelHandler();
+        }
+      } catch (error) {
+        console.warn("Cancellation threw an error", error);
+        return;
+      }
+    }
+    this.cancelHandlers.length = 0;
+    if (this._reject) this._reject(new CancelError("Request aborted"));
+  }
+  get isCancelled() {
+    return this._isCancelled;
+  }
+};
+
+// src/generated/core/request.ts
+var isString = (value) => {
+  return typeof value === "string";
+};
+var isStringWithValue = (value) => {
+  return isString(value) && value !== "";
+};
+var isBlob = (value) => {
+  return value instanceof Blob;
+};
+var isFormData = (value) => {
+  return value instanceof FormData;
+};
+var base64 = (str) => {
+  try {
+    return btoa(str);
+  } catch (err) {
+    return Buffer.from(str).toString("base64");
+  }
+};
+var getQueryString = (params) => {
+  const qs = [];
+  const append = (key, value) => {
+    qs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+  };
+  const encodePair = (key, value) => {
+    if (value === void 0 || value === null) {
+      return;
+    }
+    if (value instanceof Date) {
+      append(key, value.toISOString());
+    } else if (Array.isArray(value)) {
+      value.forEach((v) => encodePair(key, v));
+    } else if (typeof value === "object") {
+      Object.entries(value).forEach(([k, v]) => encodePair(`${key}[${k}]`, v));
+    } else {
+      append(key, value);
+    }
+  };
+  Object.entries(params).forEach(([key, value]) => encodePair(key, value));
+  return qs.length ? `?${qs.join("&")}` : "";
+};
+var getUrl = (config, options) => {
+  const encoder = config.ENCODE_PATH || encodeURI;
+  const path = options.url.replace("{api-version}", config.VERSION).replace(/{(.*?)}/g, (substring, group) => {
+    if (options.path?.hasOwnProperty(group)) {
+      return encoder(String(options.path[group]));
+    }
+    return substring;
+  });
+  const url = config.BASE + path;
+  return options.query ? url + getQueryString(options.query) : url;
+};
+var getFormData = (options) => {
+  if (options.formData) {
+    const formData = new FormData();
+    const process = (key, value) => {
+      if (isString(value) || isBlob(value)) {
+        formData.append(key, value);
+      } else {
+        formData.append(key, JSON.stringify(value));
+      }
+    };
+    Object.entries(options.formData).filter(([, value]) => value !== void 0 && value !== null).forEach(([key, value]) => {
+      if (Array.isArray(value)) {
+        value.forEach((v) => process(key, v));
+      } else {
+        process(key, value);
+      }
+    });
+    return formData;
+  }
+  return void 0;
+};
+var resolve = async (options, resolver) => {
+  if (typeof resolver === "function") {
+    return resolver(options);
+  }
+  return resolver;
+};
+var getHeaders = async (config, options) => {
+  const [token, username, password, additionalHeaders] = await Promise.all([
+    resolve(options, config.TOKEN),
+    resolve(options, config.USERNAME),
+    resolve(options, config.PASSWORD),
+    resolve(options, config.HEADERS)
+  ]);
+  const headers = Object.entries({
+    Accept: "application/json",
+    ...additionalHeaders,
+    ...options.headers
+  }).filter(([, value]) => value !== void 0 && value !== null).reduce(
+    (headers2, [key, value]) => ({
+      ...headers2,
+      [key]: String(value)
+    }),
+    {}
+  );
+  if (isStringWithValue(token)) {
+    headers["Authorization"] = `Bearer ${token}`;
+  }
+  if (isStringWithValue(username) && isStringWithValue(password)) {
+    const credentials = base64(`${username}:${password}`);
+    headers["Authorization"] = `Basic ${credentials}`;
+  }
+  if (options.body !== void 0) {
+    if (options.mediaType) {
+      headers["Content-Type"] = options.mediaType;
+    } else if (isBlob(options.body)) {
+      headers["Content-Type"] = options.body.type || "application/octet-stream";
+    } else if (isString(options.body)) {
+      headers["Content-Type"] = "text/plain";
+    } else if (!isFormData(options.body)) {
+      headers["Content-Type"] = "application/json";
+    }
+  }
+  return new Headers(headers);
+};
+var getRequestBody = (options) => {
+  if (options.body !== void 0) {
+    if (options.mediaType?.includes("application/json") || options.mediaType?.includes("+json")) {
+      return JSON.stringify(options.body);
+    } else if (isString(options.body) || isBlob(options.body) || isFormData(options.body)) {
+      return options.body;
+    } else {
+      return JSON.stringify(options.body);
+    }
+  }
+  return void 0;
+};
+var sendRequest = async (config, options, url, body, formData, headers, onCancel) => {
+  const controller = new AbortController();
+  let request2 = {
+    headers,
+    body: body ?? formData,
+    method: options.method,
+    signal: controller.signal
+  };
+  if (config.WITH_CREDENTIALS) {
+    request2.credentials = config.CREDENTIALS;
+  }
+  for (const fn of config.interceptors.request._fns) {
+    request2 = await fn(request2);
+  }
+  onCancel(() => controller.abort());
+  return await fetch(url, request2);
+};
+var getResponseHeader = (response, responseHeader) => {
+  if (responseHeader) {
+    const content = response.headers.get(responseHeader);
+    if (isString(content)) {
+      return content;
+    }
+  }
+  return void 0;
+};
+var getResponseBody = async (response) => {
+  if (response.status !== 204) {
+    try {
+      const contentType = response.headers.get("Content-Type");
+      if (contentType) {
+        const binaryTypes = [
+          "application/octet-stream",
+          "application/pdf",
+          "application/zip",
+          "audio/",
+          "image/",
+          "video/"
+        ];
+        if (contentType.includes("application/json") || contentType.includes("+json")) {
+          return await response.json();
+        } else if (binaryTypes.some((type) => contentType.includes(type))) {
+          return await response.blob();
+        } else if (contentType.includes("multipart/form-data")) {
+          return await response.formData();
+        } else if (contentType.includes("text/")) {
+          return await response.text();
+        }
+      }
+    } catch (error) {
+      console.error(error);
+    }
+  }
+  return void 0;
+};
+var catchErrorCodes = (options, result) => {
+  const errors = {
+    400: "Bad Request",
+    401: "Unauthorized",
+    402: "Payment Required",
+    403: "Forbidden",
+    404: "Not Found",
+    405: "Method Not Allowed",
+    406: "Not Acceptable",
+    407: "Proxy Authentication Required",
+    408: "Request Timeout",
+    409: "Conflict",
+    410: "Gone",
+    411: "Length Required",
+    412: "Precondition Failed",
+    413: "Payload Too Large",
+    414: "URI Too Long",
+    415: "Unsupported Media Type",
+    416: "Range Not Satisfiable",
+    417: "Expectation Failed",
+    418: "Im a teapot",
+    421: "Misdirected Request",
+    422: "Unprocessable Content",
+    423: "Locked",
+    424: "Failed Dependency",
+    425: "Too Early",
+    426: "Upgrade Required",
+    428: "Precondition Required",
+    429: "Too Many Requests",
+    431: "Request Header Fields Too Large",
+    451: "Unavailable For Legal Reasons",
+    500: "Internal Server Error",
+    501: "Not Implemented",
+    502: "Bad Gateway",
+    503: "Service Unavailable",
+    504: "Gateway Timeout",
+    505: "HTTP Version Not Supported",
+    506: "Variant Also Negotiates",
+    507: "Insufficient Storage",
+    508: "Loop Detected",
+    510: "Not Extended",
+    511: "Network Authentication Required",
+    ...options.errors
+  };
+  const error = errors[result.status];
+  if (error) {
+    throw new ApiError(options, result, error);
+  }
+  if (!result.ok) {
+    const errorStatus = result.status ?? "unknown";
+    const errorStatusText = result.statusText ?? "unknown";
+    const errorBody = (() => {
+      try {
+        return JSON.stringify(result.body, null, 2);
+      } catch (e) {
+        return void 0;
+      }
+    })();
+    throw new ApiError(
+      options,
+      result,
+      `Generic Error: status: ${errorStatus}; status text: ${errorStatusText}; body: ${errorBody}`
+    );
+  }
+};
+var request = (config, options) => {
+  return new CancelablePromise(async (resolve2, reject, onCancel) => {
+    try {
+      const url = getUrl(config, options);
+      const formData = getFormData(options);
+      const body = getRequestBody(options);
+      const headers = await getHeaders(config, options);
+      if (!onCancel.isCancelled) {
+        let response = await sendRequest(
+          config,
+          options,
+          url,
+          body,
+          formData,
+          headers,
+          onCancel
+        );
+        for (const fn of config.interceptors.response._fns) {
+          response = await fn(response);
+        }
+        const responseBody = await getResponseBody(response);
+        const responseHeader = getResponseHeader(
+          response,
+          options.responseHeader
+        );
+        const result = {
+          url,
+          ok: response.ok,
+          status: response.status,
+          statusText: response.statusText,
+          body: responseHeader ?? responseBody
+        };
+        catchErrorCodes(options, result);
+        resolve2(result.body);
+      }
+    } catch (error) {
+      reject(error);
+    }
+  });
+};
+
+// src/generated/services.gen.ts
+var BeanAccountsService = class {
+  /**
+   * Create a new account
+   * Creates a new account (Beancount Open directive)
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns AccountResponseDto Account created successfully
+   * @throws ApiError
+   */
+  static accountControllerCreate(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/accounts",
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        409: "Account already exists"
+      }
+    });
+  }
+  /**
+   * List accounts
+   * Returns all accounts with optional filtering
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @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 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
+   * @throws ApiError
+   */
+  static accountControllerFindAll(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/accounts",
+      path: {
+        region: data.region
+      },
+      query: {
+        type: data.type,
+        status: data.status,
+        isCustom: data.isCustom,
+        search: data.search,
+        limit: data.limit,
+        offset: data.offset
+      }
+    });
+  }
+  /**
+   * Get account by ID
+   * Returns a specific account
+   * @param data The data for the request.
+   * @param data.id Account UUID
+   * @param data.region Region code for tenant context
+   * @returns AccountResponseDto Account retrieved successfully
+   * @throws ApiError
+   */
+  static accountControllerFindOne(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/accounts/{id}",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: "Account not found"
+      }
+    });
+  }
+  /**
+   * Update account
+   * Updates account metadata (path cannot be changed)
+   * @param data The data for the request.
+   * @param data.id Account UUID
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns AccountResponseDto Account updated successfully
+   * @throws ApiError
+   */
+  static accountControllerUpdate(data) {
+    return request(OpenAPI, {
+      method: "PUT",
+      url: "/api/v1/{region}/bean/accounts/{id}",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        404: "Account not found"
+      }
+    });
+  }
+  /**
+   * Delete account
+   * 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
+   * @returns void Account deleted successfully
+   * @throws ApiError
+   */
+  static accountControllerDelete(data) {
+    return request(OpenAPI, {
+      method: "DELETE",
+      url: "/api/v1/{region}/bean/accounts/{id}",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        404: "Account not found",
+        409: "Account has active transactions and cannot be deleted"
+      }
+    });
+  }
+  /**
+   * Close account
+   * Closes an account (Beancount Close directive)
+   * @param data The data for the request.
+   * @param data.id Account UUID
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns AccountResponseDto Account closed successfully
+   * @throws ApiError
+   */
+  static accountControllerClose(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/accounts/{id}/close",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Account is already closed",
+        404: "Account not found"
+      }
+    });
+  }
+  /**
+   * Reopen account
+   * Reopens a previously closed 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 AccountResponseDto Account reopened successfully
+   * @throws ApiError
+   */
+  static accountControllerReopen(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/accounts/{id}/reopen",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Account is not closed",
+        404: "Account not found"
+      }
+    });
+  }
+  /**
+   * 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 {
+  /**
+   * @deprecated
+   * Create transaction (DEPRECATED)
+   * DEPRECATED: Use POST /:region/bean/import/provider/:name/sync instead. This endpoint skips dedup, rule matching, and review branching.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody Transaction data with postings
+   * @returns TransactionResponseDto Transaction created successfully
+   * @throws ApiError
+   */
+  static transactionControllerCreate(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/transactions",
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Validation failed",
+        401: "Authentication required",
+        422: "Semantic validation failed (transaction does not balance, invalid accounts)",
+        500: "Unexpected server error"
+      }
+    });
+  }
+  /**
+   * List transactions
+   * Returns a paginated list of transactions with optional filters
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.limit Number of items per page (1-100, default: 20)
+   * @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: 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
+   */
+  static transactionControllerList(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/transactions",
+      path: {
+        region: data.region
+      },
+      query: {
+        limit: data.limit,
+        offset: data.offset,
+        dateFrom: data.dateFrom,
+        dateTo: data.dateTo,
+        status: data.status,
+        search: data.search,
+        accountId: data.accountId,
+        category: data.category,
+        flow: data.flow
+      },
+      errors: {
+        400: "Validation failed",
+        401: "Authentication required"
+      }
+    });
+  }
+  /**
+   * @deprecated
+   * Batch create transactions (DEPRECATED)
+   * DEPRECATED: Use POST /:region/bean/import/provider/:name/sync instead. This endpoint skips dedup, rule matching, and review branching.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns BatchTransactionResponseDto Transactions processed
+   * @throws ApiError
+   */
+  static transactionControllerCreateBatch(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/transactions/batch",
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Invalid input",
+        401: "Authentication required"
+      }
+    });
+  }
+  /**
+   * 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
+   */
+  static transactionControllerCorrect(data) {
+    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
+   */
+  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
+   * @param data The data for the request.
+   * @param data.id Transaction ID
+   * @param data.region Region code for tenant context
+   * @returns TransactionDetailDto Transaction detail
+   * @throws ApiError
+   */
+  static transactionControllerGetDetail(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/transactions/{id}",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        401: "Authentication required",
+        404: "Transaction not found"
+      }
+    });
+  }
+  /**
+   * Update transaction metadata
+   * Updates transaction metadata (flag, payee, narration, tags, links, meta). Postings cannot be modified.
+   * @param data The data for the request.
+   * @param data.id Transaction ID
+   * @param data.region Region code for tenant context
+   * @param data.requestBody Fields to update (all optional)
+   * @returns TransactionDetailDto Transaction updated successfully
+   * @throws ApiError
+   */
+  static transactionControllerUpdate(data) {
+    return request(OpenAPI, {
+      method: "PATCH",
+      url: "/api/v1/{region}/bean/transactions/{id}",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Cannot update voided transaction",
+        401: "Authentication required",
+        404: "Transaction not found"
+      }
+    });
+  }
+  /**
+   * Void transaction
+   * Soft-deletes a transaction by marking it as VOIDED
+   * @param data The data for the request.
+   * @param data.id Transaction ID
+   * @param data.region Region code for tenant context
+   * @returns void Transaction voided successfully
+   * @throws ApiError
+   */
+  static transactionControllerDelete(data) {
+    return request(OpenAPI, {
+      method: "DELETE",
+      url: "/api/v1/{region}/bean/transactions/{id}",
+      path: {
+        id: data.id,
+        region: data.region
+      },
+      errors: {
+        400: "Transaction already voided",
+        401: "Authentication required",
+        404: "Transaction not found"
+      }
+    });
+  }
+};
+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: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")
+   * @returns BalanceResponseDto Balance calculated successfully
+   * @throws ApiError
+   */
+  static balanceControllerGetBalance(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/balances",
+      path: {
+        region: data.region
+      },
+      query: {
+        account: data.account,
+        date: data.date,
+        currency: data.currency
+      },
+      errors: {
+        400: "Invalid query parameters",
+        401: "User not authenticated"
+      }
+    });
+  }
+  /**
+   * Query multi-currency account balance
+   * Calculate account balances for all currencies at a specific date
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @returns MultiCurrencyBalanceResponseDto Balances calculated successfully
+   * @throws ApiError
+   */
+  static balanceControllerGetMultiCurrencyBalance(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/balances/multi-currency",
+      path: {
+        region: data.region
+      },
+      errors: {
+        400: "Invalid query parameters",
+        401: "User not authenticated"
+      }
+    });
+  }
+};
+var BeanCommoditiesService = class {
+  /**
+   * Create a new commodity
+   * Creates a new commodity definition for the authenticated user
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns CommodityResponseDto Commodity created successfully
+   * @throws ApiError
+   */
+  static commodityControllerCreate(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/commodities",
+      path: {
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Invalid input data",
+        409: "Commodity already exists"
+      }
+    });
+  }
+  /**
+   * List user commodities
+   * Returns all commodity definitions for the authenticated user with optional filtering
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @param data.search Search term for symbol or metadata fields (partial match). Searches symbol and metadata.name.
+   * @param data.symbol Filter by exact symbol match
+   * @returns CommodityListResponseDto Commodities retrieved successfully
+   * @throws ApiError
+   */
+  static commodityControllerFindAll(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/commodities",
+      path: {
+        region: data.region
+      },
+      query: {
+        search: data.search,
+        symbol: data.symbol
+      }
+    });
+  }
+  /**
+   * Get commodity by symbol
+   * Returns a specific commodity definition by its symbol
+   * @param data The data for the request.
+   * @param data.symbol Commodity symbol
+   * @param data.region Region code for tenant context
+   * @returns CommodityResponseDto Commodity retrieved successfully
+   * @throws ApiError
+   */
+  static commodityControllerFindOne(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/commodities/{symbol}",
+      path: {
+        symbol: data.symbol,
+        region: data.region
+      },
+      errors: {
+        404: "Commodity not found"
+      }
+    });
+  }
+  /**
+   * Update commodity
+   * Updates an existing commodity definition. Symbol cannot be changed.
+   * @param data The data for the request.
+   * @param data.symbol Commodity symbol
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns CommodityResponseDto Commodity updated successfully
+   * @throws ApiError
+   */
+  static commodityControllerUpdate(data) {
+    return request(OpenAPI, {
+      method: "PUT",
+      url: "/api/v1/{region}/bean/commodities/{symbol}",
+      path: {
+        symbol: data.symbol,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Invalid input data",
+        404: "Commodity not found"
+      }
+    });
+  }
+  /**
+   * Delete commodity
+   * Deletes a commodity definition
+   * @param data The data for the request.
+   * @param data.symbol Commodity symbol
+   * @param data.region Region code for tenant context
+   * @returns void Commodity deleted successfully
+   * @throws ApiError
+   */
+  static commodityControllerDelete(data) {
+    return request(OpenAPI, {
+      method: "DELETE",
+      url: "/api/v1/{region}/bean/commodities/{symbol}",
+      path: {
+        symbol: data.symbol,
+        region: data.region
+      },
+      errors: {
+        404: "Commodity not found"
+      }
+    });
+  }
+  /**
+   * Ensure commodity exists
+   * Gets existing commodity or creates it with automatic initialization from OpenBB
+   * @param data The data for the request.
+   * @param data.symbol Commodity symbol
+   * @param data.region Region code for tenant context
+   * @returns CommodityResponseDto Commodity retrieved or created
+   * @throws ApiError
+   */
+  static commodityControllerGetOrCreate(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/commodities/{symbol}/ensure",
+      path: {
+        symbol: data.symbol,
+        region: data.region
+      }
+    });
+  }
+  /**
+   * Bulk create commodities
+   * Creates multiple commodities from a list of symbols, useful for initialization
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @returns CommodityResponseDto Commodities created successfully
+   * @throws ApiError
+   */
+  static commodityControllerBulkCreate(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/commodities/bulk",
+      path: {
+        region: data.region
+      }
+    });
+  }
+};
+var ProviderSyncService = class {
+  /**
+   * Sync transactions from financial data provider
+   *
+   * Accepts raw transactions from external financial data providers, transforms them to Beancount format, and processes them through the ingestion pipeline.
+   *
+   * **Supported Providers:**
+   * - **plaid**: Plaid API (US, Canada, Europe)
+   * - **teller**: Teller API (US)
+   * - **truelayer**: TrueLayer Open Banking (UK, Europe)
+   * - **gocardless**: GoCardless Bank Account Data (Europe)
+   * - **simplefin**: SimpleFIN (Self-hosted)
+   * - **yodlee**: Yodlee (Global)
+   * - **beancount-direct**: Beancount format transactions
+   * - **parsed-bill**: Client-side parsed bill transactions
+   *
+   * **Processing Flow:**
+   * 1. Transform raw data via provider adapter
+   * 2. Validate transaction format
+   * 3. Deduplicate using originalId
+   * 4. Classify using rule engine
+   * 5. Route low-confidence to Review Center
+   * 6. Persist validated transactions
+   *
+   * @param data The data for the request.
+   * @param data.providerName Provider name
+   * @param data.region Region code for tenant context
+   * @param data.requestBody
+   * @returns ProviderSyncResponseDto Sync completed successfully
+   * @throws ApiError
+   */
+  static providerSyncControllerSync(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/{region}/bean/import/provider/{providerName}/sync",
+      path: {
+        providerName: data.providerName,
+        region: data.region
+      },
+      body: data.requestBody,
+      mediaType: "application/json",
+      errors: {
+        400: "Invalid request data",
+        401: "Missing or invalid authentication",
+        404: "Provider not supported"
+      }
+    });
+  }
+  /**
+   * Get supported providers
+   * Returns a list of all providers supported by the sync endpoint.
+   * @param data The data for the request.
+   * @param data.region Region code for tenant context
+   * @returns SupportedProvidersResponseDto List of supported providers
+   * @throws ApiError
+   */
+  static providerSyncControllerGetSupportedProviders(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/import/provider/supported",
+      path: {
+        region: data.region
+      },
+      errors: {
+        401: "Missing or invalid authentication"
+      }
+    });
+  }
+  /**
+   * Check if provider is supported
+   * Returns whether a specific provider is supported.
+   * @param data The data for the request.
+   * @param data.providerName Provider name to check
+   * @param data.region Region code for tenant context
+   * @returns unknown Provider support status
+   * @throws ApiError
+   */
+  static providerSyncControllerIsProviderSupported(data) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/{region}/bean/import/provider/{providerName}/supported",
+      path: {
+        providerName: data.providerName,
+        region: data.region
+      },
+      errors: {
+        401: "Missing or invalid authentication"
+      }
+    });
+  }
+};
+var HealthService = class {
+  /**
+   * Basic health check for K8s/load balancer probes
+   * @returns unknown Service is healthy
+   * @throws ApiError
+   */
+  static healthControllerGetHealth() {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/health",
+      errors: {
+        503: "Service unavailable"
+      }
+    });
+  }
+  /**
+   * Check database connection health
+   * @returns unknown Database is healthy
+   * @throws ApiError
+   */
+  static healthControllerCheckDatabase() {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/health/database",
+      errors: {
+        503: "Database unavailable"
+      }
+    });
+  }
+  /**
+   * Check OpenBB schema status
+   * @returns unknown OpenBB status
+   * @throws ApiError
+   */
+  static healthControllerCheckOpenBb() {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/health/openbb",
+      errors: {
+        503: "OpenBB unavailable"
+      }
+    });
+  }
+  /**
+   * Check Redis connection health
+   * @returns unknown Redis is healthy
+   * @throws ApiError
+   */
+  static healthControllerCheckRedis() {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/health/redis",
+      errors: {
+        503: "Redis unavailable"
+      }
+    });
+  }
+  /**
+   * Get status of all circuit breakers
+   * @returns unknown Circuit breaker status
+   * @throws ApiError
+   */
+  static healthControllerGetCircuitBreakersHealth() {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/health/circuit-breakers",
+      errors: {
+        401: "Unauthorized",
+        500: "Internal error"
+      }
+    });
+  }
+  /**
+   * Reset a circuit breaker to CLOSED state
+   * @param data The data for the request.
+   * @param data.name Circuit breaker name to reset
+   * @returns unknown Circuit breaker reset successfully
+   * @throws ApiError
+   */
+  static healthControllerResetCircuitBreaker(data) {
+    return request(OpenAPI, {
+      method: "POST",
+      url: "/api/v1/health/circuit-breakers/{name}/reset",
+      path: {
+        name: data.name
+      },
+      errors: {
+        401: "Unauthorized",
+        404: "Circuit breaker not found"
+      }
+    });
+  }
+  /**
+   * Get health check metrics and statistics
+   * @returns unknown Health metrics
+   * @throws ApiError
+   */
+  static healthControllerGetMetrics() {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/api/v1/health/metrics",
+      errors: {
+        401: "Unauthorized"
+      }
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BeanAccountsService,
+  BeanBalancesService,
+  BeanCommoditiesService,
+  BeanTransactionsService,
+  HealthService,
+  OpenAPI,
+  ProviderSyncService
+});