@inowu/cashdro 0.1.0

package/dist/api/types/SimpleResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleResponse.d.ts","sourceRoot":"","sources":["../../../api/types/SimpleResponse.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;CACrC;AAED,yBAAiB,cAAc,CAAC;IAC5B,UAAiB,QAAQ;QACrB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,wCAAwC;QACxC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB;CACJ"}

package/dist/api/types/SimpleResponse.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};
+//# sourceMappingURL=SimpleResponse.js.map

package/dist/api/types/SimpleResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleResponse.js","sourceRoot":"","sources":["../../../api/types/SimpleResponse.ts"],"names":[],"mappings":"AAAA,gEAAgE"}

package/dist/api/types/StartOperationRequestOperation.d.ts

@@ -0,0 +1,5 @@
+export declare const StartOperationRequestOperation: {
+    readonly StartOperation: "startOperation";
+};
+export type StartOperationRequestOperation = (typeof StartOperationRequestOperation)[keyof typeof StartOperationRequestOperation];
+//# sourceMappingURL=StartOperationRequestOperation.d.ts.map

package/dist/api/types/StartOperationRequestOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartOperationRequestOperation.d.ts","sourceRoot":"","sources":["../../../api/types/StartOperationRequestOperation.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,8BAA8B;;CAEjC,CAAC;AACX,MAAM,MAAM,8BAA8B,GACtC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/api/types/StartOperationRequestOperation.js

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+export const StartOperationRequestOperation = {
+    StartOperation: "startOperation",
+};
+//# sourceMappingURL=StartOperationRequestOperation.js.map

package/dist/api/types/StartOperationRequestOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartOperationRequestOperation.js","sourceRoot":"","sources":["../../../api/types/StartOperationRequestOperation.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC1C,cAAc,EAAE,gBAAgB;CAC1B,CAAC"}

package/dist/api/types/StartOperationResponse.d.ts

@@ -0,0 +1,21 @@
+export interface StartOperationResponse {
+    code: number;
+    response: StartOperationResponse.Response;
+}
+export declare namespace StartOperationResponse {
+    interface Response {
+        errorMessage?: string | undefined;
+        operation?: Response.Operation | undefined;
+        /** Accepts any additional properties */
+        [key: string]: any;
+    }
+    namespace Response {
+        interface Operation {
+            /** Identifier assigned to the new transaction. */
+            operationId?: string | undefined;
+            /** Accepts any additional properties */
+            [key: string]: any;
+        }
+    }
+}
+//# sourceMappingURL=StartOperationResponse.d.ts.map

package/dist/api/types/StartOperationResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartOperationResponse.d.ts","sourceRoot":"","sources":["../../../api/types/StartOperationResponse.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC;CAC7C;AAED,yBAAiB,sBAAsB,CAAC;IACpC,UAAiB,QAAQ;QACrB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,SAAS,CAAC,EAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3C,wCAAwC;QACxC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB;IAED,UAAiB,QAAQ,CAAC;QACtB,UAAiB,SAAS;YACtB,kDAAkD;YAClD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;YACjC,wCAAwC;YACxC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;SACtB;KACJ;CACJ"}

package/dist/api/types/StartOperationResponse.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};
+//# sourceMappingURL=StartOperationResponse.js.map

package/dist/api/types/StartOperationResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartOperationResponse.js","sourceRoot":"","sources":["../../../api/types/StartOperationResponse.ts"],"names":[],"mappings":"AAAA,gEAAgE"}

package/dist/api/types/index.d.ts

@@ -0,0 +1,28 @@
+export * from "./AcknowledgeOperationIdRequestOperation.js";
+export * from "./Alert.js";
+export * from "./AlertsResponse.js";
+export * from "./AskMovementsRequestOperation.js";
+export * from "./AskOperationExecutingRequestOperation.js";
+export * from "./AskOperationRequestOperation.js";
+export * from "./AskOperationResponse.js";
+export * from "./AskPendingOperationsRequestOperation.js";
+export * from "./CurrencyPiece.js";
+export * from "./Device.js";
+export * from "./DiagnosisResponse.js";
+export * from "./DoTestRequestOperation.js";
+export * from "./ExecutingOperation.js";
+export * from "./ExecutingResponse.js";
+export * from "./FinishOperationRequestOperation.js";
+export * from "./GetAlertsRequestOperation.js";
+export * from "./GetDiagnosisRequestOperation.js";
+export * from "./GetPiecesCurrencyRequestOperation.js";
+export * from "./MovementsResponse.js";
+export * from "./OperationStatus.js";
+export * from "./PendingOperationsResponse.js";
+export * from "./Piece.js";
+export * from "./PiecesCurrencyResponse.js";
+export * from "./SetOperationImportedRequestOperation.js";
+export * from "./SimpleResponse.js";
+export * from "./StartOperationRequestOperation.js";
+export * from "./StartOperationResponse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../api/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qBAAqB,CAAC;AACpC,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC"}

package/dist/api/types/index.js

@@ -0,0 +1,28 @@
+export * from "./AcknowledgeOperationIdRequestOperation.js";
+export * from "./Alert.js";
+export * from "./AlertsResponse.js";
+export * from "./AskMovementsRequestOperation.js";
+export * from "./AskOperationExecutingRequestOperation.js";
+export * from "./AskOperationRequestOperation.js";
+export * from "./AskOperationResponse.js";
+export * from "./AskPendingOperationsRequestOperation.js";
+export * from "./CurrencyPiece.js";
+export * from "./Device.js";
+export * from "./DiagnosisResponse.js";
+export * from "./DoTestRequestOperation.js";
+export * from "./ExecutingOperation.js";
+export * from "./ExecutingResponse.js";
+export * from "./FinishOperationRequestOperation.js";
+export * from "./GetAlertsRequestOperation.js";
+export * from "./GetDiagnosisRequestOperation.js";
+export * from "./GetPiecesCurrencyRequestOperation.js";
+export * from "./MovementsResponse.js";
+export * from "./OperationStatus.js";
+export * from "./PendingOperationsResponse.js";
+export * from "./Piece.js";
+export * from "./PiecesCurrencyResponse.js";
+export * from "./SetOperationImportedRequestOperation.js";
+export * from "./SimpleResponse.js";
+export * from "./StartOperationRequestOperation.js";
+export * from "./StartOperationResponse.js";
+//# sourceMappingURL=index.js.map

package/dist/api/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../api/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qBAAqB,CAAC;AACpC,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC"}

package/dist/auth/BasicAuthProvider.d.ts

@@ -0,0 +1,25 @@
+import * as core from "../core/index.js";
+declare const USERNAME_PARAM: "username";
+declare const PASSWORD_PARAM: "password";
+export declare class BasicAuthProvider implements core.AuthProvider {
+    private readonly options;
+    constructor(options: BasicAuthProvider.Options);
+    static canCreate(options: Partial<BasicAuthProvider.Options>): boolean;
+    getAuthRequest({ endpointMetadata, }?: {
+        endpointMetadata?: core.EndpointMetadata;
+    }): Promise<core.AuthRequest>;
+}
+export declare namespace BasicAuthProvider {
+    const AUTH_SCHEME: "basicAuth";
+    const AUTH_CONFIG_ERROR_MESSAGE: string;
+    const AUTH_CONFIG_ERROR_MESSAGE_USERNAME: string;
+    const AUTH_CONFIG_ERROR_MESSAGE_PASSWORD: string;
+    type Options = AuthOptions;
+    type AuthOptions = {
+        [USERNAME_PARAM]: core.Supplier<string>;
+        [PASSWORD_PARAM]: core.Supplier<string>;
+    };
+    function createInstance(options: Options): core.AuthProvider;
+}
+export {};
+//# sourceMappingURL=BasicAuthProvider.d.ts.map

package/dist/auth/BasicAuthProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicAuthProvider.d.ts","sourceRoot":"","sources":["../../auth/BasicAuthProvider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AAGzC,QAAA,MAAM,cAAc,EAAG,UAAmB,CAAC;AAC3C,QAAA,MAAM,cAAc,EAAG,UAAmB,CAAC;AAE3C,qBAAa,iBAAkB,YAAW,IAAI,CAAC,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,OAAO,EAAE,iBAAiB,CAAC,OAAO;WAIhC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO;IAIhE,cAAc,CAAC,EACxB,gBAAgB,GACnB,GAAE;QACC,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC;KACvC,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;CAmBrC;AAED,yBAAiB,iBAAiB,CAAC;IACxB,MAAM,WAAW,EAAG,WAAoB,CAAC;IACzC,MAAM,yBAAyB,EAAE,MACwC,CAAC;IAC1E,MAAM,kCAAkC,EAAE,MAC6B,CAAC;IACxE,MAAM,kCAAkC,EAAE,MAC6B,CAAC;IAC/E,KAAY,OAAO,GAAG,WAAW,CAAC;IAClC,KAAY,WAAW,GAAG;QAAE,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IAE/G,SAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,YAAY,CAElE;CACJ"}

package/dist/auth/BasicAuthProvider.js

@@ -0,0 +1,42 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../core/index.js";
+import * as errors from "../errors/index.js";
+const USERNAME_PARAM = "username";
+const PASSWORD_PARAM = "password";
+export class BasicAuthProvider {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    static canCreate(options) {
+        return options?.[USERNAME_PARAM] != null && options?.[PASSWORD_PARAM] != null;
+    }
+    async getAuthRequest({ endpointMetadata, } = {}) {
+        const username = await core.Supplier.get(this.options[USERNAME_PARAM]);
+        if (username == null) {
+            throw new errors.CashDroApiError({ message: BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_USERNAME });
+        }
+        const password = await core.Supplier.get(this.options[PASSWORD_PARAM]);
+        if (password == null) {
+            throw new errors.CashDroApiError({ message: BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_PASSWORD });
+        }
+        const authHeader = core.BasicAuth.toAuthorizationHeader({
+            username: username,
+            password: password,
+        });
+        return {
+            headers: authHeader != null ? { Authorization: authHeader } : {},
+        };
+    }
+}
+(function (BasicAuthProvider) {
+    BasicAuthProvider.AUTH_SCHEME = "basicAuth";
+    BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE = "Please provide username and password when initializing the client";
+    BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_USERNAME = `Please provide '${USERNAME_PARAM}' when initializing the client`;
+    BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_PASSWORD = `Please provide '${PASSWORD_PARAM}' when initializing the client`;
+    function createInstance(options) {
+        return new BasicAuthProvider(options);
+    }
+    BasicAuthProvider.createInstance = createInstance;
+})(BasicAuthProvider || (BasicAuthProvider = {}));
+//# sourceMappingURL=BasicAuthProvider.js.map

package/dist/auth/BasicAuthProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicAuthProvider.js","sourceRoot":"","sources":["../../auth/BasicAuthProvider.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C,MAAM,cAAc,GAAG,UAAmB,CAAC;AAC3C,MAAM,cAAc,GAAG,UAAmB,CAAC;AAE3C,MAAM,OAAO,iBAAiB;IACT,OAAO,CAA4B;IAEpD,YAAY,OAAkC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,OAA2C;QAC/D,OAAO,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC;IAClF,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,EACxB,gBAAgB,MAGhB,EAAE;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QACvE,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,MAAM,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,kCAAkC,EAAE,CAAC,CAAC;QACxG,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QACvE,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,MAAM,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,kCAAkC,EAAE,CAAC,CAAC;QACxG,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;YACpD,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,QAAQ;SACrB,CAAC,CAAC;QAEH,OAAO;YACH,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;SACnE,CAAC;IACN,CAAC;CACJ;AAED,WAAiB,iBAAiB;IACjB,6BAAW,GAAG,WAAoB,CAAC;IACnC,2CAAyB,GAClC,mEAA4E,CAAC;IACpE,oDAAkC,GAC3C,mBAAmB,cAAc,gCAAyC,CAAC;IAClE,oDAAkC,GAC3C,mBAAmB,cAAc,gCAAyC,CAAC;IAI/E,SAAgB,cAAc,CAAC,OAAgB;QAC3C,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAFe,gCAAc,iBAE7B,CAAA;AACL,CAAC,EAdgB,iBAAiB,KAAjB,iBAAiB,QAcjC"}

package/dist/auth/index.d.ts

@@ -0,0 +1,2 @@
+export { BasicAuthProvider } from "./BasicAuthProvider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,2 @@
+export { BasicAuthProvider } from "./BasicAuthProvider.js";
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/cashdro.d.ts

@@ -0,0 +1,194 @@
+/**
+ * CashDroClient — the primary, hand-written client for the CashDro Web Service.
+ * It wraps the generated `CashDroApiClient` (./index.js) in this package.
+ *
+ * Why this exists: the CashDro web service dispatches on a constant `operation`
+ * query parameter that must be sent on every call. Fern's generated SDK always
+ * sources query params from the caller, so the raw client requires you to pass
+ * `{ operation: "doTest" }` etc. on every method — redundant, since it is fixed
+ * per endpoint. This layer injects `operation` for you and exposes the rest of
+ * each call with plain arguments. It also lets `startOperation` take an `amount`
+ * directly instead of a pre-encoded JSON string.
+ *
+ * The generated SDK remains the source of transport, types, and auth; this is
+ * purely a nicer surface and is never overwritten by `fern generate`.
+ */
+import { CashDroApiClient, CashDroApi } from "./index.js";
+/** Thrown when a CashDro call returns a non-success `code`. Carries the raw response. */
+export declare class CashDroError extends Error {
+    readonly response: unknown;
+    constructor(message: string, response: unknown);
+}
+/** Thrown when {@link CashDroClient.pollUntilFinished} exceeds its timeout. Carries the last poll. */
+export declare class CashDroTimeoutError extends Error {
+    readonly operationId: number;
+    readonly last: CashDroApi.AskOperationResponse;
+    constructor(operationId: number, last: CashDroApi.AskOperationResponse);
+}
+export interface PollOptions {
+    /** Delay between status polls. Default 1000ms. */
+    intervalMs?: number;
+    /** Give up after this long. Default 120000ms. Throws {@link CashDroTimeoutError}. */
+    timeoutMs?: number;
+    /** Abort the poll loop early. */
+    signal?: AbortSignal;
+    /** Called with every poll's full response (state, totals, devices, messages...). */
+    onPoll?: (status: CashDroApi.AskOperationResponse) => void;
+}
+export interface RunOperationOptions {
+    /** Send acknowledgeOperationId after starting. Default true. */
+    acknowledge?: boolean;
+    /** Poll askOperation until state F. Default false (a sale waits for cash and would block). */
+    waitForFinish?: boolean;
+    /** Send setOperationImported after finishing. Default false. */
+    autoImport?: boolean;
+    /** Called as soon as the operationId is known (before acknowledge). */
+    onStart?: (operationId: number, started: CashDroApi.StartOperationResponse) => void;
+    /** Forwarded to pollUntilFinished when waitForFinish is true. */
+    poll?: PollOptions;
+}
+/**
+ * Result of {@link CashDroClient.runOperation}. Nothing is hidden — every raw
+ * response is exposed so the caller keeps the operationId, totals, device piece
+ * levels, messages, etc.
+ */
+export interface RunOperationResult {
+    /** Transaction id assigned by the unit — needed to poll, cancel, or import. */
+    operationId: number;
+    /** Raw startOperation response. */
+    started: CashDroApi.StartOperationResponse;
+    /** Raw final askOperation response (present only when waitForFinish was set). */
+    final?: CashDroApi.AskOperationResponse;
+    /** Raw setOperationImported response (present only when autoImport was set). */
+    imported?: CashDroApi.SimpleResponse;
+}
+/**
+ * Full option set of the underlying generated client, passed through verbatim.
+ * Includes `username` / `password` (Basic auth) plus every transport option:
+ *   - `baseUrl`     — override the endpoint. Set this for the production unit,
+ *                     e.g. `{ baseUrl: "https://cashdro.prod.example/" }`.
+ *   - `environment` — alternative to baseUrl (baseUrl takes precedence).
+ *   - `headers`, `fetch`, `timeoutInSeconds`, `maxRetries`, `auth`, ...
+ */
+export type CashDroOptions = CashDroApiClient.Options;
+/** type id for startOperation. 4 = sale, 3 = payment, 1 = load, 2 = withdrawal, 8 = transfer, 16 = deposit, 18 = change. */
+export type OperationType = number;
+export interface StartOperationParams {
+    type: OperationType;
+    /** Amount in minor units (value x100). Convenience: encoded into `parameters` as {"amount":"<amount>"}. */
+    amount?: number;
+    /** Raw JSON parameters string; overrides `amount` if both are given. */
+    parameters?: string;
+    posid?: string;
+    posuser?: string;
+    aliasid?: string;
+}
+/** Run options plus the optional POS-tagging fields, shared by the per-transaction conveniences. */
+export type TxnOptions = RunOperationOptions & Pick<StartOperationParams, "posid" | "posuser" | "aliasid">;
+/** A denomination + count, used by pay-by-denomination and the sin-interfaz-web piece-list finalize. */
+export interface DenominationPiece {
+    /** Denomination value in minor units (e.g. 100 = 1.00). */
+    value: number;
+    /** Number of pieces of this denomination. */
+    level: number;
+    /** true for a banknote, false for a coin. */
+    isBill: boolean;
+}
+export declare class CashDroClient {
+    /** The underlying Fern-generated client, exposed for escape-hatch access. */
+    readonly api: CashDroApiClient;
+    constructor(options: CashDroOptions);
+    /** Verify connection and credentials. */
+    doTest(requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.SimpleResponse>;
+    /** Open a cash-movement transaction; returns an operationId. */
+    startOperation(params: StartOperationParams, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.StartOperationResponse>;
+    /** Confirm + launch a started operation. */
+    acknowledgeOperationId(operationId: number, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.SimpleResponse>;
+    /** Poll an operation's status. */
+    askOperation(operationId: number, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.AskOperationResponse>;
+    /** Query the operation currently executing (OperationId -1 when idle). */
+    askOperationExecuting(requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.ExecutingResponse>;
+    /**
+     * Finalize (type=1), cancel (type=2), or finalize-with-piece-list (type=4)
+     * an operation. For type=4 pass the Spanish-keyed `params` string (see
+     * {@link finishWithPieces} for a typed builder).
+     */
+    finishOperation(operationId: number, type: 1 | 2 | 4, params?: string, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.SimpleResponse>;
+    /** Mark an operation as imported by the Host. */
+    setOperationImported(operationId: number, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.SimpleResponse>;
+    /** List operations pending to import. */
+    askPendingOperations(params?: {
+        terminal?: string;
+        importManualOperations?: boolean;
+    }, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.PendingOperationsResponse>;
+    /** Query cash levels per denomination. */
+    getPiecesCurrency(params: {
+        currencyId: string;
+        includeLevels?: number;
+        includeImages?: number;
+    }, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.PiecesCurrencyResponse>;
+    /** Query active denomination alerts. */
+    getAlerts(requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.AlertsResponse>;
+    /** Query unit diagnosis / device errors. */
+    getDiagnosis(requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.DiagnosisResponse>;
+    /** Query operations between two dates. */
+    askMovements(params: {
+        fromDate: string;
+        toDate: string;
+        group?: boolean;
+        operationType?: string;
+    }, requestOptions?: CashDroApiClient.RequestOptions): import("./core/index.js").HttpResponsePromise<CashDroApi.MovementsResponse>;
+    /**
+     * Poll askOperation until the operation reaches state "F" (finished),
+     * returning the full final response (totals, device levels, messages...).
+     * Throws {@link CashDroTimeoutError} on timeout — the operation stays open,
+     * so cancel it with `finishOperation(id, 2)` if you want to abort.
+     */
+    pollUntilFinished(operationId: number, opts?: PollOptions): Promise<CashDroApi.AskOperationResponse>;
+    /**
+     * Run the shared transaction boilerplate: startOperation → (acknowledge) →
+     * optionally poll until finished → optionally import. Returns every raw
+     * response — including the operationId — so nothing useful is hidden.
+     *
+     * By default it does NOT wait for completion: a sale blocks on the customer
+     * inserting cash, so the caller usually wants the operationId back immediately
+     * (to display it, poll it, or cancel it). Set `waitForFinish` for self-
+     * completing operations.
+     */
+    runOperation(params: StartOperationParams, opts?: RunOperationOptions): Promise<RunOperationResult>;
+    /** Shared plumbing for the per-transaction conveniences below. */
+    private txn;
+    /** Sale / venta (type 4). */
+    sale(amount: number, opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Payment / pago (type 3). */
+    payment(amount: number, opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Deposit by amount / ingreso por importe (type 17). */
+    depositByAmount(amount: number, opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Pay by denomination / pago por denominación (type 3) — dispense the given pieces. */
+    paymentByDenomination(pieces: DenominationPiece[], opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Deposit / ingreso (type 16). Finalize with finishOperation(id, 1) once the user is done. */
+    deposit(opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Change / cambio (type 18). */
+    change(opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Load / carga (type 1). */
+    load(opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Withdrawal / retirada (type 2), driven by the unit's web UI. */
+    withdraw(opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Transfer to cassette / traspaso a casete (type 8), driven by the unit's web UI. */
+    transferToCassette(opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Empty the note cassette / retirada casete de billetes (type 10). */
+    emptyNoteCassette(opts?: TxnOptions): Promise<RunOperationResult>;
+    /** Empty the coin cassette / retirada casete de monedas (type 11). */
+    emptyCoinCassette(opts?: TxnOptions): Promise<RunOperationResult>;
+    /**
+     * Finalize a "sin interfaz web" withdrawal (type 2) or transfer to cassette
+     * (type 8) by supplying the explicit piece list — calls finishOperation with
+     * type=4 and the Spanish-keyed `params`. Pieces taken from the recyclers go
+     * in `recycler`; pieces taken from the cassette go in `cassette`.
+     */
+    finishWithPieces(operationId: number, pieces: {
+        recycler?: DenominationPiece[];
+        cassette?: DenominationPiece[];
+    }): import("./core/index.js").HttpResponsePromise<CashDroApi.SimpleResponse>;
+}
+//# sourceMappingURL=cashdro.d.ts.map

package/dist/cashdro.d.ts.map

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