@firela/api-types 0.0.0-canary.0327ab9e

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