@reservation-studio/electron-types 0.0.17 → 0.0.19

package/dist/interfaces/api.interface.d.ts

@@ -1,7 +1,7 @@
 import { CertificateInfo } from './certificate-info.interface';
 import { HttpOptions, HttpResponse } from './http.interface';
 import { EnvironmentEnum } from '../enums/envirovment.enum';
-import { DeviceInfo, FiscalDeviceInfo, FiscalDeviceStatus, FiscalMemoryRecord, FiscalReceipt, FiscalResponse, ReversalReceipt } from './fiscal-device.interface';
+import { DeviceInfo, FiscalDeviceResponse, FiscalDeviceStatus, FiscalMemoryRecord, FiscalReceipt, FiscalResponse, ReversalReceipt } from './fiscal-device.interface';
 export interface ApiInterface {
     /**
      * An object representing operations related to certificates.
@@ -85,12 +85,11 @@ export interface ApiInterface {
      */
     fiscalDevices: {
         /**
-         * Gets a list of all detected fiscal devices.
-         * Automatically initializes fiscal devices if needed.
+         * Retrieves a list of fiscal devices.
          *
-         * @return {Promise<FiscalDeviceInfo[]>} A promise that resolves to an array of fiscal device information.
+         * @return {Promise<FiscalDeviceResponse[]>} A promise that resolves to an array of fiscal device responses.
          */
-        list(): Promise<FiscalDeviceInfo[]>;
+        list(): Promise<FiscalDeviceResponse[]>;
         /**
          * Sets the active fiscal device.
          *
@@ -102,94 +101,119 @@ export interface ApiInterface {
         /**
          * Gets the active fiscal device.
          *
-         * @return {Promise<FiscalDeviceInfo>} A promise that resolves to the active fiscal device information.
+         * @return {Promise<FiscalDeviceResponse>} A promise that resolves to the active fiscal device information.
          * @throws {Error} If no active device is set.
          */
-        getActiveDevice(): Promise<FiscalDeviceInfo>;
+        getActiveDevice(): Promise<FiscalDeviceResponse>;
         /**
-         * Gets detailed information about the active device.
+         * Gets detailed information about a fiscal device.
          *
+         * @param {string} [serial] - Optional serial number of the device to get information for. If not provided, uses the active device.
          * @return {Promise<DeviceInfo>} A promise that resolves to the detailed device information.
-         * @throws {Error} If no active device is set.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        getDeviceInfo(): Promise<DeviceInfo>;
+        getDeviceInfo(serial?: string): Promise<DeviceInfo>;
         /**
-         * Prints a fiscal receipt using the active device.
+         * Prints a fiscal receipt using a fiscal device.
          *
          * @param {FiscalReceipt} receipt - The receipt to print.
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<FiscalResponse>} A promise that resolves to the fiscal response.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        printReceipt(receipt: FiscalReceipt): Promise<FiscalResponse>;
+        printReceipt(receipt: FiscalReceipt, serial?: string): Promise<FiscalResponse>;
         /**
-         * Prints a reversal receipt using the active device.
+         * Prints a non-fiscal receipt using a fiscal device.
          *
-         * @param {ReversalReceipt} receipt - The reversal receipt to print.
-         * @return {Promise<FiscalResponse>} A promise that resolves to the fiscal response.
+         * @param {FiscalReceipt} receipt - The receipt object containing details to be printed as a non-fiscal receipt.
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
+         * @return {Promise<FiscalResponse>} A promise that resolves to a FiscalResponse object indicating the result of the operation.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        printReversalReceipt(receipt: ReversalReceipt): Promise<FiscalResponse>;
+        printNonFiscalReceipt(receipt: FiscalReceipt, serial?: string): Promise<FiscalResponse>;
         /**
-         * Prints a non-fiscal text using the active device.
+         * Prints a reversal receipt using a fiscal device.
          *
-         * @param {string} text - The text to print.
-         * @return {Promise<boolean>} A promise that resolves to true if printing was successful.
+         * @param {ReversalReceipt} receipt - The reversal receipt to print.
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
+         * @return {Promise<FiscalResponse>} A promise that resolves to the fiscal response.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        printText(text: string): Promise<boolean>;
+        printReversalReceipt(receipt: ReversalReceipt, serial?: string): Promise<FiscalResponse>;
         /**
-         * Gets the last fiscal memory record from the active device.
+         * Gets the last fiscal memory record from a fiscal device.
          *
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<FiscalMemoryRecord>} A promise that resolves to the last fiscal memory record.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        getLastFiscalRecord(): Promise<FiscalMemoryRecord>;
+        getLastFiscalRecord(serial?: string): Promise<FiscalMemoryRecord>;
         /**
-         * Gets the status of the active device.
+         * Gets the status of a fiscal device.
          *
-         * @return {Promise<FiscalDeviceStatus>} A promise that resolves to the status of the active device.
+         * @param {string} [serial] - Optional serial number of the device to get status for. If not provided, uses the active device.
+         * @return {Promise<FiscalDeviceStatus>} A promise that resolves to the status of the device.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        getStatus(): Promise<FiscalDeviceStatus>;
+        getStatus(serial?: string): Promise<FiscalDeviceStatus>;
         /**
-         * Prints an X report (daily financial report without reset) using the active device.
+         * Prints an X report (daily financial report without reset) using a fiscal device.
          *
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<boolean>} A promise that resolves to true if printing was successful.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        printXReport(): Promise<boolean>;
+        printXReport(serial?: string): Promise<boolean>;
         /**
-         * Prints a Z report (daily financial report with reset) using the active device.
+         * Prints a Z report (daily financial report with reset) using a fiscal device.
          *
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<boolean>} A promise that resolves to true if printing was successful.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        printZReport(): Promise<boolean>;
+        printZReport(serial?: string): Promise<boolean>;
         /**
-         * Deposits money into the cash register using the active device.
+         * Deposits money into the cash register using a fiscal device.
          *
          * @param {number} amount - The amount to deposit.
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<boolean>} A promise that resolves to true if the deposit was successful.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        depositMoney(amount: number): Promise<boolean>;
+        depositMoney(amount: number, serial?: string): Promise<boolean>;
         /**
-         * Withdraws money from the cash register using the active device.
+         * Withdraws money from the cash register using a fiscal device.
          *
          * @param {number} amount - The amount to withdraw.
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<boolean>} A promise that resolves to true if the withdrawal was successful.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        withdrawMoney(amount: number): Promise<boolean>;
+        withdrawMoney(amount: number, serial?: string): Promise<boolean>;
         /**
-         * Gets the current cash amount in the register using the active device.
+         * Gets the current cash amount in the register using a fiscal device.
          *
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<number>} A promise that resolves to the current cash amount.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        getCashAmount(): Promise<number>;
+        getCashAmount(serial?: string): Promise<number>;
         /**
-         * Sets the date and time on the active device.
+         * Sets the date and time on a fiscal device.
          *
          * @param {Date} dateTime - The date and time to set.
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<boolean>} A promise that resolves to true if setting was successful.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        setDateTime(dateTime: Date): Promise<boolean>;
+        setDateTime(dateTime: Date, serial?: string): Promise<boolean>;
         /**
-         * Prints a duplicate of the last receipt using the active device.
+         * Prints a duplicate of the last receipt using a fiscal device.
          *
+         * @param {string} [serial] - Optional serial number of the device to use. If not provided, uses the active device.
          * @return {Promise<boolean>} A promise that resolves to true if printing was successful.
+         * @throws {Error} If no active device is set and no serial is provided, or if the device with the specified serial is not found.
          */
-        printDuplicate(): Promise<boolean>;
+        printDuplicate(serial?: string): Promise<boolean>;
     };
 }

package/dist/interfaces/fiscal-device.interface.d.ts

@@ -43,6 +43,13 @@ export interface FiscalDeviceInterface {
      * @returns {Promise<FiscalResponse>} A promise that resolves to the fiscal response
      */
     printReceipt(receipt: FiscalReceipt): Promise<FiscalResponse>;
+    /**
+     * Prints a non-fiscal receipt based on the provided receipt details.
+     *
+     * @param {FiscalReceipt} receipt - The receipt object containing all relevant data for generating the non-fiscal receipt.
+     * @return {Promise<FiscalResponse>} A promise that resolves to a FiscalResponse object containing the status and details of the print operation.
+     */
+    printNonFiscalReceipt(receipt: FiscalReceipt): Promise<FiscalResponse>;
     /**
      * Prints a reversal receipt
      *
@@ -50,13 +57,6 @@ export interface FiscalDeviceInterface {
      * @returns {Promise<FiscalResponse>} A promise that resolves to the fiscal response
      */
     printReversalReceipt(receipt: ReversalReceipt): Promise<FiscalResponse>;
-    /**
-     * Prints a non-fiscal text
-     *
-     * @param {string} text - The text to print
-     * @returns {Promise<boolean>} A promise that resolves to true if printing was successful
-     */
-    printText(text: string): Promise<boolean>;
     /**
      * Gets the last fiscal memory record
      *
@@ -126,13 +126,21 @@ export interface FiscalDeviceInterface {
  */
 export interface FiscalReceipt {
     /**
-     * The operator number
-     */
-    operatorNumber: number;
-    /**
-     * The operator password
-     */
-    operatorPassword: string;
+     * An object representing various operator-related properties.
+     */
+    operator: {
+        /**
+         * Represents a numerical value.
+         * This variable can store any valid number, including integers and floating-point values.
+         */
+        number: number;
+        /**
+         * A string representing the password for authentication or security purposes.
+         * This variable typically holds sensitive information and should be handled securely.
+         * Ensure this value is kept private and not exposed in any logs or outputs.
+         */
+        password: string;
+    };
     /**
      * The unique sale number
      */
@@ -158,10 +166,21 @@ export interface FiscalReceiptItem {
      * The name of the item
      */
     name: string;
+    /**
+     * Optional description providing additional information or context.
+     * This can be used to supply user-friendly details or explanations
+     * associated with a particular resource, item, or operation.
+     */
+    description?: string;
     /**
      * The price of the item
      */
-    price: number;
+    unitPrice: number;
+    /**
+     * Represents the currency code in ISO 4217 format (e.g., 'USD', 'EUR', 'JPY').
+     * Typically used to indicate the currency of a monetary value.
+     */
+    currency: string;
     /**
      * The quantity of the item
      */
@@ -283,7 +302,7 @@ export interface FiscalDeviceStatus {
 /**
  * Interface for fiscal device information in list responses
  */
-export interface FiscalDeviceInfo {
+export interface FiscalDeviceResponse {
     /**
      * The manufacturer of the fiscal device
      */
@@ -301,10 +320,6 @@ export interface FiscalDeviceInfo {
  * Interface for detailed device information
  */
 export interface DeviceInfo {
-    /**
-     * The URI of the fiscal device
-     */
-    uri: string;
     /**
      * The serial number of the fiscal device
      */
@@ -328,7 +343,7 @@ export interface DeviceInfo {
     /**
      * The current date and time of the fiscal device
      */
-    currentDateTime?: Date;
+    currentDateTime?: string;
     /**
      * The maximum length of item text
      */
@@ -357,19 +372,31 @@ export interface FiscalResponse {
     /**
      * The receipt number (if applicable)
      */
-    receiptNumber?: string;
+    number?: string;
+    /**
+     * Represents a unique identifier for a receipt generated for a particular sale.
+     * This variable is used to ensure that each sale has a distinct and traceable number.
+     * It may be undefined if no sale has been processed or the number has not been generated yet.
+     */
+    generatedUniqueSaleNumber?: string;
     /**
      * The receipt date and time (if applicable)
      */
-    receiptDateTime?: Date;
+    datetime?: string;
     /**
      * The receipt amount (if applicable)
      */
-    receiptAmount?: number;
+    amount?: number;
     /**
-     * The fiscal memory serial number (if applicable)
+     * Represents an optional piece of information regarding a device.
+     * This variable can store details such as the device's specifications,
+     * status, or metadata, depending on the structure of the `DeviceInfo` type.
+     *
+     * The value of `deviceInfo` may be undefined if no device information is available.
+     *
+     * @type {DeviceInfo | undefined}
      */
-    fiscalMemorySerialNumber?: string;
+    deviceInfo?: DeviceInfo;
     /**
      * The messages returned by the fiscal device
      */
@@ -425,12 +452,12 @@ export declare enum ReversalReason {
  * Enum for fiscal VAT groups
  */
 export declare enum FiscalVATGroup {
-    A = "\u0410",// 20%
-    B = "\u0411",// 9%
-    C = "\u0412",// 0%
-    D = "\u0413",// Exempt
-    E = "\u0414",// Special rate 1
-    F = "\u0415",// Special rate 2
-    G = "\u0416",// Special rate 3
-    H = "\u0417"
+    A = "1",// 20%
+    B = "2",// 9%
+    C = "3",// 0%
+    D = "4",// Exempt
+    E = "5",// Special rate 1
+    F = "6",// Special rate 2
+    G = "7",// Special rate 3
+    H = "8"
 }

package/dist/interfaces/fiscal-device.interface.js

@@ -25,12 +25,12 @@ var ReversalReason;
  */
 var FiscalVATGroup;
 (function (FiscalVATGroup) {
-    FiscalVATGroup["A"] = "\u0410";
-    FiscalVATGroup["B"] = "\u0411";
-    FiscalVATGroup["C"] = "\u0412";
-    FiscalVATGroup["D"] = "\u0413";
-    FiscalVATGroup["E"] = "\u0414";
-    FiscalVATGroup["F"] = "\u0415";
-    FiscalVATGroup["G"] = "\u0416";
-    FiscalVATGroup["H"] = "\u0417"; // Special rate 4
+    FiscalVATGroup["A"] = "1";
+    FiscalVATGroup["B"] = "2";
+    FiscalVATGroup["C"] = "3";
+    FiscalVATGroup["D"] = "4";
+    FiscalVATGroup["E"] = "5";
+    FiscalVATGroup["F"] = "6";
+    FiscalVATGroup["G"] = "7";
+    FiscalVATGroup["H"] = "8"; // Special rate 4
 })(FiscalVATGroup || (exports.FiscalVATGroup = FiscalVATGroup = {}));

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@reservation-studio/electron-types",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "TypeScript типове за ReservationStudioElectron",
   "scripts": {
     "build": "tsc --project tsconfig.json",
     "prebuild": "rimraf ./dist",
     "release": "npm run build && npm publish --access public"
   },
-  "main": "./dist/api/exports.ts",
+  "main": "./dist/api/exports.js",
   "types": "./dist/api/exports.d.ts",
   "keywords": [
     "typescript",