@firela/api-types 0.0.0-canary.012b1cb9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js ADDED
@@ -0,0 +1,1296 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/index.ts
21
+ var index_exports = {};
22
+ __export(index_exports, {
23
+ BeanAccountsService: () => BeanAccountsService,
24
+ BeanBalancesService: () => BeanBalancesService,
25
+ BeanCommoditiesService: () => BeanCommoditiesService,
26
+ BeanTransactionsService: () => BeanTransactionsService,
27
+ HealthService: () => HealthService,
28
+ OpenAPI: () => OpenAPI,
29
+ ProviderSyncService: () => ProviderSyncService
30
+ });
31
+ module.exports = __toCommonJS(index_exports);
32
+
33
+ // src/generated/core/OpenAPI.ts
34
+ var Interceptors = class {
35
+ constructor() {
36
+ this._fns = [];
37
+ }
38
+ eject(fn) {
39
+ const index = this._fns.indexOf(fn);
40
+ if (index !== -1) {
41
+ this._fns = [...this._fns.slice(0, index), ...this._fns.slice(index + 1)];
42
+ }
43
+ }
44
+ use(fn) {
45
+ this._fns = [...this._fns, fn];
46
+ }
47
+ };
48
+ var OpenAPI = {
49
+ BASE: "",
50
+ CREDENTIALS: "include",
51
+ ENCODE_PATH: void 0,
52
+ HEADERS: void 0,
53
+ PASSWORD: void 0,
54
+ TOKEN: void 0,
55
+ USERNAME: void 0,
56
+ VERSION: "dev",
57
+ WITH_CREDENTIALS: false,
58
+ interceptors: {
59
+ request: new Interceptors(),
60
+ response: new Interceptors()
61
+ }
62
+ };
63
+
64
+ // src/generated/core/ApiError.ts
65
+ var ApiError = class extends Error {
66
+ constructor(request2, response, message) {
67
+ super(message);
68
+ this.name = "ApiError";
69
+ this.url = response.url;
70
+ this.status = response.status;
71
+ this.statusText = response.statusText;
72
+ this.body = response.body;
73
+ this.request = request2;
74
+ }
75
+ };
76
+
77
+ // src/generated/core/CancelablePromise.ts
78
+ var CancelError = class extends Error {
79
+ constructor(message) {
80
+ super(message);
81
+ this.name = "CancelError";
82
+ }
83
+ get isCancelled() {
84
+ return true;
85
+ }
86
+ };
87
+ var CancelablePromise = class {
88
+ constructor(executor) {
89
+ this._isResolved = false;
90
+ this._isRejected = false;
91
+ this._isCancelled = false;
92
+ this.cancelHandlers = [];
93
+ this.promise = new Promise((resolve2, reject) => {
94
+ this._resolve = resolve2;
95
+ this._reject = reject;
96
+ const onResolve = (value) => {
97
+ if (this._isResolved || this._isRejected || this._isCancelled) {
98
+ return;
99
+ }
100
+ this._isResolved = true;
101
+ if (this._resolve) this._resolve(value);
102
+ };
103
+ const onReject = (reason) => {
104
+ if (this._isResolved || this._isRejected || this._isCancelled) {
105
+ return;
106
+ }
107
+ this._isRejected = true;
108
+ if (this._reject) this._reject(reason);
109
+ };
110
+ const onCancel = (cancelHandler) => {
111
+ if (this._isResolved || this._isRejected || this._isCancelled) {
112
+ return;
113
+ }
114
+ this.cancelHandlers.push(cancelHandler);
115
+ };
116
+ Object.defineProperty(onCancel, "isResolved", {
117
+ get: () => this._isResolved
118
+ });
119
+ Object.defineProperty(onCancel, "isRejected", {
120
+ get: () => this._isRejected
121
+ });
122
+ Object.defineProperty(onCancel, "isCancelled", {
123
+ get: () => this._isCancelled
124
+ });
125
+ return executor(onResolve, onReject, onCancel);
126
+ });
127
+ }
128
+ get [Symbol.toStringTag]() {
129
+ return "Cancellable Promise";
130
+ }
131
+ then(onFulfilled, onRejected) {
132
+ return this.promise.then(onFulfilled, onRejected);
133
+ }
134
+ catch(onRejected) {
135
+ return this.promise.catch(onRejected);
136
+ }
137
+ finally(onFinally) {
138
+ return this.promise.finally(onFinally);
139
+ }
140
+ cancel() {
141
+ if (this._isResolved || this._isRejected || this._isCancelled) {
142
+ return;
143
+ }
144
+ this._isCancelled = true;
145
+ if (this.cancelHandlers.length) {
146
+ try {
147
+ for (const cancelHandler of this.cancelHandlers) {
148
+ cancelHandler();
149
+ }
150
+ } catch (error) {
151
+ console.warn("Cancellation threw an error", error);
152
+ return;
153
+ }
154
+ }
155
+ this.cancelHandlers.length = 0;
156
+ if (this._reject) this._reject(new CancelError("Request aborted"));
157
+ }
158
+ get isCancelled() {
159
+ return this._isCancelled;
160
+ }
161
+ };
162
+
163
+ // src/generated/core/request.ts
164
+ var isString = (value) => {
165
+ return typeof value === "string";
166
+ };
167
+ var isStringWithValue = (value) => {
168
+ return isString(value) && value !== "";
169
+ };
170
+ var isBlob = (value) => {
171
+ return value instanceof Blob;
172
+ };
173
+ var isFormData = (value) => {
174
+ return value instanceof FormData;
175
+ };
176
+ var base64 = (str) => {
177
+ try {
178
+ return btoa(str);
179
+ } catch (err) {
180
+ return Buffer.from(str).toString("base64");
181
+ }
182
+ };
183
+ var getQueryString = (params) => {
184
+ const qs = [];
185
+ const append = (key, value) => {
186
+ qs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
187
+ };
188
+ const encodePair = (key, value) => {
189
+ if (value === void 0 || value === null) {
190
+ return;
191
+ }
192
+ if (value instanceof Date) {
193
+ append(key, value.toISOString());
194
+ } else if (Array.isArray(value)) {
195
+ value.forEach((v) => encodePair(key, v));
196
+ } else if (typeof value === "object") {
197
+ Object.entries(value).forEach(([k, v]) => encodePair(`${key}[${k}]`, v));
198
+ } else {
199
+ append(key, value);
200
+ }
201
+ };
202
+ Object.entries(params).forEach(([key, value]) => encodePair(key, value));
203
+ return qs.length ? `?${qs.join("&")}` : "";
204
+ };
205
+ var getUrl = (config, options) => {
206
+ const encoder = config.ENCODE_PATH || encodeURI;
207
+ const path = options.url.replace("{api-version}", config.VERSION).replace(/{(.*?)}/g, (substring, group) => {
208
+ if (options.path?.hasOwnProperty(group)) {
209
+ return encoder(String(options.path[group]));
210
+ }
211
+ return substring;
212
+ });
213
+ const url = config.BASE + path;
214
+ return options.query ? url + getQueryString(options.query) : url;
215
+ };
216
+ var getFormData = (options) => {
217
+ if (options.formData) {
218
+ const formData = new FormData();
219
+ const process = (key, value) => {
220
+ if (isString(value) || isBlob(value)) {
221
+ formData.append(key, value);
222
+ } else {
223
+ formData.append(key, JSON.stringify(value));
224
+ }
225
+ };
226
+ Object.entries(options.formData).filter(([, value]) => value !== void 0 && value !== null).forEach(([key, value]) => {
227
+ if (Array.isArray(value)) {
228
+ value.forEach((v) => process(key, v));
229
+ } else {
230
+ process(key, value);
231
+ }
232
+ });
233
+ return formData;
234
+ }
235
+ return void 0;
236
+ };
237
+ var resolve = async (options, resolver) => {
238
+ if (typeof resolver === "function") {
239
+ return resolver(options);
240
+ }
241
+ return resolver;
242
+ };
243
+ var getHeaders = async (config, options) => {
244
+ const [token, username, password, additionalHeaders] = await Promise.all([
245
+ resolve(options, config.TOKEN),
246
+ resolve(options, config.USERNAME),
247
+ resolve(options, config.PASSWORD),
248
+ resolve(options, config.HEADERS)
249
+ ]);
250
+ const headers = Object.entries({
251
+ Accept: "application/json",
252
+ ...additionalHeaders,
253
+ ...options.headers
254
+ }).filter(([, value]) => value !== void 0 && value !== null).reduce(
255
+ (headers2, [key, value]) => ({
256
+ ...headers2,
257
+ [key]: String(value)
258
+ }),
259
+ {}
260
+ );
261
+ if (isStringWithValue(token)) {
262
+ headers["Authorization"] = `Bearer ${token}`;
263
+ }
264
+ if (isStringWithValue(username) && isStringWithValue(password)) {
265
+ const credentials = base64(`${username}:${password}`);
266
+ headers["Authorization"] = `Basic ${credentials}`;
267
+ }
268
+ if (options.body !== void 0) {
269
+ if (options.mediaType) {
270
+ headers["Content-Type"] = options.mediaType;
271
+ } else if (isBlob(options.body)) {
272
+ headers["Content-Type"] = options.body.type || "application/octet-stream";
273
+ } else if (isString(options.body)) {
274
+ headers["Content-Type"] = "text/plain";
275
+ } else if (!isFormData(options.body)) {
276
+ headers["Content-Type"] = "application/json";
277
+ }
278
+ }
279
+ return new Headers(headers);
280
+ };
281
+ var getRequestBody = (options) => {
282
+ if (options.body !== void 0) {
283
+ if (options.mediaType?.includes("application/json") || options.mediaType?.includes("+json")) {
284
+ return JSON.stringify(options.body);
285
+ } else if (isString(options.body) || isBlob(options.body) || isFormData(options.body)) {
286
+ return options.body;
287
+ } else {
288
+ return JSON.stringify(options.body);
289
+ }
290
+ }
291
+ return void 0;
292
+ };
293
+ var sendRequest = async (config, options, url, body, formData, headers, onCancel) => {
294
+ const controller = new AbortController();
295
+ let request2 = {
296
+ headers,
297
+ body: body ?? formData,
298
+ method: options.method,
299
+ signal: controller.signal
300
+ };
301
+ if (config.WITH_CREDENTIALS) {
302
+ request2.credentials = config.CREDENTIALS;
303
+ }
304
+ for (const fn of config.interceptors.request._fns) {
305
+ request2 = await fn(request2);
306
+ }
307
+ onCancel(() => controller.abort());
308
+ return await fetch(url, request2);
309
+ };
310
+ var getResponseHeader = (response, responseHeader) => {
311
+ if (responseHeader) {
312
+ const content = response.headers.get(responseHeader);
313
+ if (isString(content)) {
314
+ return content;
315
+ }
316
+ }
317
+ return void 0;
318
+ };
319
+ var getResponseBody = async (response) => {
320
+ if (response.status !== 204) {
321
+ try {
322
+ const contentType = response.headers.get("Content-Type");
323
+ if (contentType) {
324
+ const binaryTypes = [
325
+ "application/octet-stream",
326
+ "application/pdf",
327
+ "application/zip",
328
+ "audio/",
329
+ "image/",
330
+ "video/"
331
+ ];
332
+ if (contentType.includes("application/json") || contentType.includes("+json")) {
333
+ return await response.json();
334
+ } else if (binaryTypes.some((type) => contentType.includes(type))) {
335
+ return await response.blob();
336
+ } else if (contentType.includes("multipart/form-data")) {
337
+ return await response.formData();
338
+ } else if (contentType.includes("text/")) {
339
+ return await response.text();
340
+ }
341
+ }
342
+ } catch (error) {
343
+ console.error(error);
344
+ }
345
+ }
346
+ return void 0;
347
+ };
348
+ var catchErrorCodes = (options, result) => {
349
+ const errors = {
350
+ 400: "Bad Request",
351
+ 401: "Unauthorized",
352
+ 402: "Payment Required",
353
+ 403: "Forbidden",
354
+ 404: "Not Found",
355
+ 405: "Method Not Allowed",
356
+ 406: "Not Acceptable",
357
+ 407: "Proxy Authentication Required",
358
+ 408: "Request Timeout",
359
+ 409: "Conflict",
360
+ 410: "Gone",
361
+ 411: "Length Required",
362
+ 412: "Precondition Failed",
363
+ 413: "Payload Too Large",
364
+ 414: "URI Too Long",
365
+ 415: "Unsupported Media Type",
366
+ 416: "Range Not Satisfiable",
367
+ 417: "Expectation Failed",
368
+ 418: "Im a teapot",
369
+ 421: "Misdirected Request",
370
+ 422: "Unprocessable Content",
371
+ 423: "Locked",
372
+ 424: "Failed Dependency",
373
+ 425: "Too Early",
374
+ 426: "Upgrade Required",
375
+ 428: "Precondition Required",
376
+ 429: "Too Many Requests",
377
+ 431: "Request Header Fields Too Large",
378
+ 451: "Unavailable For Legal Reasons",
379
+ 500: "Internal Server Error",
380
+ 501: "Not Implemented",
381
+ 502: "Bad Gateway",
382
+ 503: "Service Unavailable",
383
+ 504: "Gateway Timeout",
384
+ 505: "HTTP Version Not Supported",
385
+ 506: "Variant Also Negotiates",
386
+ 507: "Insufficient Storage",
387
+ 508: "Loop Detected",
388
+ 510: "Not Extended",
389
+ 511: "Network Authentication Required",
390
+ ...options.errors
391
+ };
392
+ const error = errors[result.status];
393
+ if (error) {
394
+ throw new ApiError(options, result, error);
395
+ }
396
+ if (!result.ok) {
397
+ const errorStatus = result.status ?? "unknown";
398
+ const errorStatusText = result.statusText ?? "unknown";
399
+ const errorBody = (() => {
400
+ try {
401
+ return JSON.stringify(result.body, null, 2);
402
+ } catch (e) {
403
+ return void 0;
404
+ }
405
+ })();
406
+ throw new ApiError(
407
+ options,
408
+ result,
409
+ `Generic Error: status: ${errorStatus}; status text: ${errorStatusText}; body: ${errorBody}`
410
+ );
411
+ }
412
+ };
413
+ var request = (config, options) => {
414
+ return new CancelablePromise(async (resolve2, reject, onCancel) => {
415
+ try {
416
+ const url = getUrl(config, options);
417
+ const formData = getFormData(options);
418
+ const body = getRequestBody(options);
419
+ const headers = await getHeaders(config, options);
420
+ if (!onCancel.isCancelled) {
421
+ let response = await sendRequest(
422
+ config,
423
+ options,
424
+ url,
425
+ body,
426
+ formData,
427
+ headers,
428
+ onCancel
429
+ );
430
+ for (const fn of config.interceptors.response._fns) {
431
+ response = await fn(response);
432
+ }
433
+ const responseBody = await getResponseBody(response);
434
+ const responseHeader = getResponseHeader(
435
+ response,
436
+ options.responseHeader
437
+ );
438
+ const result = {
439
+ url,
440
+ ok: response.ok,
441
+ status: response.status,
442
+ statusText: response.statusText,
443
+ body: responseHeader ?? responseBody
444
+ };
445
+ catchErrorCodes(options, result);
446
+ resolve2(result.body);
447
+ }
448
+ } catch (error) {
449
+ reject(error);
450
+ }
451
+ });
452
+ };
453
+
454
+ // src/generated/services.gen.ts
455
+ var BeanAccountsService = class {
456
+ /**
457
+ * Create a new account
458
+ * Creates a new account (Beancount Open directive)
459
+ * @param data The data for the request.
460
+ * @param data.region Region code for tenant context
461
+ * @param data.requestBody
462
+ * @returns AccountResponseDto Account created successfully
463
+ * @throws ApiError
464
+ */
465
+ static accountControllerCreate(data) {
466
+ return request(OpenAPI, {
467
+ method: "POST",
468
+ url: "/api/v1/{region}/bean/accounts",
469
+ path: {
470
+ region: data.region
471
+ },
472
+ body: data.requestBody,
473
+ mediaType: "application/json",
474
+ errors: {
475
+ 409: "Account already exists"
476
+ }
477
+ });
478
+ }
479
+ /**
480
+ * List accounts
481
+ * Returns all accounts with optional filtering
482
+ * @param data The data for the request.
483
+ * @param data.region Region code for tenant context
484
+ * @param data.type Filter by account type
485
+ * @param data.status Filter by status
486
+ * @param data.isCustom Filter by custom (user-created) accounts only
487
+ * @param data.search Search term for account path
488
+ * @param data.limit Maximum number of results
489
+ * @param data.offset Number of results to skip
490
+ * @returns AccountListResponseDto Accounts retrieved successfully
491
+ * @throws ApiError
492
+ */
493
+ static accountControllerFindAll(data) {
494
+ return request(OpenAPI, {
495
+ method: "GET",
496
+ url: "/api/v1/{region}/bean/accounts",
497
+ path: {
498
+ region: data.region
499
+ },
500
+ query: {
501
+ type: data.type,
502
+ status: data.status,
503
+ isCustom: data.isCustom,
504
+ search: data.search,
505
+ limit: data.limit,
506
+ offset: data.offset
507
+ }
508
+ });
509
+ }
510
+ /**
511
+ * Get account by ID
512
+ * Returns a specific account
513
+ * @param data The data for the request.
514
+ * @param data.id Account UUID
515
+ * @param data.region Region code for tenant context
516
+ * @returns AccountResponseDto Account retrieved successfully
517
+ * @throws ApiError
518
+ */
519
+ static accountControllerFindOne(data) {
520
+ return request(OpenAPI, {
521
+ method: "GET",
522
+ url: "/api/v1/{region}/bean/accounts/{id}",
523
+ path: {
524
+ id: data.id,
525
+ region: data.region
526
+ },
527
+ errors: {
528
+ 404: "Account not found"
529
+ }
530
+ });
531
+ }
532
+ /**
533
+ * Update account
534
+ * Updates account metadata (path cannot be changed)
535
+ * @param data The data for the request.
536
+ * @param data.id Account UUID
537
+ * @param data.region Region code for tenant context
538
+ * @param data.requestBody
539
+ * @returns AccountResponseDto Account updated successfully
540
+ * @throws ApiError
541
+ */
542
+ static accountControllerUpdate(data) {
543
+ return request(OpenAPI, {
544
+ method: "PUT",
545
+ url: "/api/v1/{region}/bean/accounts/{id}",
546
+ path: {
547
+ id: data.id,
548
+ region: data.region
549
+ },
550
+ body: data.requestBody,
551
+ mediaType: "application/json",
552
+ errors: {
553
+ 404: "Account not found"
554
+ }
555
+ });
556
+ }
557
+ /**
558
+ * Delete account
559
+ * Deletes an account (only if no active transactions; voided/superseded residual postings are cleaned up)
560
+ * @param data The data for the request.
561
+ * @param data.id Account UUID
562
+ * @param data.region Region code for tenant context
563
+ * @returns void Account deleted successfully
564
+ * @throws ApiError
565
+ */
566
+ static accountControllerDelete(data) {
567
+ return request(OpenAPI, {
568
+ method: "DELETE",
569
+ url: "/api/v1/{region}/bean/accounts/{id}",
570
+ path: {
571
+ id: data.id,
572
+ region: data.region
573
+ },
574
+ errors: {
575
+ 404: "Account not found",
576
+ 409: "Account has active transactions and cannot be deleted"
577
+ }
578
+ });
579
+ }
580
+ /**
581
+ * Close account
582
+ * Closes an account (Beancount Close directive)
583
+ * @param data The data for the request.
584
+ * @param data.id Account UUID
585
+ * @param data.region Region code for tenant context
586
+ * @param data.requestBody
587
+ * @returns AccountResponseDto Account closed successfully
588
+ * @throws ApiError
589
+ */
590
+ static accountControllerClose(data) {
591
+ return request(OpenAPI, {
592
+ method: "POST",
593
+ url: "/api/v1/{region}/bean/accounts/{id}/close",
594
+ path: {
595
+ id: data.id,
596
+ region: data.region
597
+ },
598
+ body: data.requestBody,
599
+ mediaType: "application/json",
600
+ errors: {
601
+ 400: "Account is already closed",
602
+ 404: "Account not found"
603
+ }
604
+ });
605
+ }
606
+ /**
607
+ * Reopen account
608
+ * Reopens a previously closed account
609
+ * @param data The data for the request.
610
+ * @param data.id Account UUID
611
+ * @param data.region Region code for tenant context
612
+ * @param data.requestBody
613
+ * @returns AccountResponseDto Account reopened successfully
614
+ * @throws ApiError
615
+ */
616
+ static accountControllerReopen(data) {
617
+ return request(OpenAPI, {
618
+ method: "POST",
619
+ url: "/api/v1/{region}/bean/accounts/{id}/reopen",
620
+ path: {
621
+ id: data.id,
622
+ region: data.region
623
+ },
624
+ body: data.requestBody,
625
+ mediaType: "application/json",
626
+ errors: {
627
+ 400: "Account is not closed",
628
+ 404: "Account not found"
629
+ }
630
+ });
631
+ }
632
+ /**
633
+ * Post an opening-balance transaction
634
+ * 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.
635
+ * @param data The data for the request.
636
+ * @param data.id Account UUID
637
+ * @param data.region Region code for tenant context
638
+ * @param data.requestBody
639
+ * @returns OpeningBalanceResultDto Opening-balance transaction created
640
+ * @throws ApiError
641
+ */
642
+ static accountControllerAddOpeningBalance(data) {
643
+ return request(OpenAPI, {
644
+ method: "POST",
645
+ url: "/api/v1/{region}/bean/accounts/{id}/opening-balance",
646
+ path: {
647
+ id: data.id,
648
+ region: data.region
649
+ },
650
+ body: data.requestBody,
651
+ mediaType: "application/json",
652
+ errors: {
653
+ 404: "Account not found",
654
+ 409: "An opening balance already exists for this account"
655
+ }
656
+ });
657
+ }
658
+ };
659
+ var BeanTransactionsService = class {
660
+ /**
661
+ * @deprecated
662
+ * Create transaction (DEPRECATED)
663
+ * DEPRECATED: Use POST /:region/bean/import/provider/:name/sync instead. This endpoint skips dedup, rule matching, and review branching.
664
+ * @param data The data for the request.
665
+ * @param data.region Region code for tenant context
666
+ * @param data.requestBody Transaction data with postings
667
+ * @returns TransactionResponseDto Transaction created successfully
668
+ * @throws ApiError
669
+ */
670
+ static transactionControllerCreate(data) {
671
+ return request(OpenAPI, {
672
+ method: "POST",
673
+ url: "/api/v1/{region}/bean/transactions",
674
+ path: {
675
+ region: data.region
676
+ },
677
+ body: data.requestBody,
678
+ mediaType: "application/json",
679
+ errors: {
680
+ 400: "Validation failed",
681
+ 401: "Authentication required",
682
+ 422: "Semantic validation failed (transaction does not balance, invalid accounts)",
683
+ 500: "Unexpected server error"
684
+ }
685
+ });
686
+ }
687
+ /**
688
+ * List transactions
689
+ * Returns a paginated list of transactions with optional filters
690
+ * @param data The data for the request.
691
+ * @param data.region Region code for tenant context
692
+ * @param data.limit Number of items per page (1-100, default: 20)
693
+ * @param data.offset Number of items to skip (default: 0)
694
+ * @param data.dateFrom Filter by start date (inclusive), format: YYYY-MM-DD
695
+ * @param data.dateTo Filter by end date (inclusive), format: YYYY-MM-DD
696
+ * @param data.status Filter by transaction status
697
+ * @param data.search Search in narration and payee fields (max 200 chars)
698
+ * @param data.accountId Filter by account ID (transactions with postings to this account)
699
+ * @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
700
+ * @returns TransactionListResponseDto Transaction list
701
+ * @throws ApiError
702
+ */
703
+ static transactionControllerList(data) {
704
+ return request(OpenAPI, {
705
+ method: "GET",
706
+ url: "/api/v1/{region}/bean/transactions",
707
+ path: {
708
+ region: data.region
709
+ },
710
+ query: {
711
+ limit: data.limit,
712
+ offset: data.offset,
713
+ dateFrom: data.dateFrom,
714
+ dateTo: data.dateTo,
715
+ status: data.status,
716
+ search: data.search,
717
+ accountId: data.accountId,
718
+ category: data.category
719
+ },
720
+ errors: {
721
+ 400: "Validation failed",
722
+ 401: "Authentication required"
723
+ }
724
+ });
725
+ }
726
+ /**
727
+ * @deprecated
728
+ * Batch create transactions (DEPRECATED)
729
+ * DEPRECATED: Use POST /:region/bean/import/provider/:name/sync instead. This endpoint skips dedup, rule matching, and review branching.
730
+ * @param data The data for the request.
731
+ * @param data.region Region code for tenant context
732
+ * @param data.requestBody
733
+ * @returns BatchTransactionResponseDto Transactions processed
734
+ * @throws ApiError
735
+ */
736
+ static transactionControllerCreateBatch(data) {
737
+ return request(OpenAPI, {
738
+ method: "POST",
739
+ url: "/api/v1/{region}/bean/transactions/batch",
740
+ path: {
741
+ region: data.region
742
+ },
743
+ body: data.requestBody,
744
+ mediaType: "application/json",
745
+ errors: {
746
+ 400: "Invalid input",
747
+ 401: "Authentication required"
748
+ }
749
+ });
750
+ }
751
+ /**
752
+ * Correct (supersede) a transaction
753
+ * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
754
+ * @param data The data for the request.
755
+ * @param data.id Original transaction ID to correct
756
+ * @param data.region Region code for tenant context
757
+ * @param data.requestBody
758
+ * @returns TransactionDetailDto Corrected transaction created
759
+ * @throws ApiError
760
+ */
761
+ static transactionControllerCorrect(data) {
762
+ return request(OpenAPI, {
763
+ method: "POST",
764
+ url: "/api/v1/{region}/bean/transactions/{id}/correct",
765
+ path: {
766
+ id: data.id,
767
+ region: data.region
768
+ },
769
+ body: data.requestBody,
770
+ mediaType: "application/json",
771
+ errors: {
772
+ 404: "Original transaction not found",
773
+ 409: "Original no longer ACTIVE (concurrent modification)",
774
+ 422: "Pipeline validation failed (does not balance, invalid accounts)"
775
+ }
776
+ });
777
+ }
778
+ /**
779
+ * Suggest transaction tags
780
+ * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.
781
+ * @param data The data for the request.
782
+ * @param data.region Region code for tenant context
783
+ * @param data.q Prefix match, case-insensitive (max 50 chars)
784
+ * @param data.sort usage (default) or name
785
+ * @param data.limit Max suggestions (1-100, default 10)
786
+ * @returns TagSuggestionsResponseDto Tag suggestions
787
+ * @throws ApiError
788
+ */
789
+ static transactionControllerSuggestTags(data) {
790
+ return request(OpenAPI, {
791
+ method: "GET",
792
+ url: "/api/v1/{region}/bean/transactions/tags",
793
+ path: {
794
+ region: data.region
795
+ },
796
+ query: {
797
+ q: data.q,
798
+ sort: data.sort,
799
+ limit: data.limit
800
+ },
801
+ errors: {
802
+ 400: "Validation failed",
803
+ 401: "Authentication required"
804
+ }
805
+ });
806
+ }
807
+ /**
808
+ * Get transaction detail
809
+ * Returns transaction details including all postings
810
+ * @param data The data for the request.
811
+ * @param data.id Transaction ID
812
+ * @param data.region Region code for tenant context
813
+ * @returns TransactionDetailDto Transaction detail
814
+ * @throws ApiError
815
+ */
816
+ static transactionControllerGetDetail(data) {
817
+ return request(OpenAPI, {
818
+ method: "GET",
819
+ url: "/api/v1/{region}/bean/transactions/{id}",
820
+ path: {
821
+ id: data.id,
822
+ region: data.region
823
+ },
824
+ errors: {
825
+ 401: "Authentication required",
826
+ 404: "Transaction not found"
827
+ }
828
+ });
829
+ }
830
+ /**
831
+ * Update transaction metadata
832
+ * Updates transaction metadata (flag, payee, narration, tags, links, meta). Postings cannot be modified.
833
+ * @param data The data for the request.
834
+ * @param data.id Transaction ID
835
+ * @param data.region Region code for tenant context
836
+ * @param data.requestBody Fields to update (all optional)
837
+ * @returns TransactionDetailDto Transaction updated successfully
838
+ * @throws ApiError
839
+ */
840
+ static transactionControllerUpdate(data) {
841
+ return request(OpenAPI, {
842
+ method: "PATCH",
843
+ url: "/api/v1/{region}/bean/transactions/{id}",
844
+ path: {
845
+ id: data.id,
846
+ region: data.region
847
+ },
848
+ body: data.requestBody,
849
+ mediaType: "application/json",
850
+ errors: {
851
+ 400: "Cannot update voided transaction",
852
+ 401: "Authentication required",
853
+ 404: "Transaction not found"
854
+ }
855
+ });
856
+ }
857
+ /**
858
+ * Void transaction
859
+ * Soft-deletes a transaction by marking it as VOIDED
860
+ * @param data The data for the request.
861
+ * @param data.id Transaction ID
862
+ * @param data.region Region code for tenant context
863
+ * @returns void Transaction voided successfully
864
+ * @throws ApiError
865
+ */
866
+ static transactionControllerDelete(data) {
867
+ return request(OpenAPI, {
868
+ method: "DELETE",
869
+ url: "/api/v1/{region}/bean/transactions/{id}",
870
+ path: {
871
+ id: data.id,
872
+ region: data.region
873
+ },
874
+ errors: {
875
+ 400: "Transaction already voided",
876
+ 401: "Authentication required",
877
+ 404: "Transaction not found"
878
+ }
879
+ });
880
+ }
881
+ };
882
+ var BeanBalancesService = class {
883
+ /**
884
+ * Query account balance
885
+ * Calculate account balance at a specific date for a single currency
886
+ * @param data The data for the request.
887
+ * @param data.account Account name (e.g., "Assets:Checking")
888
+ * @param data.region Region code for tenant context
889
+ * @param data.date Date to calculate balance at (ISO 8601 format)
890
+ * @param data.currency Currency to query (e.g., "USD", "CNY")
891
+ * @returns BalanceResponseDto Balance calculated successfully
892
+ * @throws ApiError
893
+ */
894
+ static balanceControllerGetBalance(data) {
895
+ return request(OpenAPI, {
896
+ method: "GET",
897
+ url: "/api/v1/{region}/bean/balances",
898
+ path: {
899
+ region: data.region
900
+ },
901
+ query: {
902
+ account: data.account,
903
+ date: data.date,
904
+ currency: data.currency
905
+ },
906
+ errors: {
907
+ 400: "Invalid query parameters",
908
+ 401: "User not authenticated"
909
+ }
910
+ });
911
+ }
912
+ /**
913
+ * Query multi-currency account balance
914
+ * Calculate account balances for all currencies at a specific date
915
+ * @param data The data for the request.
916
+ * @param data.region Region code for tenant context
917
+ * @returns MultiCurrencyBalanceResponseDto Balances calculated successfully
918
+ * @throws ApiError
919
+ */
920
+ static balanceControllerGetMultiCurrencyBalance(data) {
921
+ return request(OpenAPI, {
922
+ method: "GET",
923
+ url: "/api/v1/{region}/bean/balances/multi-currency",
924
+ path: {
925
+ region: data.region
926
+ },
927
+ errors: {
928
+ 400: "Invalid query parameters",
929
+ 401: "User not authenticated"
930
+ }
931
+ });
932
+ }
933
+ };
934
+ var BeanCommoditiesService = class {
935
+ /**
936
+ * Create a new commodity
937
+ * Creates a new commodity definition for the authenticated user
938
+ * @param data The data for the request.
939
+ * @param data.region Region code for tenant context
940
+ * @param data.requestBody
941
+ * @returns CommodityResponseDto Commodity created successfully
942
+ * @throws ApiError
943
+ */
944
+ static commodityControllerCreate(data) {
945
+ return request(OpenAPI, {
946
+ method: "POST",
947
+ url: "/api/v1/{region}/bean/commodities",
948
+ path: {
949
+ region: data.region
950
+ },
951
+ body: data.requestBody,
952
+ mediaType: "application/json",
953
+ errors: {
954
+ 400: "Invalid input data",
955
+ 409: "Commodity already exists"
956
+ }
957
+ });
958
+ }
959
+ /**
960
+ * List user commodities
961
+ * Returns all commodity definitions for the authenticated user with optional filtering
962
+ * @param data The data for the request.
963
+ * @param data.region Region code for tenant context
964
+ * @param data.search Search term for symbol or metadata fields (partial match). Searches symbol and metadata.name.
965
+ * @param data.symbol Filter by exact symbol match
966
+ * @returns CommodityListResponseDto Commodities retrieved successfully
967
+ * @throws ApiError
968
+ */
969
+ static commodityControllerFindAll(data) {
970
+ return request(OpenAPI, {
971
+ method: "GET",
972
+ url: "/api/v1/{region}/bean/commodities",
973
+ path: {
974
+ region: data.region
975
+ },
976
+ query: {
977
+ search: data.search,
978
+ symbol: data.symbol
979
+ }
980
+ });
981
+ }
982
+ /**
983
+ * Get commodity by symbol
984
+ * Returns a specific commodity definition by its symbol
985
+ * @param data The data for the request.
986
+ * @param data.symbol Commodity symbol
987
+ * @param data.region Region code for tenant context
988
+ * @returns CommodityResponseDto Commodity retrieved successfully
989
+ * @throws ApiError
990
+ */
991
+ static commodityControllerFindOne(data) {
992
+ return request(OpenAPI, {
993
+ method: "GET",
994
+ url: "/api/v1/{region}/bean/commodities/{symbol}",
995
+ path: {
996
+ symbol: data.symbol,
997
+ region: data.region
998
+ },
999
+ errors: {
1000
+ 404: "Commodity not found"
1001
+ }
1002
+ });
1003
+ }
1004
+ /**
1005
+ * Update commodity
1006
+ * Updates an existing commodity definition. Symbol cannot be changed.
1007
+ * @param data The data for the request.
1008
+ * @param data.symbol Commodity symbol
1009
+ * @param data.region Region code for tenant context
1010
+ * @param data.requestBody
1011
+ * @returns CommodityResponseDto Commodity updated successfully
1012
+ * @throws ApiError
1013
+ */
1014
+ static commodityControllerUpdate(data) {
1015
+ return request(OpenAPI, {
1016
+ method: "PUT",
1017
+ url: "/api/v1/{region}/bean/commodities/{symbol}",
1018
+ path: {
1019
+ symbol: data.symbol,
1020
+ region: data.region
1021
+ },
1022
+ body: data.requestBody,
1023
+ mediaType: "application/json",
1024
+ errors: {
1025
+ 400: "Invalid input data",
1026
+ 404: "Commodity not found"
1027
+ }
1028
+ });
1029
+ }
1030
+ /**
1031
+ * Delete commodity
1032
+ * Deletes a commodity definition
1033
+ * @param data The data for the request.
1034
+ * @param data.symbol Commodity symbol
1035
+ * @param data.region Region code for tenant context
1036
+ * @returns void Commodity deleted successfully
1037
+ * @throws ApiError
1038
+ */
1039
+ static commodityControllerDelete(data) {
1040
+ return request(OpenAPI, {
1041
+ method: "DELETE",
1042
+ url: "/api/v1/{region}/bean/commodities/{symbol}",
1043
+ path: {
1044
+ symbol: data.symbol,
1045
+ region: data.region
1046
+ },
1047
+ errors: {
1048
+ 404: "Commodity not found"
1049
+ }
1050
+ });
1051
+ }
1052
+ /**
1053
+ * Ensure commodity exists
1054
+ * Gets existing commodity or creates it with automatic initialization from OpenBB
1055
+ * @param data The data for the request.
1056
+ * @param data.symbol Commodity symbol
1057
+ * @param data.region Region code for tenant context
1058
+ * @returns CommodityResponseDto Commodity retrieved or created
1059
+ * @throws ApiError
1060
+ */
1061
+ static commodityControllerGetOrCreate(data) {
1062
+ return request(OpenAPI, {
1063
+ method: "POST",
1064
+ url: "/api/v1/{region}/bean/commodities/{symbol}/ensure",
1065
+ path: {
1066
+ symbol: data.symbol,
1067
+ region: data.region
1068
+ }
1069
+ });
1070
+ }
1071
+ /**
1072
+ * Bulk create commodities
1073
+ * Creates multiple commodities from a list of symbols, useful for initialization
1074
+ * @param data The data for the request.
1075
+ * @param data.region Region code for tenant context
1076
+ * @returns CommodityResponseDto Commodities created successfully
1077
+ * @throws ApiError
1078
+ */
1079
+ static commodityControllerBulkCreate(data) {
1080
+ return request(OpenAPI, {
1081
+ method: "POST",
1082
+ url: "/api/v1/{region}/bean/commodities/bulk",
1083
+ path: {
1084
+ region: data.region
1085
+ }
1086
+ });
1087
+ }
1088
+ };
1089
+ var ProviderSyncService = class {
1090
+ /**
1091
+ * Sync transactions from financial data provider
1092
+ *
1093
+ * Accepts raw transactions from external financial data providers, transforms them to Beancount format, and processes them through the ingestion pipeline.
1094
+ *
1095
+ * **Supported Providers:**
1096
+ * - **plaid**: Plaid API (US, Canada, Europe)
1097
+ * - **teller**: Teller API (US)
1098
+ * - **truelayer**: TrueLayer Open Banking (UK, Europe)
1099
+ * - **gocardless**: GoCardless Bank Account Data (Europe)
1100
+ * - **simplefin**: SimpleFIN (Self-hosted)
1101
+ * - **yodlee**: Yodlee (Global)
1102
+ * - **beancount-direct**: Beancount format transactions
1103
+ * - **parsed-bill**: Client-side parsed bill transactions
1104
+ *
1105
+ * **Processing Flow:**
1106
+ * 1. Transform raw data via provider adapter
1107
+ * 2. Validate transaction format
1108
+ * 3. Deduplicate using originalId
1109
+ * 4. Classify using rule engine
1110
+ * 5. Route low-confidence to Review Center
1111
+ * 6. Persist validated transactions
1112
+ *
1113
+ * @param data The data for the request.
1114
+ * @param data.providerName Provider name
1115
+ * @param data.region Region code for tenant context
1116
+ * @param data.requestBody
1117
+ * @returns ProviderSyncResponseDto Sync completed successfully
1118
+ * @throws ApiError
1119
+ */
1120
+ static providerSyncControllerSync(data) {
1121
+ return request(OpenAPI, {
1122
+ method: "POST",
1123
+ url: "/api/v1/{region}/bean/import/provider/{providerName}/sync",
1124
+ path: {
1125
+ providerName: data.providerName,
1126
+ region: data.region
1127
+ },
1128
+ body: data.requestBody,
1129
+ mediaType: "application/json",
1130
+ errors: {
1131
+ 400: "Invalid request data",
1132
+ 401: "Missing or invalid authentication",
1133
+ 404: "Provider not supported"
1134
+ }
1135
+ });
1136
+ }
1137
+ /**
1138
+ * Get supported providers
1139
+ * Returns a list of all providers supported by the sync endpoint.
1140
+ * @param data The data for the request.
1141
+ * @param data.region Region code for tenant context
1142
+ * @returns SupportedProvidersResponseDto List of supported providers
1143
+ * @throws ApiError
1144
+ */
1145
+ static providerSyncControllerGetSupportedProviders(data) {
1146
+ return request(OpenAPI, {
1147
+ method: "GET",
1148
+ url: "/api/v1/{region}/bean/import/provider/supported",
1149
+ path: {
1150
+ region: data.region
1151
+ },
1152
+ errors: {
1153
+ 401: "Missing or invalid authentication"
1154
+ }
1155
+ });
1156
+ }
1157
+ /**
1158
+ * Check if provider is supported
1159
+ * Returns whether a specific provider is supported.
1160
+ * @param data The data for the request.
1161
+ * @param data.providerName Provider name to check
1162
+ * @param data.region Region code for tenant context
1163
+ * @returns unknown Provider support status
1164
+ * @throws ApiError
1165
+ */
1166
+ static providerSyncControllerIsProviderSupported(data) {
1167
+ return request(OpenAPI, {
1168
+ method: "GET",
1169
+ url: "/api/v1/{region}/bean/import/provider/{providerName}/supported",
1170
+ path: {
1171
+ providerName: data.providerName,
1172
+ region: data.region
1173
+ },
1174
+ errors: {
1175
+ 401: "Missing or invalid authentication"
1176
+ }
1177
+ });
1178
+ }
1179
+ };
1180
+ var HealthService = class {
1181
+ /**
1182
+ * Basic health check for K8s/load balancer probes
1183
+ * @returns unknown Service is healthy
1184
+ * @throws ApiError
1185
+ */
1186
+ static healthControllerGetHealth() {
1187
+ return request(OpenAPI, {
1188
+ method: "GET",
1189
+ url: "/api/v1/health",
1190
+ errors: {
1191
+ 503: "Service unavailable"
1192
+ }
1193
+ });
1194
+ }
1195
+ /**
1196
+ * Check database connection health
1197
+ * @returns unknown Database is healthy
1198
+ * @throws ApiError
1199
+ */
1200
+ static healthControllerCheckDatabase() {
1201
+ return request(OpenAPI, {
1202
+ method: "GET",
1203
+ url: "/api/v1/health/database",
1204
+ errors: {
1205
+ 503: "Database unavailable"
1206
+ }
1207
+ });
1208
+ }
1209
+ /**
1210
+ * Check OpenBB schema status
1211
+ * @returns unknown OpenBB status
1212
+ * @throws ApiError
1213
+ */
1214
+ static healthControllerCheckOpenBb() {
1215
+ return request(OpenAPI, {
1216
+ method: "GET",
1217
+ url: "/api/v1/health/openbb",
1218
+ errors: {
1219
+ 503: "OpenBB unavailable"
1220
+ }
1221
+ });
1222
+ }
1223
+ /**
1224
+ * Check Redis connection health
1225
+ * @returns unknown Redis is healthy
1226
+ * @throws ApiError
1227
+ */
1228
+ static healthControllerCheckRedis() {
1229
+ return request(OpenAPI, {
1230
+ method: "GET",
1231
+ url: "/api/v1/health/redis",
1232
+ errors: {
1233
+ 503: "Redis unavailable"
1234
+ }
1235
+ });
1236
+ }
1237
+ /**
1238
+ * Get status of all circuit breakers
1239
+ * @returns unknown Circuit breaker status
1240
+ * @throws ApiError
1241
+ */
1242
+ static healthControllerGetCircuitBreakersHealth() {
1243
+ return request(OpenAPI, {
1244
+ method: "GET",
1245
+ url: "/api/v1/health/circuit-breakers",
1246
+ errors: {
1247
+ 401: "Unauthorized",
1248
+ 500: "Internal error"
1249
+ }
1250
+ });
1251
+ }
1252
+ /**
1253
+ * Reset a circuit breaker to CLOSED state
1254
+ * @param data The data for the request.
1255
+ * @param data.name Circuit breaker name to reset
1256
+ * @returns unknown Circuit breaker reset successfully
1257
+ * @throws ApiError
1258
+ */
1259
+ static healthControllerResetCircuitBreaker(data) {
1260
+ return request(OpenAPI, {
1261
+ method: "POST",
1262
+ url: "/api/v1/health/circuit-breakers/{name}/reset",
1263
+ path: {
1264
+ name: data.name
1265
+ },
1266
+ errors: {
1267
+ 401: "Unauthorized",
1268
+ 404: "Circuit breaker not found"
1269
+ }
1270
+ });
1271
+ }
1272
+ /**
1273
+ * Get health check metrics and statistics
1274
+ * @returns unknown Health metrics
1275
+ * @throws ApiError
1276
+ */
1277
+ static healthControllerGetMetrics() {
1278
+ return request(OpenAPI, {
1279
+ method: "GET",
1280
+ url: "/api/v1/health/metrics",
1281
+ errors: {
1282
+ 401: "Unauthorized"
1283
+ }
1284
+ });
1285
+ }
1286
+ };
1287
+ // Annotate the CommonJS export names for ESM import in node:
1288
+ 0 && (module.exports = {
1289
+ BeanAccountsService,
1290
+ BeanBalancesService,
1291
+ BeanCommoditiesService,
1292
+ BeanTransactionsService,
1293
+ HealthService,
1294
+ OpenAPI,
1295
+ ProviderSyncService
1296
+ });