@firela/api-types 0.0.0-canary.ed674c1 → 0.0.0-canary.efbd2b9a

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.
Files changed (44) hide show
  1. package/dist/index.d.mts +8251 -0
  2. package/dist/index.d.ts +8251 -2
  3. package/dist/index.js +1268 -3
  4. package/dist/index.mjs +1235 -0
  5. package/package.json +25 -12
  6. package/src/generated/core/ApiError.ts +25 -0
  7. package/src/generated/core/ApiRequestOptions.ts +20 -0
  8. package/src/generated/core/ApiResult.ts +7 -0
  9. package/src/generated/core/CancelablePromise.ts +126 -0
  10. package/src/generated/core/OpenAPI.ts +56 -0
  11. package/src/generated/core/request.ts +391 -0
  12. package/{dist/generated/index.d.ts → src/generated/index.ts} +2 -1
  13. package/src/generated/schemas.gen.ts +7106 -0
  14. package/src/generated/services.gen.ts +3633 -0
  15. package/src/generated/types.gen.ts +8714 -0
  16. package/src/index.ts +12 -0
  17. package/README.md +0 -40
  18. package/dist/generated/core/ApiError.d.ts +0 -11
  19. package/dist/generated/core/ApiError.d.ts.map +0 -1
  20. package/dist/generated/core/ApiError.js +0 -11
  21. package/dist/generated/core/ApiRequestOptions.d.ts +0 -14
  22. package/dist/generated/core/ApiRequestOptions.d.ts.map +0 -1
  23. package/dist/generated/core/ApiRequestOptions.js +0 -1
  24. package/dist/generated/core/ApiResult.d.ts +0 -8
  25. package/dist/generated/core/ApiResult.d.ts.map +0 -1
  26. package/dist/generated/core/ApiResult.js +0 -1
  27. package/dist/generated/core/CancelablePromise.d.ts +0 -27
  28. package/dist/generated/core/CancelablePromise.d.ts.map +0 -1
  29. package/dist/generated/core/CancelablePromise.js +0 -88
  30. package/dist/generated/core/OpenAPI.d.ts +0 -28
  31. package/dist/generated/core/OpenAPI.d.ts.map +0 -1
  32. package/dist/generated/core/OpenAPI.js +0 -29
  33. package/dist/generated/core/request.d.ts +0 -30
  34. package/dist/generated/core/request.d.ts.map +0 -1
  35. package/dist/generated/core/request.js +0 -297
  36. package/dist/generated/index.d.ts.map +0 -1
  37. package/dist/generated/index.js +0 -6
  38. package/dist/generated/services.gen.d.ts +0 -11
  39. package/dist/generated/services.gen.d.ts.map +0 -1
  40. package/dist/generated/services.gen.js +0 -16
  41. package/dist/generated/types.gen.d.ts +0 -18
  42. package/dist/generated/types.gen.d.ts.map +0 -1
  43. package/dist/generated/types.gen.js +0 -2
  44. package/dist/index.d.ts.map +0 -1
package/dist/index.mjs ADDED
@@ -0,0 +1,1235 @@
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
+ * Correct (supersede) a transaction
693
+ * Atomically voids the original (SUPERSEDED) and creates a replacement through the full validation pipeline.
694
+ * @param data The data for the request.
695
+ * @param data.id Original transaction ID to correct
696
+ * @param data.region Region code for tenant context
697
+ * @param data.requestBody
698
+ * @returns TransactionDetailDto Corrected transaction created
699
+ * @throws ApiError
700
+ */
701
+ static transactionControllerCorrect(data) {
702
+ return request(OpenAPI, {
703
+ method: "POST",
704
+ url: "/api/v1/{region}/bean/transactions/{id}/correct",
705
+ path: {
706
+ id: data.id,
707
+ region: data.region
708
+ },
709
+ body: data.requestBody,
710
+ mediaType: "application/json",
711
+ errors: {
712
+ 404: "Original transaction not found",
713
+ 409: "Original no longer ACTIVE (concurrent modification)",
714
+ 422: "Pipeline validation failed (does not balance, invalid accounts)"
715
+ }
716
+ });
717
+ }
718
+ /**
719
+ * Suggest transaction tags
720
+ * Returns distinct tags from the user ACTIVE transactions, sorted by usage, for autocomplete. Optional q performs a case-insensitive prefix match.
721
+ * @param data The data for the request.
722
+ * @param data.region Region code for tenant context
723
+ * @param data.q Prefix match, case-insensitive (max 50 chars)
724
+ * @param data.sort usage (default) or name
725
+ * @param data.limit Max suggestions (1-100, default 10)
726
+ * @returns TagSuggestionsResponseDto Tag suggestions
727
+ * @throws ApiError
728
+ */
729
+ static transactionControllerSuggestTags(data) {
730
+ return request(OpenAPI, {
731
+ method: "GET",
732
+ url: "/api/v1/{region}/bean/transactions/tags",
733
+ path: {
734
+ region: data.region
735
+ },
736
+ query: {
737
+ q: data.q,
738
+ sort: data.sort,
739
+ limit: data.limit
740
+ },
741
+ errors: {
742
+ 400: "Validation failed",
743
+ 401: "Authentication required"
744
+ }
745
+ });
746
+ }
747
+ /**
748
+ * Get transaction detail
749
+ * Returns transaction details including all postings
750
+ * @param data The data for the request.
751
+ * @param data.id Transaction ID
752
+ * @param data.region Region code for tenant context
753
+ * @returns TransactionDetailDto Transaction detail
754
+ * @throws ApiError
755
+ */
756
+ static transactionControllerGetDetail(data) {
757
+ return request(OpenAPI, {
758
+ method: "GET",
759
+ url: "/api/v1/{region}/bean/transactions/{id}",
760
+ path: {
761
+ id: data.id,
762
+ region: data.region
763
+ },
764
+ errors: {
765
+ 401: "Authentication required",
766
+ 404: "Transaction not found"
767
+ }
768
+ });
769
+ }
770
+ /**
771
+ * Update transaction metadata
772
+ * Updates transaction metadata (flag, payee, narration, tags, links, meta). Postings cannot be modified.
773
+ * @param data The data for the request.
774
+ * @param data.id Transaction ID
775
+ * @param data.region Region code for tenant context
776
+ * @param data.requestBody Fields to update (all optional)
777
+ * @returns TransactionDetailDto Transaction updated successfully
778
+ * @throws ApiError
779
+ */
780
+ static transactionControllerUpdate(data) {
781
+ return request(OpenAPI, {
782
+ method: "PATCH",
783
+ url: "/api/v1/{region}/bean/transactions/{id}",
784
+ path: {
785
+ id: data.id,
786
+ region: data.region
787
+ },
788
+ body: data.requestBody,
789
+ mediaType: "application/json",
790
+ errors: {
791
+ 400: "Cannot update voided transaction",
792
+ 401: "Authentication required",
793
+ 404: "Transaction not found"
794
+ }
795
+ });
796
+ }
797
+ /**
798
+ * Void transaction
799
+ * Soft-deletes a transaction by marking it as VOIDED
800
+ * @param data The data for the request.
801
+ * @param data.id Transaction ID
802
+ * @param data.region Region code for tenant context
803
+ * @returns void Transaction voided successfully
804
+ * @throws ApiError
805
+ */
806
+ static transactionControllerDelete(data) {
807
+ return request(OpenAPI, {
808
+ method: "DELETE",
809
+ url: "/api/v1/{region}/bean/transactions/{id}",
810
+ path: {
811
+ id: data.id,
812
+ region: data.region
813
+ },
814
+ errors: {
815
+ 400: "Transaction already voided",
816
+ 401: "Authentication required",
817
+ 404: "Transaction not found"
818
+ }
819
+ });
820
+ }
821
+ };
822
+ var BeanBalancesService = class {
823
+ /**
824
+ * Query account balance
825
+ * Calculate account balance at a specific date for a single currency
826
+ * @param data The data for the request.
827
+ * @param data.account Account name (e.g., "Assets:Bank:Checking")
828
+ * @param data.region Region code for tenant context
829
+ * @param data.date Date to calculate balance at (ISO 8601 format)
830
+ * @param data.currency Currency to query (e.g., "USD", "CNY")
831
+ * @returns BalanceResponseDto Balance calculated successfully
832
+ * @throws ApiError
833
+ */
834
+ static balanceControllerGetBalance(data) {
835
+ return request(OpenAPI, {
836
+ method: "GET",
837
+ url: "/api/v1/{region}/bean/balances",
838
+ path: {
839
+ region: data.region
840
+ },
841
+ query: {
842
+ account: data.account,
843
+ date: data.date,
844
+ currency: data.currency
845
+ },
846
+ errors: {
847
+ 400: "Invalid query parameters",
848
+ 401: "User not authenticated"
849
+ }
850
+ });
851
+ }
852
+ /**
853
+ * Query multi-currency account balance
854
+ * Calculate account balances for all currencies at a specific date
855
+ * @param data The data for the request.
856
+ * @param data.region Region code for tenant context
857
+ * @returns MultiCurrencyBalanceResponseDto Balances calculated successfully
858
+ * @throws ApiError
859
+ */
860
+ static balanceControllerGetMultiCurrencyBalance(data) {
861
+ return request(OpenAPI, {
862
+ method: "GET",
863
+ url: "/api/v1/{region}/bean/balances/multi-currency",
864
+ path: {
865
+ region: data.region
866
+ },
867
+ errors: {
868
+ 400: "Invalid query parameters",
869
+ 401: "User not authenticated"
870
+ }
871
+ });
872
+ }
873
+ };
874
+ var BeanCommoditiesService = class {
875
+ /**
876
+ * Create a new commodity
877
+ * Creates a new commodity definition for the authenticated user
878
+ * @param data The data for the request.
879
+ * @param data.region Region code for tenant context
880
+ * @param data.requestBody
881
+ * @returns CommodityResponseDto Commodity created successfully
882
+ * @throws ApiError
883
+ */
884
+ static commodityControllerCreate(data) {
885
+ return request(OpenAPI, {
886
+ method: "POST",
887
+ url: "/api/v1/{region}/bean/commodities",
888
+ path: {
889
+ region: data.region
890
+ },
891
+ body: data.requestBody,
892
+ mediaType: "application/json",
893
+ errors: {
894
+ 400: "Invalid input data",
895
+ 409: "Commodity already exists"
896
+ }
897
+ });
898
+ }
899
+ /**
900
+ * List user commodities
901
+ * Returns all commodity definitions for the authenticated user with optional filtering
902
+ * @param data The data for the request.
903
+ * @param data.region Region code for tenant context
904
+ * @param data.search Search term for symbol or metadata fields (partial match). Searches symbol and metadata.name.
905
+ * @param data.symbol Filter by exact symbol match
906
+ * @returns CommodityListResponseDto Commodities retrieved successfully
907
+ * @throws ApiError
908
+ */
909
+ static commodityControllerFindAll(data) {
910
+ return request(OpenAPI, {
911
+ method: "GET",
912
+ url: "/api/v1/{region}/bean/commodities",
913
+ path: {
914
+ region: data.region
915
+ },
916
+ query: {
917
+ search: data.search,
918
+ symbol: data.symbol
919
+ }
920
+ });
921
+ }
922
+ /**
923
+ * Get commodity by symbol
924
+ * Returns a specific commodity definition by its symbol
925
+ * @param data The data for the request.
926
+ * @param data.symbol Commodity symbol
927
+ * @param data.region Region code for tenant context
928
+ * @returns CommodityResponseDto Commodity retrieved successfully
929
+ * @throws ApiError
930
+ */
931
+ static commodityControllerFindOne(data) {
932
+ return request(OpenAPI, {
933
+ method: "GET",
934
+ url: "/api/v1/{region}/bean/commodities/{symbol}",
935
+ path: {
936
+ symbol: data.symbol,
937
+ region: data.region
938
+ },
939
+ errors: {
940
+ 404: "Commodity not found"
941
+ }
942
+ });
943
+ }
944
+ /**
945
+ * Update commodity
946
+ * Updates an existing commodity definition. Symbol cannot be changed.
947
+ * @param data The data for the request.
948
+ * @param data.symbol Commodity symbol
949
+ * @param data.region Region code for tenant context
950
+ * @param data.requestBody
951
+ * @returns CommodityResponseDto Commodity updated successfully
952
+ * @throws ApiError
953
+ */
954
+ static commodityControllerUpdate(data) {
955
+ return request(OpenAPI, {
956
+ method: "PUT",
957
+ url: "/api/v1/{region}/bean/commodities/{symbol}",
958
+ path: {
959
+ symbol: data.symbol,
960
+ region: data.region
961
+ },
962
+ body: data.requestBody,
963
+ mediaType: "application/json",
964
+ errors: {
965
+ 400: "Invalid input data",
966
+ 404: "Commodity not found"
967
+ }
968
+ });
969
+ }
970
+ /**
971
+ * Delete commodity
972
+ * Deletes a commodity definition
973
+ * @param data The data for the request.
974
+ * @param data.symbol Commodity symbol
975
+ * @param data.region Region code for tenant context
976
+ * @returns void Commodity deleted successfully
977
+ * @throws ApiError
978
+ */
979
+ static commodityControllerDelete(data) {
980
+ return request(OpenAPI, {
981
+ method: "DELETE",
982
+ url: "/api/v1/{region}/bean/commodities/{symbol}",
983
+ path: {
984
+ symbol: data.symbol,
985
+ region: data.region
986
+ },
987
+ errors: {
988
+ 404: "Commodity not found"
989
+ }
990
+ });
991
+ }
992
+ /**
993
+ * Ensure commodity exists
994
+ * Gets existing commodity or creates it with automatic initialization from OpenBB
995
+ * @param data The data for the request.
996
+ * @param data.symbol Commodity symbol
997
+ * @param data.region Region code for tenant context
998
+ * @returns CommodityResponseDto Commodity retrieved or created
999
+ * @throws ApiError
1000
+ */
1001
+ static commodityControllerGetOrCreate(data) {
1002
+ return request(OpenAPI, {
1003
+ method: "POST",
1004
+ url: "/api/v1/{region}/bean/commodities/{symbol}/ensure",
1005
+ path: {
1006
+ symbol: data.symbol,
1007
+ region: data.region
1008
+ }
1009
+ });
1010
+ }
1011
+ /**
1012
+ * Bulk create commodities
1013
+ * Creates multiple commodities from a list of symbols, useful for initialization
1014
+ * @param data The data for the request.
1015
+ * @param data.region Region code for tenant context
1016
+ * @returns CommodityResponseDto Commodities created successfully
1017
+ * @throws ApiError
1018
+ */
1019
+ static commodityControllerBulkCreate(data) {
1020
+ return request(OpenAPI, {
1021
+ method: "POST",
1022
+ url: "/api/v1/{region}/bean/commodities/bulk",
1023
+ path: {
1024
+ region: data.region
1025
+ }
1026
+ });
1027
+ }
1028
+ };
1029
+ var ProviderSyncService = class {
1030
+ /**
1031
+ * Sync transactions from financial data provider
1032
+ *
1033
+ * Accepts raw transactions from external financial data providers, transforms them to Beancount format, and processes them through the ingestion pipeline.
1034
+ *
1035
+ * **Supported Providers:**
1036
+ * - **plaid**: Plaid API (US, Canada, Europe)
1037
+ * - **teller**: Teller API (US)
1038
+ * - **truelayer**: TrueLayer Open Banking (UK, Europe)
1039
+ * - **gocardless**: GoCardless Bank Account Data (Europe)
1040
+ * - **simplefin**: SimpleFIN (Self-hosted)
1041
+ * - **yodlee**: Yodlee (Global)
1042
+ * - **beancount-direct**: Beancount format transactions
1043
+ * - **parsed-bill**: Client-side parsed bill transactions
1044
+ *
1045
+ * **Processing Flow:**
1046
+ * 1. Transform raw data via provider adapter
1047
+ * 2. Validate transaction format
1048
+ * 3. Deduplicate using originalId
1049
+ * 4. Classify using rule engine
1050
+ * 5. Route low-confidence to Review Center
1051
+ * 6. Persist validated transactions
1052
+ *
1053
+ * @param data The data for the request.
1054
+ * @param data.providerName Provider name
1055
+ * @param data.region Region code for tenant context
1056
+ * @param data.requestBody
1057
+ * @returns ProviderSyncResponseDto Sync completed successfully
1058
+ * @throws ApiError
1059
+ */
1060
+ static providerSyncControllerSync(data) {
1061
+ return request(OpenAPI, {
1062
+ method: "POST",
1063
+ url: "/api/v1/{region}/bean/import/provider/{providerName}/sync",
1064
+ path: {
1065
+ providerName: data.providerName,
1066
+ region: data.region
1067
+ },
1068
+ body: data.requestBody,
1069
+ mediaType: "application/json",
1070
+ errors: {
1071
+ 400: "Invalid request data",
1072
+ 401: "Missing or invalid authentication",
1073
+ 404: "Provider not supported"
1074
+ }
1075
+ });
1076
+ }
1077
+ /**
1078
+ * Get supported providers
1079
+ * Returns a list of all providers supported by the sync endpoint.
1080
+ * @param data The data for the request.
1081
+ * @param data.region Region code for tenant context
1082
+ * @returns SupportedProvidersResponseDto List of supported providers
1083
+ * @throws ApiError
1084
+ */
1085
+ static providerSyncControllerGetSupportedProviders(data) {
1086
+ return request(OpenAPI, {
1087
+ method: "GET",
1088
+ url: "/api/v1/{region}/bean/import/provider/supported",
1089
+ path: {
1090
+ region: data.region
1091
+ },
1092
+ errors: {
1093
+ 401: "Missing or invalid authentication"
1094
+ }
1095
+ });
1096
+ }
1097
+ /**
1098
+ * Check if provider is supported
1099
+ * Returns whether a specific provider is supported.
1100
+ * @param data The data for the request.
1101
+ * @param data.providerName Provider name to check
1102
+ * @param data.region Region code for tenant context
1103
+ * @returns unknown Provider support status
1104
+ * @throws ApiError
1105
+ */
1106
+ static providerSyncControllerIsProviderSupported(data) {
1107
+ return request(OpenAPI, {
1108
+ method: "GET",
1109
+ url: "/api/v1/{region}/bean/import/provider/{providerName}/supported",
1110
+ path: {
1111
+ providerName: data.providerName,
1112
+ region: data.region
1113
+ },
1114
+ errors: {
1115
+ 401: "Missing or invalid authentication"
1116
+ }
1117
+ });
1118
+ }
1119
+ };
1120
+ var HealthService = class {
1121
+ /**
1122
+ * Basic health check for K8s/load balancer probes
1123
+ * @returns unknown Service is healthy
1124
+ * @throws ApiError
1125
+ */
1126
+ static healthControllerGetHealth() {
1127
+ return request(OpenAPI, {
1128
+ method: "GET",
1129
+ url: "/api/v1/health",
1130
+ errors: {
1131
+ 503: "Service unavailable"
1132
+ }
1133
+ });
1134
+ }
1135
+ /**
1136
+ * Check database connection health
1137
+ * @returns unknown Database is healthy
1138
+ * @throws ApiError
1139
+ */
1140
+ static healthControllerCheckDatabase() {
1141
+ return request(OpenAPI, {
1142
+ method: "GET",
1143
+ url: "/api/v1/health/database",
1144
+ errors: {
1145
+ 503: "Database unavailable"
1146
+ }
1147
+ });
1148
+ }
1149
+ /**
1150
+ * Check OpenBB schema status
1151
+ * @returns unknown OpenBB status
1152
+ * @throws ApiError
1153
+ */
1154
+ static healthControllerCheckOpenBb() {
1155
+ return request(OpenAPI, {
1156
+ method: "GET",
1157
+ url: "/api/v1/health/openbb",
1158
+ errors: {
1159
+ 503: "OpenBB unavailable"
1160
+ }
1161
+ });
1162
+ }
1163
+ /**
1164
+ * Check Redis connection health
1165
+ * @returns unknown Redis is healthy
1166
+ * @throws ApiError
1167
+ */
1168
+ static healthControllerCheckRedis() {
1169
+ return request(OpenAPI, {
1170
+ method: "GET",
1171
+ url: "/api/v1/health/redis",
1172
+ errors: {
1173
+ 503: "Redis unavailable"
1174
+ }
1175
+ });
1176
+ }
1177
+ /**
1178
+ * Get status of all circuit breakers
1179
+ * @returns unknown Circuit breaker status
1180
+ * @throws ApiError
1181
+ */
1182
+ static healthControllerGetCircuitBreakersHealth() {
1183
+ return request(OpenAPI, {
1184
+ method: "GET",
1185
+ url: "/api/v1/health/circuit-breakers",
1186
+ errors: {
1187
+ 401: "Unauthorized",
1188
+ 500: "Internal error"
1189
+ }
1190
+ });
1191
+ }
1192
+ /**
1193
+ * Reset a circuit breaker to CLOSED state
1194
+ * @param data The data for the request.
1195
+ * @param data.name Circuit breaker name to reset
1196
+ * @returns unknown Circuit breaker reset successfully
1197
+ * @throws ApiError
1198
+ */
1199
+ static healthControllerResetCircuitBreaker(data) {
1200
+ return request(OpenAPI, {
1201
+ method: "POST",
1202
+ url: "/api/v1/health/circuit-breakers/{name}/reset",
1203
+ path: {
1204
+ name: data.name
1205
+ },
1206
+ errors: {
1207
+ 401: "Unauthorized",
1208
+ 404: "Circuit breaker not found"
1209
+ }
1210
+ });
1211
+ }
1212
+ /**
1213
+ * Get health check metrics and statistics
1214
+ * @returns unknown Health metrics
1215
+ * @throws ApiError
1216
+ */
1217
+ static healthControllerGetMetrics() {
1218
+ return request(OpenAPI, {
1219
+ method: "GET",
1220
+ url: "/api/v1/health/metrics",
1221
+ errors: {
1222
+ 401: "Unauthorized"
1223
+ }
1224
+ });
1225
+ }
1226
+ };
1227
+ export {
1228
+ BeanAccountsService,
1229
+ BeanBalancesService,
1230
+ BeanCommoditiesService,
1231
+ BeanTransactionsService,
1232
+ HealthService,
1233
+ OpenAPI,
1234
+ ProviderSyncService
1235
+ };