pi-kiosk-shared 1.0.18 → 1.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/errors.d.ts CHANGED
@@ -16,6 +16,18 @@ export declare class AuthenticationError extends AppError {
16
16
  export declare class NotFoundError extends AppError {
17
17
  constructor(resource?: string);
18
18
  }
19
+ export declare class PaymentError extends AppError {
20
+ constructor(message?: string);
21
+ }
22
+ export declare class InventoryError extends AppError {
23
+ constructor(message?: string);
24
+ }
25
+ export declare class KioskError extends AppError {
26
+ constructor(message?: string);
27
+ }
28
+ export declare class DatabaseError extends AppError {
29
+ constructor(message?: string);
30
+ }
19
31
  export interface ErrorResponse {
20
32
  success: false;
21
33
  error: {
package/dist/errors.js CHANGED
@@ -35,6 +35,30 @@ export class NotFoundError extends AppError {
35
35
  this.name = 'NotFoundError';
36
36
  }
37
37
  }
38
+ export class PaymentError extends AppError {
39
+ constructor(message = 'Chyba při zpracování platby') {
40
+ super(message, 'PAYMENT_ERROR', 400);
41
+ this.name = 'PaymentError';
42
+ }
43
+ }
44
+ export class InventoryError extends AppError {
45
+ constructor(message = 'Chyba při správě zásob') {
46
+ super(message, 'INVENTORY_ERROR', 400);
47
+ this.name = 'InventoryError';
48
+ }
49
+ }
50
+ export class KioskError extends AppError {
51
+ constructor(message = 'Chyba konfigurace kiosku') {
52
+ super(message, 'KIOSK_ERROR', 400);
53
+ this.name = 'KioskError';
54
+ }
55
+ }
56
+ export class DatabaseError extends AppError {
57
+ constructor(message = 'Chyba databáze') {
58
+ super(message, 'DATABASE_ERROR', 503);
59
+ this.name = 'DatabaseError';
60
+ }
61
+ }
38
62
  export const formatError = (error, details) => {
39
63
  const isAppError = error instanceof AppError;
40
64
  return {
package/dist/types.d.ts CHANGED
@@ -1,3 +1,17 @@
1
+ export declare enum TransactionStatus {
2
+ INITIATED = "INITIATED",
3
+ PENDING = "PENDING",
4
+ PROCESSING = "PROCESSING",
5
+ COMPLETED = "COMPLETED",
6
+ FAILED = "FAILED",
7
+ CANCELLED = "CANCELLED",
8
+ TIMEOUT = "TIMEOUT"
9
+ }
10
+ export declare enum ReceiptType {
11
+ PLAIN = "PLAIN",
12
+ INVOICE = "INVOICE",
13
+ PROFORMA = "PROFORMA"
14
+ }
1
15
  export interface Product {
2
16
  id: number;
3
17
  name: string;
@@ -5,12 +19,69 @@ export interface Product {
5
19
  description: string;
6
20
  image?: string;
7
21
  imageUrl?: string;
22
+ clickedOn: number;
23
+ qrCodesGenerated: number;
24
+ numberOfPurchases: number;
25
+ createdAt: string;
26
+ updatedAt: string;
27
+ }
28
+ export interface KioskProduct extends Product {
29
+ quantityInStock: number;
30
+ kioskClickedOn: number;
31
+ kioskNumberOfPurchases: number;
32
+ }
33
+ export interface Kiosk {
34
+ id: number;
35
+ name: string;
36
+ location: string;
37
+ description?: string;
38
+ isActive: boolean;
39
+ createdAt: string;
40
+ updatedAt: string;
41
+ }
42
+ export interface Customer {
43
+ id: number;
44
+ email: string;
45
+ name?: string;
46
+ firstContactAt: string;
47
+ purchasesRequested: number;
48
+ purchasesCompleted: number;
49
+ totalSpent: number;
50
+ }
51
+ export interface KioskInventory {
52
+ id: number;
53
+ kioskId: number;
54
+ productId: number;
8
55
  quantityInStock: number;
56
+ active: boolean;
9
57
  clickedOn: number;
58
+ qrCodesGenerated: number;
10
59
  numberOfPurchases: number;
60
+ lastRestocked?: string;
61
+ createdAt: string;
62
+ updatedAt: string;
63
+ }
64
+ export interface Transaction {
65
+ id: number;
66
+ kioskId: number;
67
+ customerId: number;
68
+ productId?: number;
69
+ requestedAt: string;
70
+ completedAt?: string;
71
+ status: TransactionStatus;
72
+ amount: number;
73
+ paymentId?: string;
74
+ qrCodeData?: string;
75
+ variableSymbol?: string;
76
+ receiptType: ReceiptType;
77
+ fioTransactionId?: string;
78
+ lastFioCheckAt?: string;
79
+ fioCheckCount: number;
80
+ createdAt: string;
81
+ updatedAt: string;
11
82
  }
12
83
  export interface CartItem {
13
- product: Product;
84
+ product: KioskProduct;
14
85
  quantity: number;
15
86
  }
16
87
  export interface Cart {
@@ -25,6 +96,7 @@ export interface PaymentData {
25
96
  customerEmail: string;
26
97
  qrCode: string;
27
98
  paymentId: string;
99
+ status?: TransactionStatus;
28
100
  }
29
101
  export interface MultiProductPaymentData {
30
102
  items: CartItem[];
@@ -32,19 +104,9 @@ export interface MultiProductPaymentData {
32
104
  customerEmail: string;
33
105
  qrCode: string;
34
106
  paymentId: string;
107
+ status?: TransactionStatus;
35
108
  }
36
- export interface AdminProduct {
37
- id: number;
38
- name: string;
39
- price: number;
40
- description: string;
41
- image: string;
42
- imageUrl?: string;
43
- clickedOn: number;
44
- qrCodesGenerated: number;
45
- numberOfPurchases: number;
46
- createdAt: string;
47
- updatedAt: string;
109
+ export interface AdminProduct extends Product {
48
110
  quantityInStock?: number;
49
111
  active?: boolean;
50
112
  }
@@ -62,11 +124,116 @@ export interface KioskStatus {
62
124
  lastSeen: Date;
63
125
  salesToday: number;
64
126
  }
65
- export interface WebSocketMessage {
66
- type: string;
67
- updateType?: string;
68
- data?: any;
127
+ export type WebSocketMessage = ProductUpdateMessage | PaymentStatusMessage | SystemMessage;
128
+ export interface BaseWebSocketMessage {
69
129
  kioskId?: number;
70
130
  timestamp?: string;
71
131
  }
132
+ export interface ProductUpdateMessage extends BaseWebSocketMessage {
133
+ type: 'product_update';
134
+ updateType: 'product_created' | 'product_updated' | 'product_deleted' | 'inventory_updated' | 'payment_completed' | 'payment_timeout' | 'payment_failed';
135
+ data?: {
136
+ productId?: number;
137
+ name?: string;
138
+ price?: number;
139
+ paymentId?: string;
140
+ amount?: number;
141
+ };
142
+ }
143
+ export interface PaymentStatusMessage extends BaseWebSocketMessage {
144
+ type: 'payment_status';
145
+ paymentId: string;
146
+ status: TransactionStatus;
147
+ data?: {
148
+ amount?: number;
149
+ customerEmail?: string;
150
+ };
151
+ }
152
+ export interface SystemMessage extends BaseWebSocketMessage {
153
+ type: 'system';
154
+ message: string;
155
+ level: 'info' | 'warning' | 'error';
156
+ }
72
157
  export type ScreenType = 'products' | 'payment' | 'confirmation' | 'admin-login' | 'admin-dashboard';
158
+ export interface CreateQRPaymentRequest {
159
+ productId: number;
160
+ customerEmail: string;
161
+ kioskId: number;
162
+ }
163
+ export interface CreateQRPaymentResponse {
164
+ paymentId: string;
165
+ qrCodeData: string;
166
+ amount: number;
167
+ customerEmail: string;
168
+ variableSymbol: string;
169
+ }
170
+ export interface CreateMultiQRPaymentRequest {
171
+ items: Array<{
172
+ productId: number;
173
+ quantity: number;
174
+ }>;
175
+ totalAmount: number;
176
+ customerEmail: string;
177
+ kioskId: number;
178
+ }
179
+ export interface CreateMultiQRPaymentResponse {
180
+ paymentId: string;
181
+ qrCodeData: string;
182
+ amount: number;
183
+ customerEmail: string;
184
+ variableSymbol: string;
185
+ }
186
+ export interface PaymentStatusResponse {
187
+ paymentId: string;
188
+ status: TransactionStatus;
189
+ amount: number;
190
+ customerEmail: string;
191
+ requestedAt: string;
192
+ completedAt?: string;
193
+ }
194
+ export interface StartMonitoringRequest {
195
+ paymentId: string;
196
+ }
197
+ export interface StartMonitoringResponse {
198
+ success: boolean;
199
+ message: string;
200
+ }
201
+ export interface ThePayCreateRequest {
202
+ items: Array<{
203
+ productId: number;
204
+ quantity: number;
205
+ price: number;
206
+ }>;
207
+ totalAmount: number;
208
+ customerEmail: string;
209
+ kioskId: number;
210
+ }
211
+ export interface ThePayCreateResponse {
212
+ paymentId: string;
213
+ thepayPaymentId: string;
214
+ paymentUrl: string;
215
+ amount: number;
216
+ customerEmail: string;
217
+ kioskId: number;
218
+ }
219
+ export interface ThePayStatusResponse {
220
+ paymentId: string;
221
+ status: string;
222
+ amount: number;
223
+ customerEmail: string;
224
+ }
225
+ export interface ThePayMethodsResponse {
226
+ methods: Array<{
227
+ name: string;
228
+ enabled: boolean;
229
+ }>;
230
+ }
231
+ export interface InventoryUpdateRequest {
232
+ quantityInStock: number;
233
+ }
234
+ export interface VisibilityToggleRequest {
235
+ visible: boolean;
236
+ }
237
+ export interface ProductClickRequest {
238
+ kioskId: number;
239
+ }
package/dist/types.js CHANGED
@@ -1,2 +1,18 @@
1
1
  // Shared types across all packages
2
- export {};
2
+ // Enums matching backend Prisma schema
3
+ export var TransactionStatus;
4
+ (function (TransactionStatus) {
5
+ TransactionStatus["INITIATED"] = "INITIATED";
6
+ TransactionStatus["PENDING"] = "PENDING";
7
+ TransactionStatus["PROCESSING"] = "PROCESSING";
8
+ TransactionStatus["COMPLETED"] = "COMPLETED";
9
+ TransactionStatus["FAILED"] = "FAILED";
10
+ TransactionStatus["CANCELLED"] = "CANCELLED";
11
+ TransactionStatus["TIMEOUT"] = "TIMEOUT";
12
+ })(TransactionStatus || (TransactionStatus = {}));
13
+ export var ReceiptType;
14
+ (function (ReceiptType) {
15
+ ReceiptType["PLAIN"] = "PLAIN";
16
+ ReceiptType["INVOICE"] = "INVOICE";
17
+ ReceiptType["PROFORMA"] = "PROFORMA";
18
+ })(ReceiptType || (ReceiptType = {}));
package/dist/utils.d.ts CHANGED
@@ -1,5 +1,11 @@
1
1
  export declare const validateEmail: (email: string) => boolean;
2
2
  export declare const formatPrice: (price: number) => string;
3
+ export declare const PRICE_PRECISION = 2;
4
+ export declare const roundPrice: (price: number) => number;
5
+ export declare const parsePrice: (value: string | number) => number;
6
+ export declare const validatePrice: (price: number) => boolean;
7
+ export declare const priceToString: (price: number) => string;
8
+ export declare const stringToPrice: (priceStr: string) => number;
3
9
  export declare const getKioskIdFromUrl: () => number;
4
10
  export declare const getKioskSecretFromUrl: () => string | undefined;
5
11
  export declare const formatDate: (date: Date | string) => string;
package/dist/utils.js CHANGED
@@ -7,7 +7,32 @@ export const validateEmail = (email) => {
7
7
  return emailRegex.test(email);
8
8
  };
9
9
  export const formatPrice = (price) => {
10
- return `${price} Kč`;
10
+ return new Intl.NumberFormat('cs-CZ', {
11
+ style: 'currency',
12
+ currency: 'CZK',
13
+ minimumFractionDigits: 2,
14
+ maximumFractionDigits: 2
15
+ }).format(price);
16
+ };
17
+ // Price precision handling utilities
18
+ export const PRICE_PRECISION = 2; // 2 decimal places for CZK
19
+ export const roundPrice = (price) => {
20
+ return Math.round(price * 100) / 100;
21
+ };
22
+ export const parsePrice = (value) => {
23
+ const num = typeof value === 'string' ? parseFloat(value) : value;
24
+ return roundPrice(num);
25
+ };
26
+ export const validatePrice = (price) => {
27
+ return !isNaN(price) && price > 0 && price <= 999999.99;
28
+ };
29
+ // Convert decimal to string for API calls to avoid precision issues
30
+ export const priceToString = (price) => {
31
+ return price.toFixed(PRICE_PRECISION);
32
+ };
33
+ // Convert string back to number for calculations
34
+ export const stringToPrice = (priceStr) => {
35
+ return parseFloat(priceStr);
11
36
  };
12
37
  export const getKioskIdFromUrl = () => {
13
38
  const urlParams = new URLSearchParams(window.location.search);
@@ -62,13 +87,13 @@ export const addToCart = (cart, product, quantity = 1) => {
62
87
  else {
63
88
  cart.items.push({ product, quantity });
64
89
  }
65
- cart.totalAmount = cart.items.reduce((sum, item) => sum + (item.product.price * item.quantity), 0);
90
+ cart.totalAmount = roundPrice(cart.items.reduce((sum, item) => sum + (item.product.price * item.quantity), 0));
66
91
  cart.totalItems = cart.items.reduce((sum, item) => sum + item.quantity, 0);
67
92
  return cart;
68
93
  };
69
94
  export const removeFromCart = (cart, productId) => {
70
95
  cart.items = cart.items.filter((item) => item.product.id !== productId);
71
- cart.totalAmount = cart.items.reduce((sum, item) => sum + (item.product.price * item.quantity), 0);
96
+ cart.totalAmount = roundPrice(cart.items.reduce((sum, item) => sum + (item.product.price * item.quantity), 0));
72
97
  cart.totalItems = cart.items.reduce((sum, item) => sum + item.quantity, 0);
73
98
  return cart;
74
99
  };
@@ -79,7 +104,7 @@ export const updateCartItemQuantity = (cart, productId, quantity) => {
79
104
  return removeFromCart(cart, productId);
80
105
  }
81
106
  item.quantity = quantity;
82
- cart.totalAmount = cart.items.reduce((sum, item) => sum + (item.product.price * item.quantity), 0);
107
+ cart.totalAmount = roundPrice(cart.items.reduce((sum, item) => sum + (item.product.price * item.quantity), 0));
83
108
  cart.totalItems = cart.items.reduce((sum, item) => sum + item.quantity, 0);
84
109
  }
85
110
  return cart;
@@ -10,6 +10,9 @@ export declare const validators: {
10
10
  positiveNumber: (value: number, fieldName: string) => string | null;
11
11
  username: (value: string) => string | null;
12
12
  password: (value: string) => string | null;
13
+ kioskId: (value: number) => string | null;
14
+ quantity: (value: number, fieldName?: string) => string | null;
15
+ price: (value: number, fieldName?: string) => string | null;
13
16
  };
14
17
  export interface ValidationSchema {
15
18
  [field: string]: Array<(value: any) => string | null>;
@@ -25,7 +28,18 @@ export declare const validationSchemas: {
25
28
  };
26
29
  product: {
27
30
  name: ((value: any) => string | null)[];
28
- price: ((value: any) => string | null)[];
31
+ price: ((value: number, fieldName?: string) => string | null)[];
29
32
  description: ((value: any) => string | null)[];
30
33
  };
34
+ kioskId: {
35
+ kioskId: ((value: number) => string | null)[];
36
+ };
37
+ inventory: {
38
+ quantityInStock: ((value: number, fieldName?: string) => string | null)[];
39
+ };
40
+ payment: {
41
+ productId: ((value: any) => string | null)[];
42
+ kioskId: ((value: number) => string | null)[];
43
+ amount: ((value: number, fieldName?: string) => string | null)[];
44
+ };
31
45
  };
@@ -59,6 +59,39 @@ export const validators = {
59
59
  return `Heslo musí mít alespoň ${APP_CONFIG.MIN_PASSWORD_LENGTH} znaků`;
60
60
  }
61
61
  return null;
62
+ },
63
+ kioskId: (value) => {
64
+ if (value === null || value === undefined)
65
+ return null;
66
+ if (!Number.isInteger(value) || value <= 0) {
67
+ return 'Kiosk ID musí být kladné celé číslo';
68
+ }
69
+ return null;
70
+ },
71
+ quantity: (value, fieldName = 'Množství') => {
72
+ if (value === null || value === undefined)
73
+ return null;
74
+ if (!Number.isInteger(value) || value < 0) {
75
+ return `${fieldName} musí být nezáporné celé číslo`;
76
+ }
77
+ return null;
78
+ },
79
+ price: (value, fieldName = 'Cena') => {
80
+ if (value === null || value === undefined)
81
+ return null;
82
+ if (isNaN(value) || value <= 0) {
83
+ return `${fieldName} musí být kladné číslo`;
84
+ }
85
+ // Check for reasonable price range (0.01 to 999999.99)
86
+ if (value < 0.01 || value > 999999.99) {
87
+ return `${fieldName} musí být v rozsahu 0,01 - 999 999,99 Kč`;
88
+ }
89
+ // Check for precision (max 2 decimal places)
90
+ const rounded = Math.round(value * 100) / 100;
91
+ if (Math.abs(value - rounded) > 0.001) {
92
+ return `${fieldName} může mít maximálně 2 desetinná místa`;
93
+ }
94
+ return null;
62
95
  }
63
96
  };
64
97
  export const validateSchema = (data, schema) => {
@@ -104,10 +137,36 @@ export const validationSchemas = {
104
137
  ],
105
138
  price: [
106
139
  (value) => validators.required(value),
107
- (value) => validators.positiveNumber(value, 'Cena')
140
+ validators.price
108
141
  ],
109
142
  description: [
110
143
  (value) => validators.maxLength(value, APP_CONFIG.MAX_DESCRIPTION_LENGTH, 'Popis')
111
144
  ]
145
+ },
146
+ kioskId: {
147
+ kioskId: [
148
+ (value) => validators.required(value),
149
+ validators.kioskId
150
+ ]
151
+ },
152
+ inventory: {
153
+ quantityInStock: [
154
+ (value) => validators.required(value),
155
+ validators.quantity
156
+ ]
157
+ },
158
+ payment: {
159
+ productId: [
160
+ (value) => validators.required(value),
161
+ (value) => validators.positiveNumber(value, 'ID produktu')
162
+ ],
163
+ kioskId: [
164
+ (value) => validators.required(value),
165
+ validators.kioskId
166
+ ],
167
+ amount: [
168
+ (value) => validators.required(value),
169
+ validators.price
170
+ ]
112
171
  }
113
172
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-kiosk-shared",
3
- "version": "1.0.18",
3
+ "version": "1.0.19",
4
4
  "private": false,
5
5
  "description": "Shared components and utilities for Pi Kiosk system",
6
6
  "keywords": [