@jars-lt/jars-app-sdk 0.1.0 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # @jars-lt/jars-app-sdk
 
-Official TypeScript SDK for the [JARS Apskaita](https://app.jars.lt) accounting API — Lithuanian cloud accounting for partners, products, invoices, journal entries, and reports.
+Official TypeScript SDK for the [JARS Apskaita](https://app.jars.lt) accounting API — Lithuanian cloud accounting. Covers partners, products, invoices, journal entries and reports, plus cash registers & orders, bank transactions & statements, fixed assets & depreciation, employees & payroll, business trips, price lists, projects, professions, per-diem rates, numberings, exchange rates, and batch sales-receipt ingest from external POS/ERP systems.
 
 ## Install
 
@@ -71,11 +71,27 @@ Every resource is reachable as a property on the client (`jars.partners`, `jars.
 | ----------------- | ------------------------------------------------------------------------------------------------------------ |
 | `jars.partners`   | `list` · `get` · `create` · `update` · `remove`                                                              |
 | `jars.products`   | `list` · `get` · `create` · `update` · `remove`                                                              |
-| `jars.invoices`   | `list` · `get` · `create` · `update` · `remove` · `post` · `unpost` · `cancel` · `setExternalStatus`          |
+| `jars.invoices`   | `list` · `get` · `create` · `update` · `remove` · `post` · `unpost` · `cancel` · `setExternalStatus` · `postingPreview` |
 | `jars.journal`    | `list` · `get` · `create`                                                                                     |
-| `jars.reports`    | `trialBalance` · `generalLedger` · `partnerBalance` · `cashBook` · `isafExport`                               |
+| `jars.reports`    | `trialBalance` · `generalLedger` · `accountAnalytics` · `partnerBalance` · `employeeBalance` · `cashBook` · `financialStatements` · `isafExport` |
 | `jars.auditLogs`  | `list` · `get`                                                                                                |
 | `jars.lookups`    | `accounts` · `vatCodes` · `units` · `templates` (list-only)                                                   |
+| `jars.cashRegisters` | `list` · `create` · `update` · `remove`                                                                    |
+| `jars.cashOrders` | `list` · `get` · `create` · `update` · `remove` · `post` · `unpost` · `fiscalize` · `setExternalStatus`        |
+| `jars.bankTransactions` | `list` · `get` · `create` · `update` · `setAllocations` · `post` · `unpost` · `setExternalStatus`        |
+| `jars.bankStatements` | `list` · `remove` · `detect` · `import` (file upload)                                                      |
+| `jars.fixedAssets` | `list` · `get` · `create` · `update` · `remove` · `dispose`                                                  |
+| `jars.depreciation` | `list` · `preview` · `post` · `unpost`                                                                      |
+| `jars.employees`  | `list` · `get` · `create` · `update` · `remove` · `nextCode` · `verifyPin`                                    |
+| `jars.payroll`    | `list` · `preview` · `post` · `unpost`                                                                        |
+| `jars.businessTrips` | `list` · `create` · `update` · `remove` · `postAdvance` · `postSettlement` · `unpost`                      |
+| `jars.priceLists` | `list` · `get` · `create` · `update` · `remove`                                                              |
+| `jars.projects`   | `list` · `get` · `create` · `update` · `remove`                                                              |
+| `jars.professions` | `list` · `get` · `create` · `update` · `remove`                                                              |
+| `jars.perDiemRates` | `list` · `create` · `update` · `remove`                                                                     |
+| `jars.numberings` | `list` · `update` (by prefix)                                                                                 |
+| `jars.exchangeRates` | `list` (read-only euro FX rates)                                                                           |
+| `jars.salesReceipts` | `ingest` (batch, external POS/ERP sales → CashOrder RECEIPT)                                                |
 
 ### Method signatures
 
@@ -98,6 +114,18 @@ setExternalStatus<T = unknown>(id: string, externalStatus: string | null): Promi
 trialBalance<T = unknown>(params?: ReportParams): Promise<T>
 // lookups: list-only, e.g.
 accounts<T = unknown[]>(params?: ListParams): Promise<T>
+
+// document-lifecycle actions (cashOrders, bankTransactions, businessTrips, …)
+post<T = unknown>(id: string): Promise<T>
+unpost<T = unknown>(id: string): Promise<T>
+// batch runs (payroll, depreciation)
+preview<T = unknown>(body: Record<string, unknown>): Promise<T>
+post<T = unknown>(body: Record<string, unknown>): Promise<T>
+// bankStatements: multipart file upload (Blob/File)
+detect<T = unknown>(file: Blob | File, filename?: string): Promise<T>
+import<T = unknown>(file: Blob | File, fields?: Record<string, string>, filename?: string): Promise<T>
+// salesReceipts: batch ingest, one result per item (positional with `items`)
+ingest<T = unknown>(items: Record<string, unknown>[]): Promise<T>
 ```
 
 ### Not in the facade yet

package/dist/index.cjs

@@ -31,15 +31,31 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuditLogsResource: () => AuditLogsResource,
+  BankStatementsResource: () => BankStatementsResource,
+  BankTransactionsResource: () => BankTransactionsResource,
+  BusinessTripsResource: () => BusinessTripsResource,
+  CashOrdersResource: () => CashOrdersResource,
+  CashRegistersResource: () => CashRegistersResource,
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  DepreciationResource: () => DepreciationResource,
+  EmployeesResource: () => EmployeesResource,
+  ExchangeRatesResource: () => ExchangeRatesResource,
+  FixedAssetsResource: () => FixedAssetsResource,
   InvoicesResource: () => InvoicesResource,
   JarsApiError: () => JarsApiError,
   JarsClient: () => JarsClient,
   JournalResource: () => JournalResource,
   LookupsResource: () => LookupsResource,
+  NumberingsResource: () => NumberingsResource,
   PartnersResource: () => PartnersResource,
+  PayrollResource: () => PayrollResource,
+  PerDiemRatesResource: () => PerDiemRatesResource,
+  PriceListsResource: () => PriceListsResource,
   ProductsResource: () => ProductsResource,
-  ReportsResource: () => ReportsResource
+  ProfessionsResource: () => ProfessionsResource,
+  ProjectsResource: () => ProjectsResource,
+  ReportsResource: () => ReportsResource,
+  SalesReceiptsResource: () => SalesReceiptsResource
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -145,6 +161,9 @@ var InvoicesResource = class {
       body: { externalStatus }
     });
   }
+  postingPreview(id) {
+    return this.client.request("get", "/api/invoices/{id}/posting-preview", { params: { id } });
+  }
 };
 
 // src/resources/journal.ts
@@ -171,15 +190,50 @@ var ReportsResource = class {
   trialBalance(params) {
     return this.client.request("get", "/api/reports/trial-balance", { query: params });
   }
+  /**
+   * Chronological postings for one account. `from` and `to` are required;
+   * `account` is optional but omitting it asks for every account.
+   *
+   * Rejects with 400 `REPORT_TOO_BROAD` when the query would return more than
+   * 10,000 lines — the result is never truncated, because the caller computes a
+   * running balance across these lines. Narrow by account or by period.
+   */
   generalLedger(params) {
     return this.client.request("get", "/api/reports/general-ledger", { query: params });
   }
+  accountAnalytics(params) {
+    return this.client.request("get", "/api/reports/account-analytics", { query: params });
+  }
+  /**
+   * Settlement balances per partner.
+   *
+   * Returns `{ rows, totals, rowCount, unfilteredRowCount, truncated }`.
+   * `totals` are computed over the full set — before the `nonZeroOnly` filter
+   * and before the row cap — so they tie out whatever `rows` contains.
+   *
+   * `nonZeroOnly` defaults to true: rows whose closing balance is zero are
+   * omitted. Pass `nonZeroOnly: false` for the complete list.
+   */
   partnerBalance(params) {
     return this.client.request("get", "/api/reports/partner-balance", { query: params });
   }
+  /** Salary/advance balances per employee. `from` and `to` are required. */
+  employeeBalance(params) {
+    return this.client.request("get", "/api/reports/employee-balance", { query: params });
+  }
+  /**
+   * Cash book for one register: opening balance plus posted cash movements.
+   *
+   * Rejects with 400 `REPORT_TOO_BROAD` above 10,000 lines, for the same reason
+   * as `generalLedger`.
+   */
   cashBook(params) {
     return this.client.request("get", "/api/reports/cash-book", { query: params });
   }
+  /** Balance sheet + P&L. `year` is required; pass `to` for an interim period. */
+  financialStatements(params) {
+    return this.client.request("get", "/api/reports/financial-statements", { query: params });
+  }
   isafExport(params) {
     return this.client.request("get", "/api/reports/isaf-export", { query: params });
   }
@@ -217,7 +271,368 @@ var LookupsResource = class {
   }
 };
 
+// src/resources/cash-registers.ts
+var CashRegistersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/cash-registers", { query: toQuery(params) });
+  }
+  create(body) {
+    return this.client.request("post", "/api/cash-registers", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/cash-registers/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/cash-registers/{id}", { params: { id } });
+  }
+};
+
+// src/resources/projects.ts
+var ProjectsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/projects", { query: toQuery(params) });
+  }
+  get(id) {
+    return this.client.request("get", "/api/projects/{id}", { params: { id } });
+  }
+  create(body) {
+    return this.client.request("post", "/api/projects", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/projects/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/projects/{id}", { params: { id } });
+  }
+};
+
+// src/resources/professions.ts
+var ProfessionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/professions", { query: toQuery(params) });
+  }
+  get(id) {
+    return this.client.request("get", "/api/professions/{id}", { params: { id } });
+  }
+  create(body) {
+    return this.client.request("post", "/api/professions", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/professions/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/professions/{id}", { params: { id } });
+  }
+};
+
+// src/resources/perdiem-rates.ts
+var PerDiemRatesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/perdiem-rates", { query: toQuery(params) });
+  }
+  create(body) {
+    return this.client.request("post", "/api/perdiem-rates", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/perdiem-rates/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/perdiem-rates/{id}", { params: { id } });
+  }
+};
+
+// src/resources/price-lists.ts
+var PriceListsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/price-lists", { query: toQuery(params) });
+  }
+  get(id) {
+    return this.client.request("get", "/api/price-lists/{id}", { params: { id } });
+  }
+  create(body) {
+    return this.client.request("post", "/api/price-lists", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/price-lists/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/price-lists/{id}", { params: { id } });
+  }
+};
+
+// src/resources/fixed-assets.ts
+var FixedAssetsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/fixed-assets", { query: toQuery(params) });
+  }
+  get(id) {
+    return this.client.request("get", "/api/fixed-assets/{id}", { params: { id } });
+  }
+  create(body) {
+    return this.client.request("post", "/api/fixed-assets", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/fixed-assets/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/fixed-assets/{id}", { params: { id } });
+  }
+  dispose(id, body) {
+    return this.client.request("post", "/api/fixed-assets/{id}/dispose", { params: { id }, body });
+  }
+};
+
+// src/resources/employees.ts
+var EmployeesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/employees", { query: toQuery(params) });
+  }
+  get(id) {
+    return this.client.request("get", "/api/employees/{id}", { params: { id } });
+  }
+  create(body) {
+    return this.client.request("post", "/api/employees", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/employees/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/employees/{id}", { params: { id } });
+  }
+  nextCode() {
+    return this.client.request("get", "/api/employees/next-code");
+  }
+  verifyPin(body) {
+    return this.client.request("post", "/api/employees/verify-pin", { body });
+  }
+};
+
+// src/resources/cash-orders.ts
+var CashOrdersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/cash-orders", { query: toQuery(params) });
+  }
+  get(id) {
+    return this.client.request("get", "/api/cash-orders/{id}", { params: { id } });
+  }
+  create(body) {
+    return this.client.request("post", "/api/cash-orders", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/cash-orders/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/cash-orders/{id}", { params: { id } });
+  }
+  setExternalStatus(id, body) {
+    return this.client.request("patch", "/api/cash-orders/{id}/external-status", { params: { id }, body });
+  }
+  post(id) {
+    return this.client.request("post", "/api/cash-orders/{id}/post", { params: { id } });
+  }
+  unpost(id) {
+    return this.client.request("post", "/api/cash-orders/{id}/unpost", { params: { id } });
+  }
+  fiscalize(id, body) {
+    return this.client.request("post", "/api/cash-orders/{id}/fiscalize", { params: { id }, body: body ?? {} });
+  }
+};
+
+// src/resources/bank-transactions.ts
+var BankTransactionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/bank-transactions", { query: toQuery(params) });
+  }
+  get(id) {
+    return this.client.request("get", "/api/bank-transactions/{id}", { params: { id } });
+  }
+  create(body) {
+    return this.client.request("post", "/api/bank-transactions", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/bank-transactions/{id}", { params: { id }, body });
+  }
+  /**
+   * Link the transaction to invoices (payment matching). Separate from `update`
+   * because it works at any status — `update` refuses a posted transaction,
+   * while allocations must stay editable after posting (a prepayment is posted
+   * before its invoice exists).
+   */
+  setAllocations(id, body) {
+    return this.client.request("put", "/api/bank-transactions/{id}/allocations", { params: { id }, body });
+  }
+  setExternalStatus(id, body) {
+    return this.client.request("patch", "/api/bank-transactions/{id}/external-status", { params: { id }, body });
+  }
+  post(id) {
+    return this.client.request("post", "/api/bank-transactions/{id}/post", { params: { id } });
+  }
+  unpost(id) {
+    return this.client.request("post", "/api/bank-transactions/{id}/unpost", { params: { id } });
+  }
+};
+
+// src/resources/business-trips.ts
+var BusinessTripsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/business-trips", { query: toQuery(params) });
+  }
+  create(body) {
+    return this.client.request("post", "/api/business-trips", { body });
+  }
+  update(id, body) {
+    return this.client.request("put", "/api/business-trips/{id}", { params: { id }, body });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/business-trips/{id}", { params: { id } });
+  }
+  postAdvance(id) {
+    return this.client.request("post", "/api/business-trips/{id}/post-advance", { params: { id } });
+  }
+  postSettlement(id) {
+    return this.client.request("post", "/api/business-trips/{id}/post-settlement", { params: { id } });
+  }
+  unpost(id) {
+    return this.client.request("post", "/api/business-trips/{id}/unpost", { params: { id } });
+  }
+};
+
+// src/resources/payroll.ts
+var PayrollResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/payroll", { query: toQuery(params) });
+  }
+  preview(body) {
+    return this.client.request("post", "/api/payroll/preview", { body });
+  }
+  post(body) {
+    return this.client.request("post", "/api/payroll/post", { body });
+  }
+  unpost(id) {
+    return this.client.request("post", "/api/payroll/{id}/unpost", { params: { id } });
+  }
+};
+
+// src/resources/depreciation.ts
+var DepreciationResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/depreciation", { query: toQuery(params) });
+  }
+  preview(body) {
+    return this.client.request("post", "/api/depreciation/preview", { body });
+  }
+  post(body) {
+    return this.client.request("post", "/api/depreciation/post", { body });
+  }
+  unpost(id) {
+    return this.client.request("post", "/api/depreciation/{id}/unpost", { params: { id } });
+  }
+};
+
+// src/resources/numberings.ts
+var NumberingsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/numberings", { query: toQuery(params) });
+  }
+  update(prefix, body) {
+    return this.client.request("put", "/api/numberings/{prefix}", { params: { prefix }, body });
+  }
+};
+
+// src/resources/exchange-rates.ts
+var ExchangeRatesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/exchange-rates", { query: toQuery(params) });
+  }
+};
+
+// src/resources/bank-statements.ts
+var BankStatementsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params) {
+    return this.client.request("get", "/api/bank-statements", { query: toQuery(params) });
+  }
+  remove(id) {
+    return this.client.request("delete", "/api/bank-statements/{id}", { params: { id } });
+  }
+  detect(file, filename) {
+    const fd = new FormData();
+    fd.append("file", file, filename);
+    return this.client.request("post", "/api/bank-statements/detect", { body: fd });
+  }
+  import(file, fields, filename) {
+    const fd = new FormData();
+    fd.append("file", file, filename);
+    if (fields) {
+      for (const [key, value] of Object.entries(fields)) {
+        fd.append(key, value);
+      }
+    }
+    return this.client.request("post", "/api/bank-statements/import", { body: fd });
+  }
+};
+
+// src/resources/sales-receipts.ts
+var SalesReceiptsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Books a batch of external sales as CashOrder RECEIPT (DRAFT) documents.
+   * Returns `{ results: [...] }`, one entry per item — `'created' | 'duplicate' | 'error'` —
+   * positional with `items`.
+   */
+  ingest(items) {
+    return this.client.request("post", "/api/sales/receipts", { body: { items } });
+  }
+};
+
 // src/client.ts
+var createClient = typeof import_openapi_fetch.default === "function" ? import_openapi_fetch.default : import_openapi_fetch.default.default;
 var DEFAULT_BASE_URL = "https://app.jars.lt";
 function safeJson(text) {
   try {
@@ -236,6 +651,22 @@ var JarsClient = class {
   reports;
   auditLogs;
   lookups;
+  cashRegisters;
+  projects;
+  professions;
+  perDiemRates;
+  priceLists;
+  fixedAssets;
+  employees;
+  cashOrders;
+  bankTransactions;
+  businessTrips;
+  payroll;
+  depreciation;
+  numberings;
+  exchangeRates;
+  bankStatements;
+  salesReceipts;
   baseUrl;
   authHeader;
   fetchImpl;
@@ -244,7 +675,7 @@ var JarsClient = class {
     this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.authHeader = `Bearer ${config.apiKey}`;
     this.fetchImpl = config.fetch ?? fetch;
-    this.raw = (0, import_openapi_fetch.default)({
+    this.raw = createClient({
       baseUrl: this.baseUrl,
       fetch: this.fetchImpl,
       headers: { Authorization: this.authHeader }
@@ -256,6 +687,22 @@ var JarsClient = class {
     this.reports = new ReportsResource(this);
     this.auditLogs = new AuditLogsResource(this);
     this.lookups = new LookupsResource(this);
+    this.cashRegisters = new CashRegistersResource(this);
+    this.projects = new ProjectsResource(this);
+    this.professions = new ProfessionsResource(this);
+    this.perDiemRates = new PerDiemRatesResource(this);
+    this.priceLists = new PriceListsResource(this);
+    this.fixedAssets = new FixedAssetsResource(this);
+    this.employees = new EmployeesResource(this);
+    this.cashOrders = new CashOrdersResource(this);
+    this.bankTransactions = new BankTransactionsResource(this);
+    this.businessTrips = new BusinessTripsResource(this);
+    this.payroll = new PayrollResource(this);
+    this.depreciation = new DepreciationResource(this);
+    this.numberings = new NumberingsResource(this);
+    this.exchangeRates = new ExchangeRatesResource(this);
+    this.bankStatements = new BankStatementsResource(this);
+    this.salesReceipts = new SalesReceiptsResource(this);
   }
   async request(method, path, opts = {}) {
     const finalPath = opts.params ? path.replace(/\{([^}]+)\}/g, (_, key) => {
@@ -271,8 +718,13 @@ var JarsClient = class {
     const headers = new Headers({ Authorization: this.authHeader });
     let body;
     if (opts.body !== void 0) {
-      headers.set("content-type", "application/json");
-      body = JSON.stringify(opts.body);
+      const isForm = typeof FormData !== "undefined" && opts.body instanceof FormData;
+      if (isForm) {
+        body = opts.body;
+      } else {
+        headers.set("content-type", "application/json");
+        body = JSON.stringify(opts.body);
+      }
     }
     let res;
     try {
@@ -300,14 +752,30 @@ var JarsClient = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuditLogsResource,
+  BankStatementsResource,
+  BankTransactionsResource,
+  BusinessTripsResource,
+  CashOrdersResource,
+  CashRegistersResource,
   DEFAULT_BASE_URL,
+  DepreciationResource,
+  EmployeesResource,
+  ExchangeRatesResource,
+  FixedAssetsResource,
   InvoicesResource,
   JarsApiError,
   JarsClient,
   JournalResource,
   LookupsResource,
+  NumberingsResource,
   PartnersResource,
+  PayrollResource,
+  PerDiemRatesResource,
+  PriceListsResource,
   ProductsResource,
-  ReportsResource
+  ProfessionsResource,
+  ProjectsResource,
+  ReportsResource,
+  SalesReceiptsResource
 });
 //# sourceMappingURL=index.cjs.map