@inowu/cashdro 0.1.0

package/README.md

@@ -0,0 +1,335 @@
+# CashDro TypeScript SDK
+
+`@inowu/cashdro` provides convenient, typed access to **CashDro** automated cash
+recyclers from TypeScript and JavaScript — running sales, payments, deposits,
+withdrawals and cash-management operations, plus cash-level and reporting queries.
+
+## Table of contents
+
+- [Installation](#installation)
+- [Quick start](#quick-start)
+- [Authentication](#authentication)
+- [Configuration](#configuration)
+- [How transactions work](#how-transactions-work)
+- [Client reference](#client-reference)
+  - [Connectivity & health](#connectivity--health)
+  - [Transactions — lifecycle](#transactions--lifecycle)
+  - [Transactions — convenience methods](#transactions--convenience-methods)
+  - [Orchestration helpers](#orchestration-helpers)
+  - [Queries & reports](#queries--reports)
+- [Transaction types](#transaction-types)
+- [Responses](#responses)
+- [Error handling](#error-handling)
+- [Advanced](#advanced)
+
+## Installation
+
+```sh
+npm i @inowu/cashdro
+```
+
+**Requirements:** Node.js 18+ (or any runtime with a global `fetch`).
+
+## Quick start
+
+```ts
+import { CashDroClient } from "@inowu/cashdro";
+
+const cashdro = new CashDroClient({
+    baseUrl: "https://your-cashdro/",
+    username: "manager",
+    password: "••••",
+});
+
+// 1. Check connectivity + credentials
+const ping = await cashdro.doTest();
+if (ping.code !== 1) throw new Error("CashDro unreachable or bad credentials");
+
+// 2. Take a 12.50 sale (amounts are in minor units — value × 100)
+const { operationId } = await cashdro.sale(1250, { posuser: "Ana" });
+
+// 3. Wait for the customer to finish paying
+const final = await cashdro.pollUntilFinished(operationId);
+const op = final.response?.operation?.operation;
+console.log(`paid=${op?.totalin} change=${op?.totalout}`); // change is negative
+
+// 4. Acknowledge you recorded the transaction
+await cashdro.setOperationImported(operationId);
+```
+
+## Authentication
+
+Every call authenticates as a **CashDro user** via HTTP Basic. The user must exist
+on the machine and have permission for the operation.
+
+```ts
+const cashdro = new CashDroClient({ baseUrl, username: "manager", password: "••••" });
+```
+
+The optional `posuser`, `posid` and `aliasid` fields accepted by transactions are
+**not** credentials — they only tag *who* (cashier), *which terminal*, and a
+*host-side reference id* initiated an operation (≤ 50 chars each).
+
+## Configuration
+
+`CashDroClient` accepts the following options:
+
+| Option | Description |
+|--------|-------------|
+| `baseUrl` | URL of the CashDro unit. Point this at your device / production unit. |
+| `username`, `password` | CashDro user credentials (HTTP Basic). |
+| `timeoutInSeconds` | Per-request timeout (default 60). |
+| `maxRetries` | Automatic retries with exponential backoff (default 2). |
+| `headers` | Extra headers to send on every request. |
+| `fetch` | Custom `fetch` implementation (see [Advanced](#custom-fetch--self-signed-tls)). |
+
+```ts
+const cashdro = new CashDroClient({
+    baseUrl: "https://cashdro.prod.example/",
+    username: "manager",
+    password: "••••",
+    timeoutInSeconds: 30,
+    maxRetries: 3,
+});
+```
+
+## How transactions work
+
+A cash-movement transaction (sale, payment, deposit, withdrawal, …) runs
+**asynchronously on the hardware**, so it is driven through a short lifecycle:
+
+```
+start ─▶ acknowledge ─▶ (poll status) ─▶ finish? ─▶ import
+ id        launch          I → Q → E → F   finalize   record it
+```
+
+- **`start`** opens the transaction and returns an **`operationId`** (the handle for
+  everything else). The unit does nothing yet.
+- **`acknowledge`** launches execution (acceptors open / dispensing begins).
+- **poll status** until `state === "F"`. States: `I` pending, `Q` queued,
+  `E` executing, `F` finished.
+- **`finish`** finalizes or cancels (only some transactions need an explicit finish).
+- **`import`** tells the unit the host has recorded the result.
+
+The convenience methods (`sale`, `payment`, …) and helpers (`runOperation`,
+`pollUntilFinished`) collapse this boilerplate for you while still returning the
+`operationId` and every raw response.
+
+**Money:** all amounts are integers in **minor units** (value × 100 — `1250` = 12.50).
+Dispensed amounts (`totalout`) are **negative**. The currency is whatever the unit
+is configured for.
+
+**One at a time:** a CashDro runs a single operation at a time; starting another
+while one is active fails with `code -2`. Use `askOperationExecuting()` to detect
+and recover a stuck operation.
+
+## Client reference
+
+Methods that map 1:1 to a device operation return the raw response; the convenience
+and orchestration helpers compose several calls but never hide the underlying data.
+
+### Connectivity & health
+
+| Method | What it does / when to use |
+|--------|----------------------------|
+| `doTest()` | Authenticated ping. Verify reachability + credentials before transacting. |
+| `getDiagnosis()` | Device error state (`WithError`) + device list. Gate transacting on this to avoid jammed hardware. |
+| `getAlerts()` | Denominations at critical / inhibition / below-min / above-max levels. For restock/empty prompts. |
+| `askOperationExecuting()` | The operation currently running (or `OperationId: -1` when idle). Recover an orphaned operation on startup. |
+
+### Transactions — lifecycle
+
+Low-level building blocks (usually you'll use the convenience methods below):
+
+| Method | What it does / when to use |
+|--------|----------------------------|
+| `startOperation({ type, amount?, parameters?, … })` | Open a transaction of a given [type](#transaction-types); returns `operationId`. |
+| `acknowledgeOperationId(id)` | Launch a started operation. |
+| `askOperation(id)` | Poll full status (state, `total`, `totalin`, `totalout`, per-denomination levels, messages). |
+| `finishOperation(id, type)` | `type 1` finalize/accept, `2` cancel, `4` finalize with an explicit piece list. |
+| `setOperationImported(id)` | Mark the operation as recorded by the host (clears it from the pending list). |
+
+### Transactions — convenience methods
+
+Each opens + acknowledges a transaction and returns `{ operationId, started, … }`.
+Options accept `posid` / `posuser` / `aliasid` and the [orchestration
+options](#orchestration-helpers).
+
+| Method | Transaction |
+|--------|-------------|
+| `sale(amount, opts?)` | Sale — customer pays, change returned. |
+| `payment(amount, opts?)` | Payment / payout of an amount. |
+| `paymentByDenomination(pieces, opts?)` | Pay out specific pieces (see below). |
+| `depositByAmount(amount, opts?)` | Deposit up to a target amount. |
+| `deposit(opts?)` | Open-ended deposit; finalize with `finishOperation(id, 1)`. |
+| `change(opts?)` | Change / break a note. |
+| `load(opts?)` | Load cash into the recyclers. |
+| `withdraw(opts?)` | Withdraw cash (operator selects on the unit). |
+| `transferToCassette(opts?)` | Move cash from recyclers to the cassette. |
+| `emptyNoteCassette(opts?)` / `emptyCoinCassette(opts?)` | Register a cassette as emptied. |
+| `finishWithPieces(id, { recycler?, cassette? })` | Finalize a withdrawal/transfer with an explicit piece list. |
+
+```ts
+// Pay out exactly 3×1.00 coins and 1×20.00 note
+await cashdro.paymentByDenomination([
+    { value: 100, level: 3, isBill: false },
+    { value: 2000, level: 1, isBill: true },
+]);
+
+// Withdraw 1×500 note straight from the recyclers (no on-device selection)
+const { operationId } = await cashdro.withdraw();
+await cashdro.finishWithPieces(operationId, { recycler: [{ value: 500, level: 1, isBill: true }] });
+await cashdro.setOperationImported(operationId);
+```
+
+### Orchestration helpers
+
+| Method | What it does |
+|--------|--------------|
+| `runOperation(params, opts?)` | The engine behind the convenience methods: `start → (acknowledge) → optional poll → optional import`. Returns `{ operationId, started, final?, imported? }`. |
+| `pollUntilFinished(id, opts?)` | Poll `askOperation` until `state === "F"`; returns the full final response. Throws `CashDroTimeoutError` on timeout (the operation stays open). |
+
+`runOperation` options: `acknowledge` (default `true`), `waitForFinish` (default
+`false` — a sale blocks on the customer's cash), `autoImport`, an `onStart(id,
+started)` callback, and `poll` (forwarded to `pollUntilFinished`).
+`pollUntilFinished` options: `intervalMs`, `timeoutMs`, `signal` (`AbortSignal`),
+`onPoll(status)`.
+
+```ts
+const { operationId } = await cashdro.sale(500, {
+    onStart: (id) => showOnScreen(id),      // operationId the instant it's known
+});
+const final = await cashdro.pollUntilFinished(operationId, {
+    timeoutMs: 120_000,
+    onPoll: (s) => updateUi(s.response?.operation?.operation),
+});
+```
+
+### Queries & reports
+
+| Method | What it does / when to use |
+|--------|----------------------------|
+| `getPiecesCurrency({ currencyId, includeLevels?, includeImages? })` | Cash levels per denomination. For inventory UI and to pre-check a withdrawal. |
+| `askPendingOperations({ terminal?, importManualOperations? })` | Operations not yet imported by the host. Reconcile before a cash close. |
+| `askMovements({ fromDate, toDate, group?, operationType? })` | Operations between two dates, itemized or aggregated. For reporting. |
+
+```ts
+const levels = await cashdro.getPiecesCurrency({ currencyId: "EUR", includeLevels: 1 });
+const report = await cashdro.askMovements({
+    fromDate: "2026-06-01_00:00:00",
+    toDate: "2026-06-30_23:59:59",
+    group: true,
+    operationType: JSON.stringify([{ Id: 4 }]), // sales only
+});
+```
+
+## Transaction types
+
+`startOperation` (and the convenience methods) accept a numeric `type`:
+
+| `type` | Transaction | Amount/pieces |
+|-------:|-------------|---------------|
+| 1 | load | — |
+| 2 | withdrawal | on-device, or `finishWithPieces` |
+| 3 | payment | `amount`, or `paymentByDenomination` |
+| 4 | sale | `amount` |
+| 8 | transfer to cassette | on-device, or `finishWithPieces` |
+| 10 | empty note cassette | — |
+| 11 | empty coin cassette | — |
+| 16 | deposit | finalize with `finishOperation(id, 1)` |
+| 17 | deposit by amount | `amount` |
+| 18 | change | — |
+
+A "piece" (for `paymentByDenomination` / `finishWithPieces`) is
+`{ value: number, level: number, isBill: boolean }` — `value` in minor units,
+`level` the count, `isBill` `true` for notes.
+
+## Responses
+
+Every call resolves to a typed envelope:
+
+```ts
+{ code: number; response: { errorMessage: string; /* operation data */ } }
+```
+
+`code >= 1` means success; a negative `code` is an error (the convenience/helper
+methods throw instead — see below). Request and response types are available under
+the `CashDroApi` namespace:
+
+```ts
+import { CashDroApi } from "@inowu/cashdro";
+const res: CashDroApi.AskOperationResponse = await cashdro.askOperation(id);
+```
+
+## Error handling
+
+```ts
+import { CashDroError, CashDroTimeoutError } from "@inowu/cashdro";
+
+try {
+    const { operationId } = await cashdro.sale(1250);
+    await cashdro.pollUntilFinished(operationId, { timeoutMs: 60_000 });
+    await cashdro.setOperationImported(operationId);
+} catch (err) {
+    if (err instanceof CashDroTimeoutError) {
+        // no cash inserted in time — the operation is still open; cancel it
+        await cashdro.finishOperation(err.operationId, 2);
+    } else if (err instanceof CashDroError) {
+        console.error("CashDro rejected the request:", err.response);
+    } else {
+        throw err; // transport/HTTP error
+    }
+}
+```
+
+- **`CashDroError`** — a call returned a non-success `code` (carries the raw `response`).
+- **`CashDroTimeoutError`** — `pollUntilFinished` timed out (carries `operationId` and the last poll).
+
+Common device `code`s: `-1` bad credentials, `-2` busy / not found, `-3` wrong
+amount, `-4` no permission, `-998`/`-999` device unavailable (check diagnosis).
+
+## Advanced
+
+### Raw response access
+
+Methods that map 1:1 to a device operation return an awaitable that also exposes the
+raw HTTP response:
+
+```ts
+const { data, rawResponse } = await cashdro.askOperation(id).withRawResponse();
+console.log(rawResponse.headers);
+```
+
+### Custom fetch / self-signed TLS
+
+Provide your own `fetch` for platforms without a built-in one, or to reach a unit
+that serves a **self-signed certificate**. Prefer installing the unit's CA in your
+trust store; only relax verification in trusted, non-production environments.
+
+```ts
+import { Agent, setGlobalDispatcher } from "undici";
+setGlobalDispatcher(new Agent({ connect: { rejectUnauthorized: false } })); // non-prod only
+```
+
+### Per-request options
+
+Each 1:1 method takes an optional second argument for per-call overrides:
+
+```ts
+const controller = new AbortController();
+await cashdro.askOperation(id, {
+    timeoutInSeconds: 10,
+    maxRetries: 0,
+    abortSignal: controller.signal,
+    headers: { "X-Trace-Id": "abc" },
+});
+```
+
+### Low-level client
+
+For endpoints not yet wrapped, `cashdro.api` exposes the underlying client used to
+make requests.
+
+### Runtime compatibility
+
+Works on Node.js 18+, Deno, Bun, Cloudflare Workers, Vercel, and React Native.

package/dist/BaseClient.d.ts

@@ -0,0 +1,43 @@
+import { BasicAuthProvider } from "./auth/BasicAuthProvider.js";
+import * as core from "./core/index.js";
+import type * as environments from "./environments.js";
+export type AuthOption = false | core.AuthProvider["getAuthRequest"] | core.AuthProvider | BasicAuthProvider.AuthOptions;
+export type BaseClientOptions = {
+    environment?: core.Supplier<environments.CashDroApiEnvironment | string>;
+    /** Specify a custom URL to connect the client to. */
+    baseUrl?: core.Supplier<string>;
+    /** Additional headers to include in requests. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** The default maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The default number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
+    fetch?: typeof fetch;
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+    /** Override auth. Pass false to disable, a function returning auth headers, an AuthProvider, or auth options. */
+    auth?: AuthOption;
+} & BasicAuthProvider.AuthOptions;
+export interface BaseRequestOptions {
+    /** The maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** A hook to abort the request. */
+    abortSignal?: AbortSignal;
+    /** Additional query string parameters to include in the request. */
+    queryParams?: Record<string, unknown>;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+}
+export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+    authProvider?: core.AuthProvider;
+};
+export type NormalizedClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions> = NormalizedClientOptions<T> & {
+    authProvider: core.AuthProvider;
+};
+export declare function normalizeClientOptions<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptions<T>;
+export declare function normalizeClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptionsWithAuth<T>;
+//# sourceMappingURL=BaseClient.d.ts.map

package/dist/BaseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseClient.d.ts","sourceRoot":"","sources":["../BaseClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,UAAU,GAChB,KAAK,GACL,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,GACnC,IAAI,CAAC,YAAY,GACjB,iBAAiB,CAAC,WAAW,CAAC;AAEpC,MAAM,MAAM,iBAAiB,GAAG;IAC5B,WAAW,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,qBAAqB,GAAG,MAAM,CAAC,CAAC;IACzE,qDAAqD;IACrD,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC/F,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oIAAoI;IACpI,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IACvD,iHAAiH;IACjH,IAAI,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,iBAAiB,CAAC,WAAW,CAAC;AAElC,MAAM,WAAW,kBAAkB;IAC/B,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAClG;AAED,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,IAAI,CAAC,GAAG;IACvF,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,+BAA+B,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,IACvF,uBAAuB,CAAC,CAAC,CAAC,GAAG;IACzB,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;CACnC,CAAC;AAEN,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAClF,OAAO,EAAE,CAAC,GACX,uBAAuB,CAAC,CAAC,CAAC,CAe5B;AAED,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAC1F,OAAO,EAAE,CAAC,GACX,+BAA+B,CAAC,CAAC,CAAC,CAsBpC"}

package/dist/BaseClient.js

@@ -0,0 +1,44 @@
+// This file was auto-generated by Fern from our API Definition.
+import { BasicAuthProvider } from "./auth/BasicAuthProvider.js";
+import { mergeHeaders } from "./core/headers.js";
+import * as core from "./core/index.js";
+export function normalizeClientOptions(options) {
+    const headers = mergeHeaders({
+        "X-Fern-Language": "JavaScript",
+        "X-Fern-Runtime": core.RUNTIME.type,
+        "X-Fern-Runtime-Version": core.RUNTIME.version,
+    }, options?.headers);
+    return {
+        ...options,
+        logging: core.logging.createLogger(options?.logging),
+        headers,
+    };
+}
+export function normalizeClientOptionsWithAuth(options) {
+    const normalized = normalizeClientOptions(options);
+    if (options.auth === false) {
+        normalized.authProvider = new core.NoOpAuthProvider();
+        return normalized;
+    }
+    if (options.auth != null) {
+        if (typeof options.auth === "function") {
+            normalized.authProvider = { getAuthRequest: options.auth };
+            return normalized;
+        }
+        if (core.isAuthProvider(options.auth)) {
+            normalized.authProvider = options.auth;
+            return normalized;
+        }
+        Object.assign(normalized, options.auth);
+    }
+    const normalizedWithNoOpAuthProvider = withNoOpAuthProvider(normalized);
+    normalized.authProvider ??= new BasicAuthProvider(normalizedWithNoOpAuthProvider);
+    return normalized;
+}
+function withNoOpAuthProvider(options) {
+    return {
+        ...options,
+        authProvider: new core.NoOpAuthProvider(),
+    };
+}
+//# sourceMappingURL=BaseClient.js.map

package/dist/BaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseClient.js","sourceRoot":"","sources":["../BaseClient.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAkDxC,MAAM,UAAU,sBAAsB,CAClC,OAAU;IAEV,MAAM,OAAO,GAAG,YAAY,CACxB;QACI,iBAAiB,EAAE,YAAY;QAC/B,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACnC,wBAAwB,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;KACjD,EACD,OAAO,EAAE,OAAO,CACnB,CAAC;IAEF,OAAO;QACH,GAAG,OAAO;QACV,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;QACpD,OAAO;KACoB,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC1C,OAAU;IAEV,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAuC,CAAC;IAEzF,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtD,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrC,UAAU,CAAC,YAAY,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAC3D,OAAO,UAAU,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,UAAU,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YACvC,OAAO,UAAU,CAAC;QACtB,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,8BAA8B,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACxE,UAAU,CAAC,YAAY,KAAK,IAAI,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;IAClF,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,SAAS,oBAAoB,CACzB,OAAmC;IAEnC,OAAO;QACH,GAAG,OAAO;QACV,YAAY,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE;KAC5C,CAAC;AACN,CAAC"}

package/dist/Client.d.ts

@@ -0,0 +1,181 @@
+import type * as CashDroApi from "./api/index.js";
+import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
+import * as core from "./core/index.js";
+export declare namespace CashDroApiClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class CashDroApiClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<CashDroApiClient.Options>;
+    constructor(options: CashDroApiClient.Options);
+    /**
+     * Lightweight authenticated ping. Returns code 1 when reachable and credentials are valid.
+     *
+     * @param {CashDroApi.DoTestRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.doTest({
+     *         operation: "doTest"
+     *     })
+     */
+    doTest(request: CashDroApi.DoTestRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.SimpleResponse>;
+    private __doTest;
+    /**
+     * Opens a cash-movement transaction of the given `type` and returns an `operationId` to drive the rest of the lifecycle. Only one operation may run at a time; a busy unit returns code -2 "Operation not queued".
+     *
+     * @param {CashDroApi.StartOperationRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.startOperation({
+     *         operation: "startOperation",
+     *         type: 4,
+     *         parameters: "{\"amount\":\"100\"}"
+     *     })
+     */
+    startOperation(request: CashDroApi.StartOperationRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.StartOperationResponse>;
+    private __startOperation;
+    /**
+     * Confirms execution of an operation previously returned by startOperation. The unit begins executing immediately.
+     *
+     * @param {CashDroApi.AcknowledgeOperationIdRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.acknowledgeOperationId({
+     *         operation: "acknowledgeOperationId",
+     *         operationId: 1
+     *     })
+     */
+    acknowledgeOperationId(request: CashDroApi.AcknowledgeOperationIdRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.SimpleResponse>;
+    private __acknowledgeOperationId;
+    /**
+     * Returns the full status of an operation. Poll until `state` is `F` (finished). States: I = pending acknowledge, Q = queued, E = executing, F = finished.
+     *
+     * @param {CashDroApi.AskOperationRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.askOperation({
+     *         operation: "askOperation",
+     *         operationId: 1
+     *     })
+     */
+    askOperation(request: CashDroApi.AskOperationRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.AskOperationResponse>;
+    private __askOperation;
+    /**
+     * Returns the operation currently in execution on the unit, or an OperationId of -1 when the unit is idle.
+     *
+     * @param {CashDroApi.AskOperationExecutingRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.askOperationExecuting({
+     *         operation: "askOperationExecuting"
+     *     })
+     */
+    askOperationExecuting(request: CashDroApi.AskOperationExecutingRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.ExecutingResponse>;
+    private __askOperationExecuting;
+    /**
+     * Closes an in-progress operation. type=1 finalizes (accept), type=2 cancels, type=4 finalizes a withdrawal/transfer "sin interfaz web" while supplying the explicit piece list in `params`.
+     *
+     * @param {CashDroApi.FinishOperationRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.finishOperation({
+     *         operation: "finishOperation",
+     *         operationId: 1,
+     *         type: 1
+     *     })
+     */
+    finishOperation(request: CashDroApi.FinishOperationRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.SimpleResponse>;
+    private __finishOperation;
+    /**
+     * Tells the unit the Host has received and processed the operation, clearing it from the pending-to-import list.
+     *
+     * @param {CashDroApi.SetOperationImportedRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.setOperationImported({
+     *         operation: "setOperationImported",
+     *         operationId: 1
+     *     })
+     */
+    setOperationImported(request: CashDroApi.SetOperationImportedRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.SimpleResponse>;
+    private __setOperationImported;
+    /**
+     * @param {CashDroApi.AskPendingOperationsRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.askPendingOperations({
+     *         operation: "askPendingOperations"
+     *     })
+     */
+    askPendingOperations(request: CashDroApi.AskPendingOperationsRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.PendingOperationsResponse>;
+    private __askPendingOperations;
+    /**
+     * @param {CashDroApi.GetPiecesCurrencyRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.getPiecesCurrency({
+     *         operation: "getPiecesCurrency",
+     *         currencyId: "currencyId"
+     *     })
+     */
+    getPiecesCurrency(request: CashDroApi.GetPiecesCurrencyRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.PiecesCurrencyResponse>;
+    private __getPiecesCurrency;
+    /**
+     * @param {CashDroApi.GetAlertsRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.getAlerts({
+     *         operation: "getAlerts"
+     *     })
+     */
+    getAlerts(request: CashDroApi.GetAlertsRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.AlertsResponse>;
+    private __getAlerts;
+    /**
+     * @param {CashDroApi.GetDiagnosisRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.getDiagnosis({
+     *         operation: "getDiagnosis"
+     *     })
+     */
+    getDiagnosis(request: CashDroApi.GetDiagnosisRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.DiagnosisResponse>;
+    private __getDiagnosis;
+    /**
+     * @param {CashDroApi.AskMovementsRequest} request
+     * @param {CashDroApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.askMovements({
+     *         operation: "askMovements",
+     *         fromDate: "fromDate",
+     *         toDate: "toDate"
+     *     })
+     */
+    askMovements(request: CashDroApi.AskMovementsRequest, requestOptions?: CashDroApiClient.RequestOptions): core.HttpResponsePromise<CashDroApi.MovementsResponse>;
+    private __askMovements;
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input: Request | string | URL, init?: RequestInit, requestOptions?: core.PassthroughRequest.RequestOptions): Promise<Response>;
+}
+//# sourceMappingURL=Client.d.ts.map

package/dist/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../Client.ts"],"names":[],"mappings":"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"}