@reservation-studio/electron-types 0.0.32 → 0.0.34

package/README.md

@@ -272,7 +272,7 @@ interface OperatorInfo {
 
 ### FiscalReceipt
 
-````typescript
+```typescript
 interface FiscalReceipt {
   operator: OperatorInfo;
   uniqueSaleNumber: string; // numeric string up to 7 digits
@@ -280,6 +280,7 @@ interface FiscalReceipt {
   payments: FiscalPayment[];
   client?: FiscalClient;
 }
+```
 
 ### NonFiscalReceipt
 
@@ -290,9 +291,7 @@ interface NonFiscalReceipt {
   payments?: FiscalPayment[];
   client?: FiscalClient;
 }
-````
-
-````
+```
 
 ### FiscalReceiptItem
 
@@ -304,7 +303,7 @@ interface FiscalReceiptItem {
   vatGroup: FiscalVATGroup;
   discount?: number;
 }
-````
+```
 
 ### FiscalPayment
 
@@ -366,14 +365,20 @@ interface FiscalMemoryRecord {
 
 ```typescript
 interface FiscalDeviceStatus {
-  connected?: boolean;
-  hasPaper?: boolean;
-  fiscalMemoryFull?: boolean;
-  fiscalReceiptOpen?: boolean;
-  nonFiscalReceiptOpen?: boolean;
-  printingAllowed?: boolean;
+  connected: boolean;
+  paperStatus: PaperStatus;
+  fiscalMemoryFull: boolean;
+  fiscalReceiptOpen: boolean;
+  nonFiscalReceiptOpen: boolean;
+  readyToPrint: boolean;
   messages: FiscalResponseMessage[];
 }
+
+enum PaperStatus {
+  Ok = 'ok',
+  Low = 'low',
+  Out = 'out'
+}
 ```
 
 ### FiscalResponseMessage
@@ -386,6 +391,11 @@ interface FiscalResponseMessage {
 }
 ```
 
+### Fiscal IPC Errors
+
+Fiscal IPC calls throw a structured `FiscalDeviceErrorPayload` on failure. Consumers should display the payload `message` and use optional `details`, `status`, and `validationErrors` for diagnostics.
+Because Electron IPC serializes thrown values, payloads are encoded as JSON in the error message when crossing the renderer boundary.
+
 ### ReversalReceipt
 
 ```typescript

package/dist/interfaces/public/fiscal-device/device.types.d.ts

@@ -46,31 +46,36 @@ export interface FiscalMemoryRecord {
 /**
  * Interface for fiscal device status
  */
+export declare enum PaperStatus {
+    Ok = "ok",
+    Low = "low",
+    Out = "out"
+}
 export interface FiscalDeviceStatus {
     /**
-     * Whether the device is connected
+     * High-level paper status derived from device flags.
      */
-    connected?: boolean;
+    paperStatus: PaperStatus;
     /**
-     * Whether the device has paper
+     * Whether the device is connected
      */
-    hasPaper?: boolean;
+    connected: boolean;
     /**
      * Whether the fiscal memory is full
      */
-    fiscalMemoryFull?: boolean;
+    fiscalMemoryFull: boolean;
     /**
      * Whether a fiscal receipt is currently open
      */
-    fiscalReceiptOpen?: boolean;
+    fiscalReceiptOpen: boolean;
     /**
      * Whether a non-fiscal receipt is currently open
      */
-    nonFiscalReceiptOpen?: boolean;
+    nonFiscalReceiptOpen: boolean;
     /**
-     * Whether printing is allowed
+     * Whether the device is ready to accept print commands.
      */
-    printingAllowed?: boolean;
+    readyToPrint: boolean;
     /**
      * The messages returned by the fiscal device
      */
@@ -212,7 +217,8 @@ export interface FiscalResponseMessage {
      */
     type: 'info' | 'warning' | 'error';
     /**
-     * The code of the message (if applicable)
+     * The code of the message (if applicable).
+     * Daisy example codes: E301 (out of paper), W301/W302 (paper low), E999 (general error).
      */
     code?: string;
     /**

package/dist/interfaces/public/fiscal-device/device.types.js

@@ -1,2 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaperStatus = void 0;
+/**
+ * Interface for fiscal device status
+ */
+var PaperStatus;
+(function (PaperStatus) {
+    PaperStatus["Ok"] = "ok";
+    PaperStatus["Low"] = "low";
+    PaperStatus["Out"] = "out";
+})(PaperStatus || (exports.PaperStatus = PaperStatus = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reservation-studio/electron-types",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "TypeScript типове за ReservationStudioElectron",
   "scripts": {
     "build": "tsc --project tsconfig.json",