@floristcloud/api-lib 1.2.52 → 1.2.53

package/build/commands/index.js

@@ -49,6 +49,7 @@ __exportStar(require("./user"), exports);
 __exportStar(require("./work-session"), exports);
 __exportStar(require("./write-off"), exports);
 __exportStar(require("./report"), exports);
+__exportStar(require("./payment-invoice"), exports);
 __exportStar(require("./action-log"), exports);
 __exportStar(require("./client/import-client.command"), exports);
 __exportStar(require("./delivery-route"), exports);

package/build/commands/payment-invoice/create-payment-invoice.command.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreatePaymentInvoiceContractCommand = void 0;
+const zod_1 = require("zod");
+const payment_invoice_schema_1 = require("../../schemas/payment-invoice/payment-invoice.schema");
+const CreatePaymentInvoiceRequestSchema = zod_1.z.object({
+    clientUUID: zod_1.z.uuid(),
+    invoiceDate: zod_1.z.coerce.date(),
+    amount: zod_1.z.coerce.number().positive(),
+});
+const CreatePaymentInvoiceResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: payment_invoice_schema_1.PaymentInvoiceSchema,
+});
+var CreatePaymentInvoiceContractCommand;
+(function (CreatePaymentInvoiceContractCommand) {
+    CreatePaymentInvoiceContractCommand.RequestSchema = CreatePaymentInvoiceRequestSchema;
+    CreatePaymentInvoiceContractCommand.ResponseSchema = CreatePaymentInvoiceResponseSchema;
+})(CreatePaymentInvoiceContractCommand || (exports.CreatePaymentInvoiceContractCommand = CreatePaymentInvoiceContractCommand = {}));

package/build/commands/payment-invoice/delete-payment-invoice.command.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeletePaymentInvoiceContractCommand = void 0;
+const zod_1 = require("zod");
+const DeletePaymentInvoiceRequestSchema = zod_1.z.object({});
+const DeletePaymentInvoiceResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        success: zod_1.z.boolean(),
+    }),
+});
+var DeletePaymentInvoiceContractCommand;
+(function (DeletePaymentInvoiceContractCommand) {
+    DeletePaymentInvoiceContractCommand.RequestSchema = DeletePaymentInvoiceRequestSchema;
+    DeletePaymentInvoiceContractCommand.ResponseSchema = DeletePaymentInvoiceResponseSchema;
+})(DeletePaymentInvoiceContractCommand || (exports.DeletePaymentInvoiceContractCommand = DeletePaymentInvoiceContractCommand = {}));

package/build/commands/payment-invoice/get-payment-invoice-list.query.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetPaymentInvoiceListContractQuery = void 0;
+const zod_1 = require("zod");
+const payment_invoice_schema_1 = require("../../schemas/payment-invoice/payment-invoice.schema");
+const GetPaymentInvoiceListRequestSchema = zod_1.z.object({
+    page: zod_1.z.string().transform(value => Number(value) || 1),
+    count: zod_1.z.string().transform(value => Number(value) || 10),
+    searchQuery: zod_1.z.string().optional(),
+    clientUUID: zod_1.z.uuid().optional(),
+});
+const GetPaymentInvoiceListResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: zod_1.z.object({
+        list: payment_invoice_schema_1.PaymentInvoiceSchema.array(),
+        total: zod_1.z.number(),
+    }),
+});
+var GetPaymentInvoiceListContractQuery;
+(function (GetPaymentInvoiceListContractQuery) {
+    GetPaymentInvoiceListContractQuery.RequestSchema = GetPaymentInvoiceListRequestSchema;
+    GetPaymentInvoiceListContractQuery.ResponseSchema = GetPaymentInvoiceListResponseSchema;
+})(GetPaymentInvoiceListContractQuery || (exports.GetPaymentInvoiceListContractQuery = GetPaymentInvoiceListContractQuery = {}));

package/build/commands/payment-invoice/get-payment-invoice.query.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetPaymentInvoiceContractQuery = void 0;
+const zod_1 = require("zod");
+const payment_invoice_schema_1 = require("../../schemas/payment-invoice/payment-invoice.schema");
+const GetPaymentInvoiceRequestSchema = zod_1.z.object({});
+const GetPaymentInvoiceResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().optional(),
+    data: payment_invoice_schema_1.PaymentInvoiceSchema,
+});
+var GetPaymentInvoiceContractQuery;
+(function (GetPaymentInvoiceContractQuery) {
+    GetPaymentInvoiceContractQuery.RequestSchema = GetPaymentInvoiceRequestSchema;
+    GetPaymentInvoiceContractQuery.ResponseSchema = GetPaymentInvoiceResponseSchema;
+})(GetPaymentInvoiceContractQuery || (exports.GetPaymentInvoiceContractQuery = GetPaymentInvoiceContractQuery = {}));

package/build/commands/payment-invoice/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-payment-invoice.command"), exports);
+__exportStar(require("./get-payment-invoice-list.query"), exports);
+__exportStar(require("./get-payment-invoice.query"), exports);
+__exportStar(require("./delete-payment-invoice.command"), exports);

package/build/constant/error.js

@@ -891,6 +891,13 @@ exports.ERRORS = {
     REPORT_FETCH_FAILED: { code: 'REP001', message: 'Failed to fetch report', httpCode: 500 },
     REPORT_EXPORT_FAILED: { code: 'REP002', message: 'Failed to export report', httpCode: 500 },
     REPORT_NO_DATA: { code: 'REP003', message: 'No data available for the selected period', httpCode: 404 },
+    STATEMENT_PERIOD_TOO_LONG: { code: 'REP004', message: 'Statement period must not exceed 1 year', httpCode: 400 },
+    // PAYMENT INVOICE
+    PAYMENT_INVOICE_CREATE_FAILED: { code: 'PINV001', message: 'Failed to create payment invoice', httpCode: 500 },
+    PAYMENT_INVOICE_EXPORT_FAILED: { code: 'PINV002', message: 'Failed to generate payment invoice document', httpCode: 500 },
+    PAYMENT_INVOICE_NOT_FOUND: { code: 'PINV003', message: 'Payment invoice not found', httpCode: 404 },
+    PAYMENT_INVOICE_FETCH_FAILED: { code: 'PINV004', message: 'Failed to fetch payment invoices', httpCode: 500 },
+    PAYMENT_INVOICE_DELETE_FAILED: { code: 'PINV005', message: 'Failed to delete payment invoice', httpCode: 500 },
     // AUTH GATEWAY
     AUTH_GATEWAY_VOICE_FAILED: { code: 'AG001', message: 'Failed to send code via voice call', httpCode: 500 },
     AUTH_GATEWAY_TELEGRAM_FAILED: { code: 'AG002', message: 'Failed to send code via Telegram', httpCode: 500 },

package/build/enum/client-statement-type.enum.js

@@ -6,4 +6,5 @@ var ClientStatementTypeEnum;
     ClientStatementTypeEnum["ORDER"] = "ORDER";
     ClientStatementTypeEnum["TRANSACTION"] = "TRANSACTION";
     ClientStatementTypeEnum["WRITE_OFF"] = "WRITE_OFF";
+    ClientStatementTypeEnum["OPENING_BALANCE"] = "OPENING_BALANCE";
 })(ClientStatementTypeEnum || (exports.ClientStatementTypeEnum = ClientStatementTypeEnum = {}));

package/build/helpers/date.helper.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setEndDay = exports.setStartDay = exports.dateRangeCheck = void 0;
+exports.setEndDay = exports.setStartDay = exports.isStatementPeriodWithinLimit = exports.STATEMENT_MAX_PERIOD_DAYS = exports.dateRangeCheck = void 0;
 const dateRangeCheck = (startDate, endDate) => {
     return endDate > startDate;
 };
 exports.dateRangeCheck = dateRangeCheck;
+// 1 year + 1 day to tolerate leap years.
+exports.STATEMENT_MAX_PERIOD_DAYS = 366;
+const isStatementPeriodWithinLimit = (startDate, endDate) => {
+    const diffDays = Math.ceil(Math.abs(endDate.getTime() - startDate.getTime()) / (1000 * 60 * 60 * 24));
+    return diffDays <= exports.STATEMENT_MAX_PERIOD_DAYS;
+};
+exports.isStatementPeriodWithinLimit = isStatementPeriodWithinLimit;
 const setStartDay = (date) => {
     return new Date(date.setUTCHours(0, 0, 0, 0));
 };

package/build/schemas/index.js

@@ -33,6 +33,7 @@ __exportStar(require("./transaction/transaction-list.schema"), exports);
 __exportStar(require("./file"), exports);
 __exportStar(require("./product-image/product-image.schema"), exports);
 __exportStar(require("./settings/settings.schema"), exports);
+__exportStar(require("./payment-invoice/payment-invoice.schema"), exports);
 __exportStar(require("./money-account/money-account.schema"), exports);
 __exportStar(require("./domain/domain.schema"), exports);
 __exportStar(require("./category/category.schema"), exports);

package/build/schemas/payment-invoice/payment-invoice.schema.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentInvoiceSchema = void 0;
+const zod_1 = require("zod");
+exports.PaymentInvoiceSchema = zod_1.z.object({
+    uuid: zod_1.z.string(),
+    number: zod_1.z.string(),
+    invoiceDate: zod_1.z.coerce.date(),
+    amount: zod_1.z.coerce.number(),
+    clientUUID: zod_1.z.string(),
+    fileUrl: zod_1.z.string().nullable(),
+    createdAt: zod_1.z.coerce.date(),
+});

package/build/schemas/settings/settings.schema.js

@@ -45,6 +45,9 @@ exports.SettingsSchema = zod_1.z.object({
     legalAddress: zod_1.z.string().nullable(),
     bankName: zod_1.z.string().nullable(),
     bankAccountNumber: zod_1.z.string().nullable(),
+    bankBic: zod_1.z.string().nullable(),
+    correspondentAccount: zod_1.z.string().nullable(),
+    invoiceNumberPrefix: zod_1.z.string(),
     isShowPriceAnonymous: zod_1.z.boolean(),
     orderExpirationWarningMin: zod_1.z.number().nullable(),
     orderExpirationMin: zod_1.z.number().nullable(),
@@ -118,6 +121,9 @@ exports.CreateSettingsSchema = zod_1.z.object({
     legalAddress: zod_1.z.string().optional(),
     bankName: zod_1.z.string().optional(),
     bankAccountNumber: zod_1.z.string().optional(),
+    bankBic: zod_1.z.string().nullable().optional(),
+    correspondentAccount: zod_1.z.string().nullable().optional(),
+    invoiceNumberPrefix: zod_1.z.string().optional(),
     orderExpirationWarningMin: zod_1.z.coerce.number().nullable().optional(),
     orderExpirationMin: zod_1.z.coerce.number().nullable().optional(),
     paymentGraceDaysAfterCompletion: zod_1.z.coerce.number().nullable().optional(),
@@ -180,6 +186,9 @@ exports.UpdateSettingsRequestSchema = zod_1.z.object({
     legalAddress: zod_1.z.string().optional().nullable(),
     bankName: zod_1.z.string().optional().nullable(),
     bankAccountNumber: zod_1.z.string().optional().nullable(),
+    bankBic: zod_1.z.string().optional().nullable(),
+    correspondentAccount: zod_1.z.string().optional().nullable(),
+    invoiceNumberPrefix: zod_1.z.string().optional(),
     isShowPriceAnonymous: zod_1.z.coerce.boolean().optional(),
     orderExpirationWarningMin: zod_1.z.coerce.number().nullable().optional(),
     orderExpirationMin: zod_1.z.coerce.number().nullable().optional(),

package/commands/index.ts

@@ -32,6 +32,7 @@ export * from './user';
 export * from './work-session';
 export * from './write-off';
 export * from './report';
+export * from './payment-invoice';
 export * from './action-log';
 export * from './client/import-client.command';
 export * from './delivery-route';

package/commands/payment-invoice/create-payment-invoice.command.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { PaymentInvoiceSchema } from '../../schemas/payment-invoice/payment-invoice.schema';
+
+const CreatePaymentInvoiceRequestSchema = z.object({
+    clientUUID: z.uuid(),
+    invoiceDate: z.coerce.date(),
+    amount: z.coerce.number().positive(),
+});
+
+const CreatePaymentInvoiceResponseSchema = z.object({
+    message: z.string().optional(),
+    data: PaymentInvoiceSchema,
+});
+
+export namespace CreatePaymentInvoiceContractCommand {
+    export const RequestSchema = CreatePaymentInvoiceRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = CreatePaymentInvoiceResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/payment-invoice/delete-payment-invoice.command.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+
+const DeletePaymentInvoiceRequestSchema = z.object({});
+
+const DeletePaymentInvoiceResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        success: z.boolean(),
+    }),
+});
+
+export namespace DeletePaymentInvoiceContractCommand {
+    export const RequestSchema = DeletePaymentInvoiceRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = DeletePaymentInvoiceResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/payment-invoice/get-payment-invoice-list.query.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { PaymentInvoiceSchema } from '../../schemas/payment-invoice/payment-invoice.schema';
+
+const GetPaymentInvoiceListRequestSchema = z.object({
+    page: z.string().transform(value => Number(value) || 1),
+    count: z.string().transform(value => Number(value) || 10),
+    searchQuery: z.string().optional(),
+    clientUUID: z.uuid().optional(),
+});
+
+const GetPaymentInvoiceListResponseSchema = z.object({
+    message: z.string().optional(),
+    data: z.object({
+        list: PaymentInvoiceSchema.array(),
+        total: z.number(),
+    }),
+});
+
+export namespace GetPaymentInvoiceListContractQuery {
+    export const RequestSchema = GetPaymentInvoiceListRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetPaymentInvoiceListResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/payment-invoice/get-payment-invoice.query.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { PaymentInvoiceSchema } from '../../schemas/payment-invoice/payment-invoice.schema';
+
+const GetPaymentInvoiceRequestSchema = z.object({});
+
+const GetPaymentInvoiceResponseSchema = z.object({
+    message: z.string().optional(),
+    data: PaymentInvoiceSchema,
+});
+
+export namespace GetPaymentInvoiceContractQuery {
+    export const RequestSchema = GetPaymentInvoiceRequestSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = GetPaymentInvoiceResponseSchema;
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/payment-invoice/index.ts

@@ -0,0 +1,4 @@
+export * from './create-payment-invoice.command';
+export * from './get-payment-invoice-list.query';
+export * from './get-payment-invoice.query';
+export * from './delete-payment-invoice.command';

package/constant/error.ts

@@ -934,6 +934,14 @@ export const ERRORS = {
     REPORT_FETCH_FAILED: { code: 'REP001', message: 'Failed to fetch report', httpCode: 500 },
     REPORT_EXPORT_FAILED: { code: 'REP002', message: 'Failed to export report', httpCode: 500 },
     REPORT_NO_DATA: { code: 'REP003', message: 'No data available for the selected period', httpCode: 404 },
+    STATEMENT_PERIOD_TOO_LONG: { code: 'REP004', message: 'Statement period must not exceed 1 year', httpCode: 400 },
+
+    // PAYMENT INVOICE
+    PAYMENT_INVOICE_CREATE_FAILED: { code: 'PINV001', message: 'Failed to create payment invoice', httpCode: 500 },
+    PAYMENT_INVOICE_EXPORT_FAILED: { code: 'PINV002', message: 'Failed to generate payment invoice document', httpCode: 500 },
+    PAYMENT_INVOICE_NOT_FOUND: { code: 'PINV003', message: 'Payment invoice not found', httpCode: 404 },
+    PAYMENT_INVOICE_FETCH_FAILED: { code: 'PINV004', message: 'Failed to fetch payment invoices', httpCode: 500 },
+    PAYMENT_INVOICE_DELETE_FAILED: { code: 'PINV005', message: 'Failed to delete payment invoice', httpCode: 500 },
 
     // AUTH GATEWAY
     AUTH_GATEWAY_VOICE_FAILED: { code: 'AG001', message: 'Failed to send code via voice call', httpCode: 500 },

package/enum/client-statement-type.enum.ts

@@ -2,4 +2,5 @@ export enum ClientStatementTypeEnum {
     ORDER = 'ORDER',
     TRANSACTION = 'TRANSACTION',
     WRITE_OFF = 'WRITE_OFF',
+    OPENING_BALANCE = 'OPENING_BALANCE',
 }

package/helpers/date.helper.ts

@@ -2,6 +2,14 @@ export const dateRangeCheck = (startDate: Date, endDate: Date) => {
     return endDate > startDate;
 };
 
+// 1 year + 1 day to tolerate leap years.
+export const STATEMENT_MAX_PERIOD_DAYS = 366;
+
+export const isStatementPeriodWithinLimit = (startDate: Date, endDate: Date): boolean => {
+    const diffDays = Math.ceil(Math.abs(endDate.getTime() - startDate.getTime()) / (1000 * 60 * 60 * 24));
+    return diffDays <= STATEMENT_MAX_PERIOD_DAYS;
+};
+
 export const setStartDay = (date: Date) => {
     return new Date(date.setUTCHours(0, 0, 0, 0));
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@floristcloud/api-lib",
-    "version": "1.2.52",
+    "version": "1.2.53",
     "description": "",
     "main": "./build/index.js",
     "scripts": {

package/schemas/index.ts

@@ -17,6 +17,7 @@ export * from './transaction/transaction-list.schema';
 export * from './file';
 export * from './product-image/product-image.schema';
 export * from './settings/settings.schema';
+export * from './payment-invoice/payment-invoice.schema';
 export * from './money-account/money-account.schema';
 export * from './domain/domain.schema';
 export * from './category/category.schema';

package/schemas/payment-invoice/payment-invoice.schema.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+
+export const PaymentInvoiceSchema = z.object({
+    uuid: z.string(),
+    number: z.string(),
+    invoiceDate: z.coerce.date(),
+    amount: z.coerce.number(),
+    clientUUID: z.string(),
+    fileUrl: z.string().nullable(),
+    createdAt: z.coerce.date(),
+});

package/schemas/settings/settings.schema.ts

@@ -45,6 +45,9 @@ export const SettingsSchema = z.object({
     legalAddress: z.string().nullable(),
     bankName: z.string().nullable(),
     bankAccountNumber: z.string().nullable(),
+    bankBic: z.string().nullable(),
+    correspondentAccount: z.string().nullable(),
+    invoiceNumberPrefix: z.string(),
     isShowPriceAnonymous: z.boolean(),
     orderExpirationWarningMin: z.number().nullable(),
     orderExpirationMin: z.number().nullable(),
@@ -120,6 +123,9 @@ export const CreateSettingsSchema = z.object({
     legalAddress: z.string().optional(),
     bankName: z.string().optional(),
     bankAccountNumber: z.string().optional(),
+    bankBic: z.string().nullable().optional(),
+    correspondentAccount: z.string().nullable().optional(),
+    invoiceNumberPrefix: z.string().optional(),
     orderExpirationWarningMin: z.coerce.number().nullable().optional(),
     orderExpirationMin: z.coerce.number().nullable().optional(),
     paymentGraceDaysAfterCompletion: z.coerce.number().nullable().optional(),
@@ -185,6 +191,9 @@ export const UpdateSettingsRequestSchema = z.object({
     legalAddress: z.string().optional().nullable(),
     bankName: z.string().optional().nullable(),
     bankAccountNumber: z.string().optional().nullable(),
+    bankBic: z.string().optional().nullable(),
+    correspondentAccount: z.string().optional().nullable(),
+    invoiceNumberPrefix: z.string().optional(),
     isShowPriceAnonymous: z.coerce.boolean().optional(),
     orderExpirationWarningMin: z.coerce.number().nullable().optional(),
     orderExpirationMin: z.coerce.number().nullable().optional(),