@hed-hog/contact 0.0.300 → 0.0.302

package/dist/proposal/proposal.service.js

@@ -0,0 +1,2137 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ProposalService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProposalService = void 0;
+const api_locale_1 = require("@hed-hog/api-locale");
+const api_prisma_1 = require("@hed-hog/api-prisma");
+const core_1 = require("@hed-hog/core");
+const common_1 = require("@nestjs/common");
+const proposal_dto_1 = require("./dto/proposal.dto");
+const proposal_event_types_1 = require("./proposal-event.types");
+let ProposalService = ProposalService_1 = class ProposalService {
+    constructor(prisma, integrationApi, fileService, settingService) {
+        this.prisma = prisma;
+        this.integrationApi = integrationApi;
+        this.fileService = fileService;
+        this.settingService = settingService;
+        this.logger = new common_1.Logger(ProposalService_1.name);
+    }
+    async list(params) {
+        const take = Math.max(1, Number(params.take || params.pageSize || 10));
+        const skip = Math.max(0, Number(params.skip || 0));
+        const search = String(params.search || '').trim();
+        const where = {
+            deleted_at: null,
+        };
+        if (params.person_id) {
+            where.person_id = Number(params.person_id);
+        }
+        if (params.status) {
+            where.status = params.status;
+        }
+        if (search) {
+            const matchingCompanyRows = await this.prisma.person_company.findMany({
+                where: {
+                    trade_name: { contains: search, mode: 'insensitive' },
+                },
+                select: {
+                    id: true,
+                },
+            });
+            const matchingCompanyPersonIds = matchingCompanyRows
+                .map((item) => Number(item.id))
+                .filter((id) => id > 0);
+            where.OR = [
+                { code: { contains: search, mode: 'insensitive' } },
+                { title: { contains: search, mode: 'insensitive' } },
+                {
+                    person: {
+                        is: {
+                            name: { contains: search, mode: 'insensitive' },
+                        },
+                    },
+                },
+                ...(matchingCompanyPersonIds.length > 0
+                    ? [{ person_id: { in: matchingCompanyPersonIds } }]
+                    : []),
+            ];
+        }
+        const [data, total] = await Promise.all([
+            this.prisma.proposal.findMany({
+                where,
+                include: {
+                    person: {
+                        select: {
+                            id: true,
+                            name: true,
+                        },
+                    },
+                    proposal_revision: {
+                        where: {
+                            deleted_at: null,
+                            is_current: true,
+                        },
+                        orderBy: {
+                            revision_number: 'desc',
+                        },
+                        take: 1,
+                        include: {
+                            proposal_item: {
+                                where: { deleted_at: null },
+                                orderBy: { order: 'asc' },
+                            },
+                        },
+                    },
+                },
+                orderBy: {
+                    id: 'desc',
+                },
+                skip,
+                take,
+            }),
+            this.prisma.proposal.count({ where }),
+        ]);
+        const normalizedData = await this.attachPersonTradeNames(this.prisma, data);
+        const page = Math.floor(skip / take) + 1;
+        const lastPage = Math.max(1, Math.ceil(total / take));
+        return {
+            data: normalizedData,
+            total,
+            page,
+            pageSize: take,
+            prev: page > 1 ? page - 1 : null,
+            next: page < lastPage ? page + 1 : null,
+            lastPage,
+        };
+    }
+    async getStats() {
+        const baseWhere = { deleted_at: null };
+        const [total, draft, pendingApproval, approved, rejected, contractGenerated,] = await Promise.all([
+            this.prisma.proposal.count({ where: baseWhere }),
+            this.prisma.proposal.count({
+                where: Object.assign(Object.assign({}, baseWhere), { status: proposal_dto_1.ProposalStatus.DRAFT }),
+            }),
+            this.prisma.proposal.count({
+                where: Object.assign(Object.assign({}, baseWhere), { status: proposal_dto_1.ProposalStatus.PENDING_APPROVAL }),
+            }),
+            this.prisma.proposal.count({
+                where: Object.assign(Object.assign({}, baseWhere), { status: proposal_dto_1.ProposalStatus.APPROVED }),
+            }),
+            this.prisma.proposal.count({
+                where: Object.assign(Object.assign({}, baseWhere), { status: proposal_dto_1.ProposalStatus.REJECTED }),
+            }),
+            this.prisma.proposal.count({
+                where: Object.assign(Object.assign({}, baseWhere), { status: proposal_dto_1.ProposalStatus.CONTRACT_GENERATED }),
+            }),
+        ]);
+        return {
+            total,
+            draft,
+            pendingApproval,
+            approved,
+            rejected,
+            contractGenerated,
+        };
+    }
+    async getById(id, locale) {
+        const proposal = await this.loadProposalDetail(this.prisma, id);
+        if (!proposal) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        const links = await this.integrationApi.findLinksBySource({
+            module: 'contact',
+            entityType: 'proposal',
+            entityId: String(id),
+        });
+        return Object.assign(Object.assign({}, proposal), { integration_links: links });
+    }
+    async create(data, locale, userId) {
+        await this.assertPersonExists(data.person_id, locale);
+        const code = await this.resolveProposalCode(data.code);
+        const normalizedItems = this.normalizeItems(data.items);
+        const totals = this.resolveTotals(data, normalizedItems);
+        const createdByUserId = userId || null;
+        const createdProposal = await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g;
+            const proposal = await tx.proposal.create({
+                data: Object.assign({ person_id: data.person_id, code, title: data.title.trim(), status: (_a = data.status) !== null && _a !== void 0 ? _a : proposal_dto_1.ProposalStatus.DRAFT, contract_category: (_b = data.contract_category) !== null && _b !== void 0 ? _b : 'client', contract_type: (_c = data.contract_type) !== null && _c !== void 0 ? _c : 'service_agreement', billing_model: (_d = data.billing_model) !== null && _d !== void 0 ? _d : 'fixed_price', currency_code: (data.currency_code || 'BRL').trim() || 'BRL', valid_from: data.valid_from ? new Date(data.valid_from) : null, valid_until: data.valid_until ? new Date(data.valid_until) : null, notes: this.normalizeOptionalText(data.notes), owner_user_id: (_e = data.owner_user_id) !== null && _e !== void 0 ? _e : null, created_by_user_id: createdByUserId, updated_by_user_id: createdByUserId, current_revision_number: 1 }, totals),
+            });
+            const revision = await tx.proposal_revision.create({
+                data: Object.assign({ proposal_id: proposal.id, revision_number: 1, status: proposal.status === proposal_dto_1.ProposalStatus.PENDING_APPROVAL
+                        ? proposal_dto_1.ProposalStatus.PENDING_APPROVAL
+                        : proposal_dto_1.ProposalStatus.DRAFT, generation_mode: (_f = data.generation_mode) !== null && _f !== void 0 ? _f : 'manual', title: data.title.trim(), summary: this.normalizeOptionalText(data.summary), content_html: this.normalizeOptionalText(data.content_html), snapshot_json: (_g = data.snapshot_json) !== null && _g !== void 0 ? _g : null, valid_until: data.valid_until ? new Date(data.valid_until) : null, is_current: true, created_by_user_id: createdByUserId }, totals),
+            });
+            if (normalizedItems.length > 0) {
+                await tx.proposal_item.createMany({
+                    data: normalizedItems.map((item, index) => {
+                        var _a;
+                        return ({
+                            proposal_revision_id: revision.id,
+                            order: index,
+                            item_type: item.item_type,
+                            term_type: item.term_type,
+                            name: item.name,
+                            description: item.description,
+                            quantity: item.quantity,
+                            unit_amount_cents: item.unit_amount_cents,
+                            total_amount_cents: item.total_amount_cents,
+                            recurrence: item.recurrence,
+                            due_day: item.due_day,
+                            start_date: item.start_date ? new Date(item.start_date) : null,
+                            end_date: item.end_date ? new Date(item.end_date) : null,
+                            metadata_json: (_a = item.metadata_json) !== null && _a !== void 0 ? _a : null,
+                        });
+                    }),
+                });
+            }
+            const documents = this.normalizeDocuments(data.documents, proposal.id, revision.id, createdByUserId);
+            if (documents.length > 0) {
+                await tx.proposal_document.createMany({
+                    data: documents,
+                });
+            }
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.CREATED, proposal.id, locale, createdByUserId);
+            return proposal;
+        });
+        await this.syncPersonDealValueFromApprovedProposals(this.prisma, createdProposal.person_id);
+        return this.getById(createdProposal.id, locale);
+    }
+    async update(id, data, locale, userId) {
+        var _a, _b;
+        const current = await this.loadProposalDetail(this.prisma, id);
+        if (!current) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        this.assertCanEdit(current.status, locale);
+        const normalizedItems = data.items
+            ? this.normalizeItems(data.items)
+            : (((_b = (_a = current.proposal_revision) === null || _a === void 0 ? void 0 : _a.find((revision) => revision.is_current)) === null || _b === void 0 ? void 0 : _b.proposal_item) || []);
+        const totals = this.resolveTotals(data, normalizedItems);
+        await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+            const currentRevision = await tx.proposal_revision.findFirst({
+                where: {
+                    proposal_id: id,
+                    deleted_at: null,
+                    is_current: true,
+                },
+                orderBy: {
+                    revision_number: 'desc',
+                },
+            });
+            if (!currentRevision) {
+                throw new common_1.NotFoundException('Current proposal revision not found.');
+            }
+            const shouldCreateNewRevision = Boolean(data.create_new_revision);
+            await tx.proposal.update({
+                where: { id },
+                data: Object.assign({ title: (_b = (_a = data.title) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : undefined, contract_category: (_c = data.contract_category) !== null && _c !== void 0 ? _c : undefined, contract_type: (_d = data.contract_type) !== null && _d !== void 0 ? _d : undefined, billing_model: (_e = data.billing_model) !== null && _e !== void 0 ? _e : undefined, currency_code: (_g = (_f = data.currency_code) === null || _f === void 0 ? void 0 : _f.trim()) !== null && _g !== void 0 ? _g : undefined, valid_from: data.valid_from ? new Date(data.valid_from) : undefined, valid_until: data.valid_until ? new Date(data.valid_until) : undefined, notes: data.notes !== undefined ? this.normalizeOptionalText(data.notes) : undefined, owner_user_id: (_h = data.owner_user_id) !== null && _h !== void 0 ? _h : undefined, updated_by_user_id: userId || null, current_revision_number: shouldCreateNewRevision
+                        ? currentRevision.revision_number + 1
+                        : currentRevision.revision_number }, totals),
+            });
+            if (shouldCreateNewRevision) {
+                await tx.proposal_revision.updateMany({
+                    where: {
+                        proposal_id: id,
+                        deleted_at: null,
+                        is_current: true,
+                    },
+                    data: {
+                        is_current: false,
+                        status: currentRevision.status === proposal_dto_1.ProposalStatus.DRAFT
+                            ? 'superseded'
+                            : currentRevision.status,
+                    },
+                });
+                const newRevision = await tx.proposal_revision.create({
+                    data: Object.assign({ proposal_id: id, revision_number: currentRevision.revision_number + 1, status: proposal_dto_1.ProposalStatus.DRAFT, generation_mode: (_j = data.generation_mode) !== null && _j !== void 0 ? _j : currentRevision.generation_mode, title: (_l = (_k = data.title) === null || _k === void 0 ? void 0 : _k.trim()) !== null && _l !== void 0 ? _l : currentRevision.title, summary: data.summary !== undefined
+                            ? this.normalizeOptionalText(data.summary)
+                            : currentRevision.summary, content_html: data.content_html !== undefined
+                            ? this.normalizeOptionalText(data.content_html)
+                            : currentRevision.content_html, snapshot_json: data.snapshot_json !== undefined
+                            ? data.snapshot_json
+                            : currentRevision.snapshot_json, valid_until: data.valid_until !== undefined
+                            ? data.valid_until
+                                ? new Date(data.valid_until)
+                                : null
+                            : currentRevision.valid_until, is_current: true, created_by_user_id: userId || null }, totals),
+                });
+                if (data.items) {
+                    await tx.proposal_item.createMany({
+                        data: normalizedItems.map((item, index) => {
+                            var _a;
+                            return ({
+                                proposal_revision_id: newRevision.id,
+                                order: index,
+                                item_type: item.item_type,
+                                term_type: item.term_type,
+                                name: item.name,
+                                description: item.description,
+                                quantity: item.quantity,
+                                unit_amount_cents: item.unit_amount_cents,
+                                total_amount_cents: item.total_amount_cents,
+                                recurrence: item.recurrence,
+                                due_day: item.due_day,
+                                start_date: item.start_date ? new Date(item.start_date) : null,
+                                end_date: item.end_date ? new Date(item.end_date) : null,
+                                metadata_json: (_a = item.metadata_json) !== null && _a !== void 0 ? _a : null,
+                            });
+                        }),
+                    });
+                }
+                if (data.documents) {
+                    const documents = this.normalizeDocuments(data.documents, id, newRevision.id, userId || null);
+                    if (documents.length > 0) {
+                        await tx.proposal_document.createMany({ data: documents });
+                    }
+                }
+            }
+            else {
+                await tx.proposal_revision.update({
+                    where: { id: currentRevision.id },
+                    data: Object.assign({ title: (_o = (_m = data.title) === null || _m === void 0 ? void 0 : _m.trim()) !== null && _o !== void 0 ? _o : undefined, summary: data.summary !== undefined
+                            ? this.normalizeOptionalText(data.summary)
+                            : undefined, content_html: data.content_html !== undefined
+                            ? this.normalizeOptionalText(data.content_html)
+                            : undefined, snapshot_json: data.snapshot_json !== undefined ? data.snapshot_json : undefined, valid_until: data.valid_until !== undefined
+                            ? data.valid_until
+                                ? new Date(data.valid_until)
+                                : null
+                            : undefined, generation_mode: (_p = data.generation_mode) !== null && _p !== void 0 ? _p : undefined }, totals),
+                });
+                if (data.items) {
+                    await tx.proposal_item.updateMany({
+                        where: {
+                            proposal_revision_id: currentRevision.id,
+                            deleted_at: null,
+                        },
+                        data: {
+                            deleted_at: new Date(),
+                        },
+                    });
+                    if (normalizedItems.length > 0) {
+                        await tx.proposal_item.createMany({
+                            data: normalizedItems.map((item, index) => {
+                                var _a;
+                                return ({
+                                    proposal_revision_id: currentRevision.id,
+                                    order: index,
+                                    item_type: item.item_type,
+                                    term_type: item.term_type,
+                                    name: item.name,
+                                    description: item.description,
+                                    quantity: item.quantity,
+                                    unit_amount_cents: item.unit_amount_cents,
+                                    total_amount_cents: item.total_amount_cents,
+                                    recurrence: item.recurrence,
+                                    due_day: item.due_day,
+                                    start_date: item.start_date ? new Date(item.start_date) : null,
+                                    end_date: item.end_date ? new Date(item.end_date) : null,
+                                    metadata_json: (_a = item.metadata_json) !== null && _a !== void 0 ? _a : null,
+                                });
+                            }),
+                        });
+                    }
+                }
+                if (data.documents) {
+                    await tx.proposal_document.updateMany({
+                        where: {
+                            proposal_id: id,
+                            proposal_revision_id: currentRevision.id,
+                            deleted_at: null,
+                        },
+                        data: {
+                            deleted_at: new Date(),
+                            is_current: false,
+                        },
+                    });
+                    const documents = this.normalizeDocuments(data.documents, id, currentRevision.id, userId || null);
+                    if (documents.length > 0) {
+                        await tx.proposal_document.createMany({ data: documents });
+                    }
+                }
+            }
+        });
+        await this.syncPersonDealValueFromApprovedProposals(this.prisma, current.person_id);
+        return this.getById(id, locale);
+    }
+    async submitForApproval(id, data, locale, userId) {
+        const current = await this.loadProposalDetail(this.prisma, id);
+        if (!current) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.APPROVED ||
+            current.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+            throw new common_1.BadRequestException('Approved proposals cannot be resubmitted.');
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.PENDING_APPROVAL) {
+            return this.getById(id, locale);
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.CANCELLED) {
+            throw new common_1.BadRequestException('Cancelled proposals cannot be resubmitted.');
+        }
+        this.assertProposalWorkflowReadiness(current, 'submitted for approval');
+        await this.prisma.$transaction(async (tx) => {
+            var _a, _b;
+            const lockedProposal = await this.lockProposalForTransition(tx, id);
+            if (!lockedProposal) {
+                throw new common_1.NotFoundException('Proposal not found.');
+            }
+            if (lockedProposal.status === proposal_dto_1.ProposalStatus.APPROVED ||
+                lockedProposal.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+                throw new common_1.BadRequestException('Approved proposals cannot be resubmitted.');
+            }
+            if (lockedProposal.status === proposal_dto_1.ProposalStatus.PENDING_APPROVAL) {
+                return;
+            }
+            if (lockedProposal.status === proposal_dto_1.ProposalStatus.CANCELLED) {
+                throw new common_1.BadRequestException('Cancelled proposals cannot be resubmitted.');
+            }
+            this.assertProposalWorkflowReadiness(lockedProposal, 'submitted for approval');
+            const currentRevision = this.getCurrentProposalRevision(lockedProposal);
+            if (!currentRevision) {
+                throw new common_1.NotFoundException('Current proposal revision not found.');
+            }
+            await tx.proposal.update({
+                where: { id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.PENDING_APPROVAL,
+                    updated_by_user_id: userId || null,
+                },
+            });
+            await tx.proposal_revision.update({
+                where: { id: currentRevision.id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.PENDING_APPROVAL,
+                    submitted_at: new Date(),
+                },
+            });
+            const existingApproval = await tx.proposal_approval.findFirst({
+                where: {
+                    proposal_id: id,
+                    proposal_revision_id: currentRevision.id,
+                    deleted_at: null,
+                    step_order: 1,
+                },
+            });
+            if (existingApproval) {
+                await tx.proposal_approval.update({
+                    where: { id: existingApproval.id },
+                    data: {
+                        requester_user_id: userId || null,
+                        approver_user_id: (_a = data.approver_user_id) !== null && _a !== void 0 ? _a : existingApproval.approver_user_id,
+                        status: 'pending',
+                        submitted_at: new Date(),
+                        decided_at: null,
+                        decision_note: this.normalizeOptionalText(data.note),
+                    },
+                });
+            }
+            else {
+                await tx.proposal_approval.create({
+                    data: {
+                        proposal_id: id,
+                        proposal_revision_id: currentRevision.id,
+                        requester_user_id: userId || null,
+                        approver_user_id: (_b = data.approver_user_id) !== null && _b !== void 0 ? _b : null,
+                        step_order: 1,
+                        status: 'pending',
+                        submitted_at: new Date(),
+                        decision_note: this.normalizeOptionalText(data.note),
+                    },
+                });
+            }
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.SENT, id, locale, userId || null, {
+                note: this.normalizeOptionalText(data.note),
+                metadata: {
+                    trigger: 'submit_for_approval',
+                },
+            });
+        });
+        return this.getById(id, locale);
+    }
+    async approve(id, data, locale, userId) {
+        const current = await this.loadProposalDetail(this.prisma, id);
+        if (!current) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.APPROVED ||
+            current.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+            return this.getById(id, locale);
+        }
+        if (current.status !== proposal_dto_1.ProposalStatus.PENDING_APPROVAL) {
+            throw new common_1.BadRequestException('Only proposals pending approval can be approved.');
+        }
+        this.assertProposalWorkflowReadiness(current, 'approved');
+        await this.prisma.$transaction(async (tx) => {
+            const lockedProposal = await this.lockProposalForTransition(tx, id);
+            if (!lockedProposal) {
+                throw new common_1.NotFoundException('Proposal not found.');
+            }
+            if (lockedProposal.status === proposal_dto_1.ProposalStatus.APPROVED ||
+                lockedProposal.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+                return;
+            }
+            if (lockedProposal.status !== proposal_dto_1.ProposalStatus.PENDING_APPROVAL) {
+                throw new common_1.BadRequestException('Only proposals pending approval can be approved.');
+            }
+            this.assertProposalWorkflowReadiness(lockedProposal, 'approved');
+            const currentRevision = this.getCurrentProposalRevision(lockedProposal);
+            if (!currentRevision) {
+                throw new common_1.NotFoundException('Current proposal revision not found.');
+            }
+            const approval = await tx.proposal_approval.findFirst({
+                where: {
+                    proposal_id: id,
+                    proposal_revision_id: currentRevision.id,
+                    deleted_at: null,
+                    step_order: 1,
+                },
+            });
+            const approvedAt = new Date();
+            if (approval) {
+                await tx.proposal_approval.update({
+                    where: { id: approval.id },
+                    data: {
+                        approver_user_id: userId || approval.approver_user_id || null,
+                        status: 'approved',
+                        decided_at: approvedAt,
+                        decision_note: this.normalizeOptionalText(data.note),
+                    },
+                });
+            }
+            else {
+                await tx.proposal_approval.create({
+                    data: {
+                        proposal_id: id,
+                        proposal_revision_id: currentRevision.id,
+                        requester_user_id: null,
+                        approver_user_id: userId || null,
+                        step_order: 1,
+                        status: 'approved',
+                        submitted_at: approvedAt,
+                        decided_at: approvedAt,
+                        decision_note: this.normalizeOptionalText(data.note),
+                    },
+                });
+            }
+            await tx.proposal_revision.update({
+                where: { id: currentRevision.id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.APPROVED,
+                    approved_at: approvedAt,
+                },
+            });
+            await tx.proposal.update({
+                where: { id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.APPROVED,
+                    approved_at: approvedAt,
+                    approved_by_user_id: userId || null,
+                    updated_by_user_id: userId || null,
+                },
+            });
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.APPROVED, id, locale, userId || null, {
+                note: this.normalizeOptionalText(data.note),
+            });
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.CONVERT_REQUESTED, id, locale, userId || null, {
+                note: this.normalizeOptionalText(data.note),
+                metadata: {
+                    trigger: 'approval',
+                },
+            });
+        });
+        await this.syncPersonDealValueFromApprovedProposals(this.prisma, current.person_id);
+        return this.getById(id, locale);
+    }
+    async reject(id, data, locale, userId) {
+        const current = await this.loadProposalDetail(this.prisma, id);
+        if (!current) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.REJECTED ||
+            current.status === proposal_dto_1.ProposalStatus.CANCELLED ||
+            current.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+            return this.getById(id, locale);
+        }
+        if (current.status !== proposal_dto_1.ProposalStatus.PENDING_APPROVAL) {
+            throw new common_1.BadRequestException('Only proposals pending approval can be rejected.');
+        }
+        await this.prisma.$transaction(async (tx) => {
+            const lockedProposal = await this.lockProposalForTransition(tx, id);
+            if (!lockedProposal) {
+                throw new common_1.NotFoundException('Proposal not found.');
+            }
+            if (lockedProposal.status === proposal_dto_1.ProposalStatus.REJECTED ||
+                lockedProposal.status === proposal_dto_1.ProposalStatus.CANCELLED ||
+                lockedProposal.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+                return;
+            }
+            if (lockedProposal.status !== proposal_dto_1.ProposalStatus.PENDING_APPROVAL) {
+                throw new common_1.BadRequestException('Only proposals pending approval can be rejected.');
+            }
+            const currentRevision = this.getCurrentProposalRevision(lockedProposal);
+            if (!currentRevision) {
+                throw new common_1.NotFoundException('Current proposal revision not found.');
+            }
+            const approval = await tx.proposal_approval.findFirst({
+                where: {
+                    proposal_id: id,
+                    proposal_revision_id: currentRevision.id,
+                    deleted_at: null,
+                    step_order: 1,
+                },
+            });
+            const decidedAt = new Date();
+            if (approval) {
+                await tx.proposal_approval.update({
+                    where: { id: approval.id },
+                    data: {
+                        approver_user_id: userId || approval.approver_user_id || null,
+                        status: 'rejected',
+                        decided_at: decidedAt,
+                        decision_note: this.normalizeOptionalText(data.note),
+                    },
+                });
+            }
+            else {
+                await tx.proposal_approval.create({
+                    data: {
+                        proposal_id: id,
+                        proposal_revision_id: currentRevision.id,
+                        requester_user_id: null,
+                        approver_user_id: userId || null,
+                        step_order: 1,
+                        status: 'rejected',
+                        submitted_at: decidedAt,
+                        decided_at: decidedAt,
+                        decision_note: this.normalizeOptionalText(data.note),
+                    },
+                });
+            }
+            await tx.proposal_revision.update({
+                where: { id: currentRevision.id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.REJECTED,
+                },
+            });
+            await tx.proposal.update({
+                where: { id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.REJECTED,
+                    updated_by_user_id: userId || null,
+                },
+            });
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.REJECTED, id, locale, userId || null, {
+                note: this.normalizeOptionalText(data.note),
+            });
+        });
+        await this.syncPersonDealValueFromApprovedProposals(this.prisma, current.person_id);
+        return this.getById(id, locale);
+    }
+    async cancel(id, data, locale, userId) {
+        const current = await this.loadProposalDetail(this.prisma, id);
+        if (!current) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.CANCELLED) {
+            return this.getById(id, locale);
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+            throw new common_1.BadRequestException('Converted proposals can no longer be cancelled.');
+        }
+        await this.prisma.$transaction(async (tx) => {
+            const currentRevision = await tx.proposal_revision.findFirst({
+                where: {
+                    proposal_id: id,
+                    deleted_at: null,
+                    is_current: true,
+                },
+                orderBy: {
+                    revision_number: 'desc',
+                },
+            });
+            if (!currentRevision) {
+                throw new common_1.NotFoundException('Current proposal revision not found.');
+            }
+            await tx.proposal_revision.update({
+                where: { id: currentRevision.id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.CANCELLED,
+                },
+            });
+            await tx.proposal_approval.updateMany({
+                where: {
+                    proposal_id: id,
+                    proposal_revision_id: currentRevision.id,
+                    deleted_at: null,
+                    status: 'pending',
+                },
+                data: {
+                    status: 'cancelled',
+                    decided_at: new Date(),
+                    decision_note: this.normalizeOptionalText(data.note),
+                },
+            });
+            await tx.proposal.update({
+                where: { id },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.CANCELLED,
+                    updated_by_user_id: userId || null,
+                },
+            });
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.CANCELLED, id, locale, userId || null, {
+                note: this.normalizeOptionalText(data.note),
+                metadata: {
+                    trigger: 'manual_cancel',
+                },
+            });
+        });
+        await this.syncPersonDealValueFromApprovedProposals(this.prisma, current.person_id);
+        return this.getById(id, locale);
+    }
+    async requestConversion(id, data, locale, userId) {
+        var _a, _b;
+        const current = await this.loadProposalDetail(this.prisma, id);
+        if (!current) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+            return this.getById(id, locale);
+        }
+        if (current.status !== proposal_dto_1.ProposalStatus.APPROVED) {
+            throw new common_1.BadRequestException('Only approved proposals can request conversion.');
+        }
+        this.assertProposalWorkflowReadiness(current, 'converted to contracts');
+        const existingLinks = await this.integrationApi.findLinksBySource({
+            module: 'contact',
+            entityType: 'proposal',
+            entityId: String(id),
+        });
+        const existingContractLink = existingLinks.find((link) => link.targetModule === 'operations' &&
+            link.targetEntityType === 'contract');
+        if (existingContractLink) {
+            this.logger.debug(`[proposal-event] conversion already linked for proposal ${id} -> contract ${existingContractLink.targetEntityId}`);
+            return this.markConvertedFromIntegration({
+                proposalId: id,
+                locale,
+                createdByUserId: userId || null,
+                correlationId: `proposal:${id}:v${current.current_revision_number || 1}`,
+                contractId: Number(existingContractLink.targetEntityId || 0) || null,
+                contract: {
+                    id: Number(existingContractLink.targetEntityId || 0) || null,
+                    code: (_b = (_a = existingContractLink.metadata) === null || _a === void 0 ? void 0 : _a.contractCode) !== null && _b !== void 0 ? _b : null,
+                    name: null,
+                    status: 'draft',
+                    url: null,
+                },
+            });
+        }
+        await this.prisma.$transaction(async (tx) => {
+            const lockedProposal = await this.lockProposalForTransition(tx, id);
+            if (!lockedProposal) {
+                throw new common_1.NotFoundException('Proposal not found.');
+            }
+            if (lockedProposal.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+                return;
+            }
+            if (lockedProposal.status !== proposal_dto_1.ProposalStatus.APPROVED) {
+                throw new common_1.BadRequestException('Only approved proposals can request conversion.');
+            }
+            this.assertProposalWorkflowReadiness(lockedProposal, 'converted to contracts');
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.CONVERT_REQUESTED, id, locale, userId || null, {
+                note: this.normalizeOptionalText(data.note),
+                metadata: {
+                    trigger: 'manual_conversion_request',
+                },
+            });
+        });
+        return this.getById(id, locale);
+    }
+    async markConvertedFromIntegration(payload) {
+        var _a, _b;
+        const proposalId = Number((payload === null || payload === void 0 ? void 0 : payload.proposalId) || ((_a = payload === null || payload === void 0 ? void 0 : payload.contract) === null || _a === void 0 ? void 0 : _a.originId) || 0);
+        if (!Number.isInteger(proposalId) || proposalId <= 0) {
+            this.logger.warn('[proposal-event] ignoring conversion callback without a valid proposalId');
+            return null;
+        }
+        const locale = String((payload === null || payload === void 0 ? void 0 : payload.locale) || 'en').trim() || 'en';
+        const current = await this.loadProposalDetail(this.prisma, proposalId);
+        if (!current) {
+            this.logger.warn(`[proposal-event] proposal ${proposalId} was not found when marking it as converted`);
+            return null;
+        }
+        if (current.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+            this.logger.debug(`[proposal-event] proposal ${proposalId} is already marked as converted`);
+            return this.getById(proposalId, locale);
+        }
+        const contractId = Number((payload === null || payload === void 0 ? void 0 : payload.contractId) || ((_b = payload === null || payload === void 0 ? void 0 : payload.contract) === null || _b === void 0 ? void 0 : _b.id) || 0);
+        const actorUserId = Number((payload === null || payload === void 0 ? void 0 : payload.createdByUserId) || (payload === null || payload === void 0 ? void 0 : payload.activatedByUserId) || 0) ||
+            null;
+        await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const lockedProposal = await this.lockProposalForTransition(tx, proposalId);
+            if (!lockedProposal) {
+                this.logger.warn(`[proposal-event] proposal ${proposalId} was not found when locking it for conversion`);
+                return;
+            }
+            if (lockedProposal.status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+                return;
+            }
+            const previousStatus = String(lockedProposal.status || proposal_dto_1.ProposalStatus.DRAFT);
+            await tx.proposal.update({
+                where: { id: proposalId },
+                data: {
+                    status: proposal_dto_1.ProposalStatus.CONTRACT_GENERATED,
+                    contract_generated_at: new Date(),
+                    updated_by_user_id: actorUserId,
+                },
+            });
+            await this.publishProposalLifecycleEvent(tx, proposal_event_types_1.PROPOSAL_EVENT_NAMES.CONVERTED, proposalId, locale, actorUserId, {
+                contract: {
+                    contractId: Number.isInteger(contractId) && contractId > 0 ? contractId : null,
+                    code: (_b = (_a = payload === null || payload === void 0 ? void 0 : payload.contract) === null || _a === void 0 ? void 0 : _a.code) !== null && _b !== void 0 ? _b : null,
+                    name: (_d = (_c = payload === null || payload === void 0 ? void 0 : payload.contract) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : null,
+                    status: (_f = (_e = payload === null || payload === void 0 ? void 0 : payload.contract) === null || _e === void 0 ? void 0 : _e.status) !== null && _f !== void 0 ? _f : 'draft',
+                    url: (_h = (_g = payload === null || payload === void 0 ? void 0 : payload.contract) === null || _g === void 0 ? void 0 : _g.url) !== null && _h !== void 0 ? _h : null,
+                },
+                correlationId: (payload === null || payload === void 0 ? void 0 : payload.correlationId) || null,
+                metadata: {
+                    trigger: 'operations.contract.created',
+                    previousStatus,
+                    contractId: Number.isInteger(contractId) && contractId > 0 ? contractId : null,
+                },
+            });
+        });
+        await this.syncPersonDealValueFromApprovedProposals(this.prisma, current.person_id);
+        return this.getById(proposalId, locale);
+    }
+    async generateDocument(id, locale, userId) {
+        var _a, _b, _c;
+        const proposal = await this.loadProposalDetail(this.prisma, id);
+        if (!proposal) {
+            throw new common_1.NotFoundException((0, api_locale_1.getLocaleText)('itemNotFound', locale, 'Proposal not found'));
+        }
+        this.assertProposalDocumentReadiness(proposal);
+        const currentRevision = this.getCurrentProposalRevision(proposal);
+        if (!(currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.id)) {
+            throw new common_1.NotFoundException('Current proposal revision not found.');
+        }
+        const html = await this.buildProposalDocumentHtml(proposal, locale);
+        const pdfBuffer = await this.renderProposalPdfBuffer(proposal, locale, html);
+        const fileName = this.buildProposalDocumentFileName(proposal, currentRevision);
+        const uploadedFile = await this.fileService.upload('contact/proposals/generated', {
+            fieldname: 'file',
+            originalname: fileName,
+            encoding: '7bit',
+            mimetype: 'application/pdf',
+            size: pdfBuffer.length,
+            destination: '',
+            filename: fileName,
+            path: '',
+            buffer: pdfBuffer,
+        });
+        const generatedAt = new Date().toISOString();
+        let renderVersion = 1;
+        await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c;
+            const lockedProposal = await this.lockProposalForTransition(tx, id);
+            if (!lockedProposal) {
+                throw new common_1.NotFoundException('Proposal not found.');
+            }
+            this.assertProposalDocumentReadiness(lockedProposal);
+            const lockedRevision = this.getCurrentProposalRevision(lockedProposal);
+            if (!(lockedRevision === null || lockedRevision === void 0 ? void 0 : lockedRevision.id)) {
+                throw new common_1.NotFoundException('Current proposal revision not found.');
+            }
+            renderVersion = await this.upsertGeneratedProposalDocument(tx, lockedProposal.id, lockedRevision, {
+                fileId: uploadedFile.id,
+                fileName,
+                mimeType: 'application/pdf',
+                html,
+                uploadedByUserId: Number(userId) || null,
+            });
+            await tx.proposal_revision.update({
+                where: { id: lockedRevision.id },
+                data: {
+                    snapshot_json: this.mergeProposalRevisionSnapshot(lockedRevision.snapshot_json, {
+                        commercialDocument: {
+                            template: 'proposal-commercial-v1',
+                            proposalId: lockedProposal.id,
+                            proposalRevisionId: lockedRevision.id,
+                            revisionNumber: Number(lockedRevision.revision_number ||
+                                lockedProposal.current_revision_number ||
+                                1) || 1,
+                            renderVersion,
+                            generatedAt,
+                            generatedByUserId: Number(userId) || null,
+                            fileId: uploadedFile.id,
+                            fileName,
+                            mimeType: 'application/pdf',
+                            acceptance: {
+                                status: 'pending',
+                                acceptedAt: null,
+                                acceptedByName: ((_a = lockedProposal.person) === null || _a === void 0 ? void 0 : _a.trade_name) ||
+                                    ((_b = lockedProposal.person) === null || _b === void 0 ? void 0 : _b.name) ||
+                                    null,
+                                acceptedByEmail: ((_c = lockedProposal.person) === null || _c === void 0 ? void 0 : _c.email) || null,
+                            },
+                        },
+                    }),
+                },
+            });
+        });
+        return {
+            proposalId: proposal.id,
+            proposalRevisionId: currentRevision.id,
+            version: Number(currentRevision.revision_number || proposal.current_revision_number || 1) ||
+                1,
+            renderVersion,
+            fileId: uploadedFile.id,
+            fileName,
+            mimeType: 'application/pdf',
+            documentType: 'generated_pdf',
+            downloadUrl: `/file/open/${uploadedFile.id}`,
+            html,
+            acceptance: {
+                status: 'pending',
+                acceptedAt: null,
+                expectedSignerName: ((_a = proposal.person) === null || _a === void 0 ? void 0 : _a.trade_name) || ((_b = proposal.person) === null || _b === void 0 ? void 0 : _b.name) || null,
+                expectedSignerEmail: ((_c = proposal.person) === null || _c === void 0 ? void 0 : _c.email) || null,
+            },
+        };
+    }
+    async remove(data, locale, userId) {
+        const ids = Array.isArray(data === null || data === void 0 ? void 0 : data.ids)
+            ? data.ids.map((value) => Number(value)).filter((value) => value > 0)
+            : [];
+        if (ids.length === 0) {
+            throw new common_1.BadRequestException((0, api_locale_1.getLocaleText)('validation.idsMustBeArray', locale, 'No valid proposal ids were informed'));
+        }
+        const impactedProposals = await this.prisma.proposal.findMany({
+            where: {
+                id: { in: ids },
+                deleted_at: null,
+            },
+            select: {
+                id: true,
+                person_id: true,
+            },
+        });
+        const impactedPersonIds = Array.from(new Set(impactedProposals
+            .map((proposal) => Number((proposal === null || proposal === void 0 ? void 0 : proposal.person_id) || 0))
+            .filter((personId) => personId > 0)));
+        await this.prisma.$transaction(async (tx) => {
+            const now = new Date();
+            await tx.proposal.updateMany({
+                where: {
+                    id: { in: ids },
+                    deleted_at: null,
+                },
+                data: {
+                    deleted_at: now,
+                    updated_by_user_id: userId || null,
+                },
+            });
+            await tx.proposal_revision.updateMany({
+                where: {
+                    proposal_id: { in: ids },
+                    deleted_at: null,
+                },
+                data: {
+                    deleted_at: now,
+                },
+            });
+            await tx.proposal_item.updateMany({
+                where: {
+                    proposal_revision: {
+                        proposal_id: { in: ids },
+                    },
+                    deleted_at: null,
+                },
+                data: {
+                    deleted_at: now,
+                },
+            });
+            await tx.proposal_document.updateMany({
+                where: {
+                    proposal_id: { in: ids },
+                    deleted_at: null,
+                },
+                data: {
+                    deleted_at: now,
+                    is_current: false,
+                },
+            });
+            await tx.proposal_approval.updateMany({
+                where: {
+                    proposal_id: { in: ids },
+                    deleted_at: null,
+                },
+                data: {
+                    deleted_at: now,
+                },
+            });
+        });
+        await Promise.all(impactedPersonIds.map((personId) => this.syncPersonDealValueFromApprovedProposals(this.prisma, personId)));
+        return {
+            deleted: ids.length,
+            ids,
+        };
+    }
+    async publishProposalLifecycleEvent(client, eventName, proposalId, locale, userId, extras) {
+        const proposal = await this.loadProposalIntegrationSnapshot(client, proposalId);
+        const payload = this.buildProposalLifecyclePayload(proposal, eventName, locale, userId !== null && userId !== void 0 ? userId : null, extras);
+        const recentEvents = await client.outbox_event.findMany({
+            where: {
+                event_name: eventName,
+                source_module: 'contact',
+                aggregate_type: 'proposal',
+                aggregate_id: String(proposalId),
+            },
+            select: {
+                id: true,
+                status: true,
+                payload: true,
+            },
+            orderBy: {
+                id: 'desc',
+            },
+            take: 25,
+        });
+        const duplicated = recentEvents.some((event) => {
+            var _a;
+            return ((_a = event === null || event === void 0 ? void 0 : event.payload) === null || _a === void 0 ? void 0 : _a.eventKey) === payload.eventKey &&
+                !['failed', 'dead_letter'].includes(String((event === null || event === void 0 ? void 0 : event.status) || ''));
+        });
+        if (duplicated) {
+            this.logger.warn(`[proposal-event] skipped duplicate ${eventName} for proposal ${proposalId} (${payload.eventKey})`);
+            return null;
+        }
+        const outboxEvent = await this.integrationApi.publishEvent({
+            eventName,
+            sourceModule: 'contact',
+            aggregateType: 'proposal',
+            aggregateId: String(proposalId),
+            payload,
+            metadata: Object.assign({ producer: 'contact', correlationId: payload.correlationId, eventKey: payload.eventKey, sourceModule: 'contact', sourceEntity: 'proposal', sourceId: String(proposalId), locale, triggeredByUserId: userId !== null && userId !== void 0 ? userId : null }, ((extras === null || extras === void 0 ? void 0 : extras.metadata) || {})),
+        }, {
+            persistenceClient: client,
+        });
+        this.logger.log(`[proposal-event] queued ${eventName} for proposal ${proposalId} as outbox ${outboxEvent.id}`);
+        return outboxEvent;
+    }
+    buildProposalLifecyclePayload(proposal, eventName, locale, userId, extras) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17;
+        const currentRevision = (_b = (_a = proposal.proposal_revision) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : null;
+        const items = ((currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.proposal_item) || []).map((item) => {
+            var _a, _b, _c, _d, _e;
+            return ({
+                id: Number(item.id || 0) || null,
+                name: item.name,
+                description: (_a = item.description) !== null && _a !== void 0 ? _a : null,
+                itemType: (_b = item.item_type) !== null && _b !== void 0 ? _b : null,
+                termType: (_c = item.term_type) !== null && _c !== void 0 ? _c : null,
+                quantity: Number(item.quantity || 1),
+                unitAmountCents: Number(item.unit_amount_cents || 0),
+                totalAmountCents: Number(item.total_amount_cents || 0),
+                amount: Number(item.total_amount_cents || 0) / 100,
+                recurrence: (_d = item.recurrence) !== null && _d !== void 0 ? _d : null,
+                dueDay: (_e = item.due_day) !== null && _e !== void 0 ? _e : null,
+            });
+        });
+        const version = Number((currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.revision_number) || proposal.current_revision_number || 1);
+        const correlationId = (extras === null || extras === void 0 ? void 0 : extras.correlationId) || `proposal:${proposal.id}:v${version}`;
+        const contractId = (_d = (_c = extras === null || extras === void 0 ? void 0 : extras.contract) === null || _c === void 0 ? void 0 : _c.contractId) !== null && _d !== void 0 ? _d : null;
+        const eventKeyParts = [eventName, String(proposal.id), `v${version}`];
+        if (contractId) {
+            eventKeyParts.push(`contract:${contractId}`);
+        }
+        const personId = Number(proposal.person_id || ((_e = proposal.person) === null || _e === void 0 ? void 0 : _e.id) || 0) || null;
+        const companyId = String(((_f = proposal.person) === null || _f === void 0 ? void 0 : _f.type) || '') === 'company' ? personId : null;
+        return {
+            eventName,
+            eventKey: eventKeyParts.join(':'),
+            correlationId,
+            proposalId: proposal.id,
+            proposalRevisionId: (_g = currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.id) !== null && _g !== void 0 ? _g : null,
+            approvedByUserId: userId !== null && userId !== void 0 ? userId : null,
+            dealId: personId,
+            personId,
+            companyId,
+            customerIds: {
+                personId,
+                companyId,
+            },
+            code: (_h = proposal.code) !== null && _h !== void 0 ? _h : null,
+            title: (_k = (_j = proposal.title) !== null && _j !== void 0 ? _j : currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.title) !== null && _k !== void 0 ? _k : null,
+            version,
+            status: (_m = (_l = proposal.status) !== null && _l !== void 0 ? _l : currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.status) !== null && _m !== void 0 ? _m : null,
+            approvedAt: proposal.approved_at
+                ? new Date(proposal.approved_at).toISOString()
+                : (currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.approved_at)
+                    ? new Date(currentRevision.approved_at).toISOString()
+                    : null,
+            validUntil: proposal.valid_until
+                ? new Date(proposal.valid_until).toISOString()
+                : (currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.valid_until)
+                    ? new Date(currentRevision.valid_until).toISOString()
+                    : null,
+            currency: (_o = proposal.currency_code) !== null && _o !== void 0 ? _o : 'BRL',
+            proposal: {
+                code: (_p = proposal.code) !== null && _p !== void 0 ? _p : null,
+                title: (_r = (_q = proposal.title) !== null && _q !== void 0 ? _q : currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.title) !== null && _r !== void 0 ? _r : null,
+                status: (_t = (_s = proposal.status) !== null && _s !== void 0 ? _s : currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.status) !== null && _t !== void 0 ? _t : null,
+                contractCategory: (_u = proposal.contract_category) !== null && _u !== void 0 ? _u : null,
+                contractType: (_v = proposal.contract_type) !== null && _v !== void 0 ? _v : null,
+                billingModel: (_w = proposal.billing_model) !== null && _w !== void 0 ? _w : null,
+                currencyCode: (_x = proposal.currency_code) !== null && _x !== void 0 ? _x : 'BRL',
+                validFrom: proposal.valid_from
+                    ? new Date(proposal.valid_from).toISOString()
+                    : null,
+                validUntil: proposal.valid_until
+                    ? new Date(proposal.valid_until).toISOString()
+                    : (currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.valid_until)
+                        ? new Date(currentRevision.valid_until).toISOString()
+                        : null,
+                subtotalAmountCents: Number(proposal.subtotal_amount_cents || 0),
+                discountAmountCents: Number(proposal.discount_amount_cents || 0),
+                taxAmountCents: Number(proposal.tax_amount_cents || 0),
+                totalAmountCents: Number(proposal.total_amount_cents || 0),
+                totalAmount: Number(proposal.total_amount_cents || 0) / 100,
+                notes: (_z = (_y = extras === null || extras === void 0 ? void 0 : extras.note) !== null && _y !== void 0 ? _y : proposal.notes) !== null && _z !== void 0 ? _z : null,
+            },
+            subtotal: Number(proposal.subtotal_amount_cents || 0) / 100,
+            subtotalCents: Number(proposal.subtotal_amount_cents || 0),
+            discount: Number(proposal.discount_amount_cents || 0) / 100,
+            discountCents: Number(proposal.discount_amount_cents || 0),
+            tax: Number(proposal.tax_amount_cents || 0) / 100,
+            taxCents: Number(proposal.tax_amount_cents || 0),
+            total: Number(proposal.total_amount_cents || 0) / 100,
+            totalCents: Number(proposal.total_amount_cents || 0),
+            commercialTerms: {
+                contractCategory: (_0 = proposal.contract_category) !== null && _0 !== void 0 ? _0 : null,
+                contractType: (_1 = proposal.contract_type) !== null && _1 !== void 0 ? _1 : null,
+                billingModel: (_2 = proposal.billing_model) !== null && _2 !== void 0 ? _2 : null,
+                validFrom: proposal.valid_from
+                    ? new Date(proposal.valid_from).toISOString()
+                    : null,
+                validUntil: proposal.valid_until
+                    ? new Date(proposal.valid_until).toISOString()
+                    : (currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.valid_until)
+                        ? new Date(currentRevision.valid_until).toISOString()
+                        : null,
+                summary: (_3 = currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.summary) !== null && _3 !== void 0 ? _3 : null,
+                notes: (_5 = (_4 = extras === null || extras === void 0 ? void 0 : extras.note) !== null && _4 !== void 0 ? _4 : proposal.notes) !== null && _5 !== void 0 ? _5 : null,
+            },
+            itemsSummary: items,
+            items,
+            person: proposal.person
+                ? {
+                    id: (_6 = proposal.person.id) !== null && _6 !== void 0 ? _6 : null,
+                    name: (_7 = proposal.person.name) !== null && _7 !== void 0 ? _7 : null,
+                    tradeName: (_8 = proposal.person.trade_name) !== null && _8 !== void 0 ? _8 : null,
+                    email: (_9 = proposal.person.email) !== null && _9 !== void 0 ? _9 : null,
+                    phone: (_10 = proposal.person.phone) !== null && _10 !== void 0 ? _10 : null,
+                    document: (_11 = proposal.person.document) !== null && _11 !== void 0 ? _11 : null,
+                    type: (_12 = proposal.person.type) !== null && _12 !== void 0 ? _12 : null,
+                }
+                : null,
+            revision: currentRevision
+                ? {
+                    id: (_13 = currentRevision.id) !== null && _13 !== void 0 ? _13 : null,
+                    revisionNumber: version,
+                    title: (_14 = currentRevision.title) !== null && _14 !== void 0 ? _14 : null,
+                    summary: (_15 = currentRevision.summary) !== null && _15 !== void 0 ? _15 : null,
+                    contentHtml: (_16 = currentRevision.content_html) !== null && _16 !== void 0 ? _16 : null,
+                    submittedAt: currentRevision.submitted_at
+                        ? new Date(currentRevision.submitted_at).toISOString()
+                        : null,
+                    approvedAt: currentRevision.approved_at
+                        ? new Date(currentRevision.approved_at).toISOString()
+                        : null,
+                }
+                : null,
+            contract: (_17 = extras === null || extras === void 0 ? void 0 : extras.contract) !== null && _17 !== void 0 ? _17 : null,
+            triggeredByUserId: userId !== null && userId !== void 0 ? userId : null,
+            emittedAt: new Date().toISOString(),
+            locale: locale || null,
+            sourceModule: 'contact',
+            sourceEntity: 'proposal',
+            sourceId: String(proposal.id),
+            source_module: 'contact',
+            source_entity: 'proposal',
+            source_id: String(proposal.id),
+        };
+    }
+    async assertPersonExists(personId, locale) {
+        const person = await this.prisma.person.findUnique({
+            where: { id: Number(personId) },
+            select: { id: true },
+        });
+        if (!person) {
+            throw new common_1.BadRequestException((0, api_locale_1.getLocaleText)('personNotFound', locale, 'Person not found'));
+        }
+    }
+    async syncPersonDealValueFromApprovedProposals(client, personId) {
+        var _a;
+        const normalizedPersonId = Number(personId || 0);
+        if (!Number.isInteger(normalizedPersonId) || normalizedPersonId <= 0) {
+            return;
+        }
+        const aggregation = await client.proposal.aggregate({
+            where: {
+                deleted_at: null,
+                person_id: normalizedPersonId,
+                status: {
+                    in: [proposal_dto_1.ProposalStatus.APPROVED, proposal_dto_1.ProposalStatus.CONTRACT_GENERATED],
+                },
+            },
+            _sum: {
+                total_amount_cents: true,
+            },
+        });
+        const totalAmountCents = Number(((_a = aggregation === null || aggregation === void 0 ? void 0 : aggregation._sum) === null || _a === void 0 ? void 0 : _a.total_amount_cents) || 0);
+        const dealValue = totalAmountCents > 0 ? (totalAmountCents / 100).toFixed(2) : null;
+        await this.upsertPersonMetadataValue(client, normalizedPersonId, 'deal_value', dealValue);
+    }
+    async upsertPersonMetadataValue(client, personId, key, value) {
+        if (!client.person_metadata) {
+            return;
+        }
+        const existing = await client.person_metadata.findFirst({
+            where: {
+                person_id: personId,
+                key,
+            },
+            select: { id: true },
+        });
+        const normalizedValue = this.normalizePersonMetadataValue(value);
+        if (normalizedValue == null) {
+            if (existing) {
+                await client.person_metadata.delete({
+                    where: { id: existing.id },
+                });
+            }
+            return;
+        }
+        if (existing) {
+            await client.person_metadata.update({
+                where: { id: existing.id },
+                data: { value: normalizedValue },
+            });
+            return;
+        }
+        await client.person_metadata.create({
+            data: {
+                person_id: personId,
+                key,
+                value: normalizedValue,
+            },
+        });
+    }
+    normalizePersonMetadataValue(value) {
+        if (value == null)
+            return null;
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
+        if (typeof value === 'number') {
+            return Number.isFinite(value) ? value : null;
+        }
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        if (Array.isArray(value) || typeof value === 'object') {
+            try {
+                return JSON.parse(JSON.stringify(value));
+            }
+            catch (_a) {
+                return null;
+            }
+        }
+        return null;
+    }
+    async resolveProposalCode(code) {
+        var _a;
+        const normalized = (_a = this.normalizeOptionalText(code)) === null || _a === void 0 ? void 0 : _a.toUpperCase();
+        if (normalized) {
+            const existing = await this.prisma.proposal.findFirst({
+                where: {
+                    code: normalized,
+                },
+                select: { id: true },
+            });
+            if (existing) {
+                throw new common_1.BadRequestException('Proposal code already exists.');
+            }
+            return normalized;
+        }
+        for (let attempt = 0; attempt < 5; attempt++) {
+            const stamp = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+            const generated = `PROP-${stamp}-${Math.floor(1000 + Math.random() * 9000)}`;
+            const existing = await this.prisma.proposal.findFirst({
+                where: { code: generated },
+                select: { id: true },
+            });
+            if (!existing) {
+                return generated;
+            }
+        }
+        return `PROP-${Date.now()}`;
+    }
+    normalizeItems(items) {
+        return (items || []).map((item) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const quantity = Number((_a = item.quantity) !== null && _a !== void 0 ? _a : 1);
+            const unitAmountCents = Number((_b = item.unit_amount_cents) !== null && _b !== void 0 ? _b : 0);
+            const totalAmountCents = Number.isFinite(Number(item.total_amount_cents))
+                ? Number(item.total_amount_cents)
+                : Math.round(quantity * unitAmountCents);
+            return {
+                item_type: (_c = item.item_type) !== null && _c !== void 0 ? _c : 'service',
+                term_type: (_d = item.term_type) !== null && _d !== void 0 ? _d : 'value',
+                name: item.name.trim(),
+                description: this.normalizeOptionalText(item.description),
+                quantity,
+                unit_amount_cents: unitAmountCents,
+                total_amount_cents: totalAmountCents,
+                recurrence: (_e = item.recurrence) !== null && _e !== void 0 ? _e : 'one_time',
+                due_day: (_f = item.due_day) !== null && _f !== void 0 ? _f : null,
+                start_date: (_g = item.start_date) !== null && _g !== void 0 ? _g : null,
+                end_date: (_h = item.end_date) !== null && _h !== void 0 ? _h : null,
+                metadata_json: (_j = item.metadata_json) !== null && _j !== void 0 ? _j : null,
+            };
+        });
+    }
+    normalizeDocuments(documents, proposalId, proposalRevisionId, uploadedByUserId) {
+        return (documents || []).map((document) => {
+            var _a, _b, _c, _d;
+            return ({
+                proposal_id: proposalId,
+                proposal_revision_id: proposalRevisionId,
+                document_type: (_a = document.document_type) !== null && _a !== void 0 ? _a : 'attachment',
+                file_id: (_b = document.file_id) !== null && _b !== void 0 ? _b : null,
+                file_name: document.file_name.trim(),
+                mime_type: document.mime_type.trim(),
+                file_content_base64: this.normalizeOptionalText(document.file_content_base64),
+                is_current: true,
+                source_kind: (_c = document.source_kind) !== null && _c !== void 0 ? _c : 'manual',
+                extraction_status: (_d = document.extraction_status) !== null && _d !== void 0 ? _d : 'skipped',
+                extraction_summary: this.normalizeOptionalText(document.extraction_summary),
+                notes: this.normalizeOptionalText(document.notes),
+                uploaded_by_user_id: uploadedByUserId,
+            });
+        });
+    }
+    resolveTotals(data, normalizedItems) {
+        const computed = normalizedItems.reduce((acc, item) => {
+            const amount = Number(item.total_amount_cents || 0);
+            if (item.item_type === 'discount') {
+                acc.discount += Math.abs(amount);
+            }
+            else {
+                acc.subtotal += amount;
+            }
+            return acc;
+        }, { subtotal: 0, discount: 0 });
+        const subtotalAmountCents = Number.isFinite(Number(data.subtotal_amount_cents))
+            ? Number(data.subtotal_amount_cents)
+            : computed.subtotal;
+        const discountAmountCents = Number.isFinite(Number(data.discount_amount_cents))
+            ? Number(data.discount_amount_cents)
+            : computed.discount;
+        const taxAmountCents = Number.isFinite(Number(data.tax_amount_cents))
+            ? Number(data.tax_amount_cents)
+            : 0;
+        const totalAmountCents = Number.isFinite(Number(data.total_amount_cents))
+            ? Number(data.total_amount_cents)
+            : subtotalAmountCents - discountAmountCents + taxAmountCents;
+        return {
+            subtotal_amount_cents: subtotalAmountCents,
+            discount_amount_cents: discountAmountCents,
+            tax_amount_cents: taxAmountCents,
+            total_amount_cents: totalAmountCents,
+        };
+    }
+    getCurrentProposalRevision(proposal) {
+        var _a, _b, _c, _d;
+        return ((_d = (_b = (_a = proposal === null || proposal === void 0 ? void 0 : proposal.proposal_revision) === null || _a === void 0 ? void 0 : _a.find((revision) => revision === null || revision === void 0 ? void 0 : revision.is_current)) !== null && _b !== void 0 ? _b : (_c = proposal === null || proposal === void 0 ? void 0 : proposal.proposal_revision) === null || _c === void 0 ? void 0 : _c[0]) !== null && _d !== void 0 ? _d : null);
+    }
+    assertProposalDocumentReadiness(proposal) {
+        const currentRevision = this.getCurrentProposalRevision(proposal);
+        if (!currentRevision) {
+            throw new common_1.NotFoundException('Current proposal revision not found.');
+        }
+        const revisionItems = Array.isArray(currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.proposal_item)
+            ? currentRevision.proposal_item.filter((item) => item && item.deleted_at == null)
+            : [];
+        const hasPositiveTotal = Number((proposal === null || proposal === void 0 ? void 0 : proposal.total_amount_cents) || 0) > 0;
+        if (revisionItems.length === 0 && !hasPositiveTotal) {
+            throw new common_1.BadRequestException('Proposals without items or value cannot generate a commercial document.');
+        }
+    }
+    async upsertGeneratedProposalDocument(client, proposalId, proposalRevision, document) {
+        var _a, _b;
+        const renderVersion = (await client.proposal_document.count({
+            where: {
+                proposal_id: proposalId,
+                proposal_revision_id: proposalRevision.id,
+                document_type: 'generated_pdf',
+                deleted_at: null,
+            },
+        })) + 1;
+        await client.proposal_document.updateMany({
+            where: {
+                proposal_id: proposalId,
+                proposal_revision_id: proposalRevision.id,
+                document_type: 'generated_pdf',
+                deleted_at: null,
+            },
+            data: {
+                is_current: false,
+            },
+        });
+        await client.proposal_document.create({
+            data: {
+                proposal_id: proposalId,
+                proposal_revision_id: proposalRevision.id,
+                document_type: 'generated_pdf',
+                file_id: (_a = document.fileId) !== null && _a !== void 0 ? _a : null,
+                file_name: document.fileName,
+                mime_type: document.mimeType,
+                file_content_base64: Buffer.from(document.html, 'utf8').toString('base64'),
+                is_current: true,
+                source_kind: 'generated',
+                extraction_status: 'skipped',
+                extraction_summary: `Commercial proposal render version ${renderVersion}.`,
+                notes: 'Commercial proposal PDF generated from proposal data. The base64 snapshot stores the rendered HTML source for preview and future electronic acceptance.',
+                uploaded_by_user_id: (_b = document.uploadedByUserId) !== null && _b !== void 0 ? _b : null,
+            },
+        });
+        return renderVersion;
+    }
+    async renderProposalPdfBuffer(proposal, locale, html) {
+        var _a, _b, _c;
+        const renderedHtml = html !== null && html !== void 0 ? html : (await this.buildProposalDocumentHtml(proposal, locale));
+        let browser = null;
+        try {
+            const importPlaywright = new Function('moduleName', 'return import(moduleName);');
+            const playwright = await importPlaywright('playwright');
+            browser = await playwright.chromium.launch({ headless: true });
+            const page = await browser.newPage();
+            await page.setContent(renderedHtml, { waitUntil: 'networkidle' });
+            return Buffer.from(await page.pdf({
+                format: 'A4',
+                printBackground: true,
+                margin: {
+                    top: '72px',
+                    right: '18px',
+                    bottom: '56px',
+                    left: '18px',
+                },
+            }));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const errorStack = error instanceof Error ? ((_a = error.stack) !== null && _a !== void 0 ? _a : error.message) : String(error);
+            const missingPlaywrightRuntime = /Cannot find package ['"]playwright['"]|Cannot find module ['"]playwright['"]|Executable doesn't exist|browserType\.launch|Failed to launch|Please run the following command to download new browsers/i.test(errorMessage);
+            this.logger.error(`Failed to generate proposal PDF for proposal ${(_b = proposal === null || proposal === void 0 ? void 0 : proposal.id) !== null && _b !== void 0 ? _b : 'unknown'} (locale=${locale}). ${errorMessage}`, errorStack);
+            throw new common_1.InternalServerErrorException(missingPlaywrightRuntime
+                ? 'PDF generation is unavailable because Playwright/Chromium is not installed on the server. Run `pnpm --filter api run playwright:install` in the API environment.'
+                : 'Failed to generate the PDF document. Check server logs for details.');
+        }
+        finally {
+            await ((_c = browser === null || browser === void 0 ? void 0 : browser.close) === null || _c === void 0 ? void 0 : _c.call(browser));
+        }
+    }
+    async buildProposalDocumentHtml(proposal, locale = 'en') {
+        var _a, _b, _c, _d, _e;
+        const labels = this.getProposalDocumentLabels(locale);
+        const logoUrl = await this.resolveProposalDocumentLogoUrl();
+        const companyName = await this.resolveProposalDocumentCompanyName();
+        const currentRevision = this.getCurrentProposalRevision(proposal);
+        const items = Array.isArray(currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.proposal_item)
+            ? currentRevision.proposal_item.filter((item) => item && item.deleted_at == null)
+            : [];
+        const bodyHtml = this.sanitizeDocumentHtml(currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.content_html) ||
+            ((_a = this.normalizeOptionalText(currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.summary)) === null || _a === void 0 ? void 0 : _a.split(/\n{2,}/).map((paragraph) => `<p>${this.escapeHtml(paragraph)}</p>`).join('')) ||
+            '<p>No additional commercial narrative was provided yet.</p>';
+        const itemsHtml = items.length
+            ? items
+                .map((item) => `
+              <tr>
+                <td>${this.escapeHtml(item.name || 'Item')}</td>
+                <td>${this.escapeHtml(item.description || '—')}</td>
+                <td class="numeric">${this.escapeHtml(String(Number(item.quantity || 1)))}</td>
+                <td>${this.escapeHtml(this.humanizeEnumLabel(item.recurrence || 'one_time'))}</td>
+                <td class="numeric">${this.escapeHtml(this.formatMoney(Number(item.unit_amount_cents || 0) / 100, proposal.currency_code, locale))}</td>
+                <td class="numeric">${this.escapeHtml(this.formatMoney(Number(item.total_amount_cents || 0) / 100, proposal.currency_code, locale))}</td>
+              </tr>`)
+                .join('')
+            : `
+        <tr>
+          <td colspan="6">${this.escapeHtml(labels.emptyItems)}</td>
+        </tr>`;
+        const conditions = [
+            `${labels.validity}: ${this.formatDateLabel(proposal.valid_until, locale, labels.openEnded)}`,
+            `${labels.billingModel}: ${this.humanizeEnumLabel(proposal.billing_model || 'fixed_price')}`,
+            `${labels.proposalType}: ${this.humanizeEnumLabel(proposal.contract_type || 'service_agreement')}`,
+            `${labels.acceptanceReady}`,
+        ]
+            .filter(Boolean)
+            .map((item) => `<li>${this.escapeHtml(item)}</li>`)
+            .join('');
+        const notesHtml = this.normalizeOptionalText(proposal.notes)
+            ? this.normalizeOptionalText(proposal.notes)
+                .split(/\n{2,}/)
+                .map((paragraph) => `<p>${this.escapeHtml(paragraph)}</p>`)
+                .join('')
+            : `<p>${this.escapeHtml(labels.noNotes)}</p>`;
+        return `<!DOCTYPE html>
+<html lang="${this.escapeHtml(locale || 'en')}">
+  <head>
+    <meta charset="utf-8" />
+    <style>
+      @page {
+        size: A4;
+        margin: 72px 18px 56px 18px;
+      }
+      body {
+        color: #0f172a;
+        font-family: Arial, sans-serif;
+        font-size: 12px;
+        line-height: 1.5;
+        margin: 0;
+      }
+      header {
+        align-items: center;
+        border-bottom: 2px solid #dbeafe;
+        display: flex;
+        justify-content: space-between;
+        gap: 16px;
+        margin-bottom: 24px;
+        padding-bottom: 16px;
+      }
+      .brand { display: flex; align-items: center; gap: 12px; }
+      .brand img { height: 42px; max-width: 140px; object-fit: contain; }
+      .eyebrow {
+        color: #2563eb;
+        font-size: 10px;
+        font-weight: 700;
+        letter-spacing: 0.12em;
+        text-transform: uppercase;
+      }
+      h1 { font-size: 22px; margin: 4px 0 0; }
+      .meta-grid {
+        display: grid;
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        gap: 12px;
+        margin: 18px 0 20px;
+      }
+      .meta-card, .totals-card {
+        background: #f8fafc;
+        border: 1px solid #dbeafe;
+        border-radius: 12px;
+        padding: 12px;
+      }
+      .meta-card strong, .totals-card strong {
+        display: block;
+        font-size: 10px;
+        letter-spacing: 0.08em;
+        margin-bottom: 4px;
+        text-transform: uppercase;
+      }
+      section { margin-top: 18px; }
+      h2 { color: #1d4ed8; font-size: 14px; margin: 0 0 10px; }
+      .items-table {
+        border-collapse: collapse;
+        width: 100%;
+      }
+      .items-table th, .items-table td {
+        border-bottom: 1px solid #e2e8f0;
+        padding: 8px 10px;
+        text-align: left;
+        vertical-align: top;
+      }
+      .items-table th {
+        background: #eff6ff;
+        font-size: 10px;
+        letter-spacing: 0.08em;
+        text-transform: uppercase;
+      }
+      .numeric { text-align: right; }
+      .content, .notes, .acceptance {
+        border: 1px solid #e2e8f0;
+        border-radius: 14px;
+        padding: 16px 18px;
+      }
+      .totals-grid {
+        display: grid;
+        grid-template-columns: 1.5fr 1fr;
+        gap: 16px;
+        align-items: start;
+      }
+      .totals-card .row {
+        display: flex;
+        justify-content: space-between;
+        margin-bottom: 6px;
+      }
+      .totals-card .row.total {
+        border-top: 1px solid #cbd5e1;
+        font-size: 14px;
+        font-weight: 700;
+        margin-top: 10px;
+        padding-top: 10px;
+      }
+      ul { margin: 0; padding-left: 18px; }
+      footer {
+        border-top: 1px solid #dbeafe;
+        color: #475569;
+        font-size: 10px;
+        margin-top: 28px;
+        padding-top: 12px;
+      }
+    </style>
+  </head>
+  <body>
+    <header>
+      <div class="brand">
+        <img src="${logoUrl}" alt="${this.escapeHtml(companyName)}" />
+        <div>
+          <div class="eyebrow">${this.escapeHtml(labels.documentTag)}</div>
+          <h1>${this.escapeHtml(proposal.title || (currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.title) || labels.documentTitle)}</h1>
+          <div>${this.escapeHtml(companyName)}</div>
+        </div>
+      </div>
+      <div>
+        <div><strong>${this.escapeHtml(labels.code)}:</strong> ${this.escapeHtml(proposal.code || `PROP-${proposal.id}`)}</div>
+        <div><strong>${this.escapeHtml(labels.version)}:</strong> ${this.escapeHtml(`R${Number((currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.revision_number) || proposal.current_revision_number || 1) || 1}`)}</div>
+        <div><strong>${this.escapeHtml(labels.status)}:</strong> ${this.escapeHtml(this.humanizeEnumLabel(proposal.status || 'draft'))}</div>
+      </div>
+    </header>
+
+    <div class="meta-grid">
+      <div class="meta-card">
+        <strong>${this.escapeHtml(labels.client)}</strong>
+        ${this.escapeHtml(((_b = proposal.person) === null || _b === void 0 ? void 0 : _b.trade_name) || ((_c = proposal.person) === null || _c === void 0 ? void 0 : _c.name) || labels.notInformed)}
+      </div>
+      <div class="meta-card">
+        <strong>${this.escapeHtml(labels.validity)}</strong>
+        ${this.escapeHtml(this.formatDateLabel(proposal.valid_until, locale, labels.openEnded))}
+      </div>
+      <div class="meta-card">
+        <strong>${this.escapeHtml(labels.email)}</strong>
+        ${this.escapeHtml(((_d = proposal.person) === null || _d === void 0 ? void 0 : _d.email) || labels.notInformed)}
+      </div>
+      <div class="meta-card">
+        <strong>${this.escapeHtml(labels.document)}</strong>
+        ${this.escapeHtml(((_e = proposal.person) === null || _e === void 0 ? void 0 : _e.document) || labels.notInformed)}
+      </div>
+    </div>
+
+    <section>
+      <h2>${this.escapeHtml(labels.executiveSummary)}</h2>
+      <div class="content">${bodyHtml}</div>
+    </section>
+
+    <section>
+      <h2>${this.escapeHtml(labels.items)}</h2>
+      <table class="items-table">
+        <thead>
+          <tr>
+            <th>${this.escapeHtml(labels.item)}</th>
+            <th>${this.escapeHtml(labels.description)}</th>
+            <th class="numeric">${this.escapeHtml(labels.qty)}</th>
+            <th>${this.escapeHtml(labels.recurrence)}</th>
+            <th class="numeric">${this.escapeHtml(labels.unitPrice)}</th>
+            <th class="numeric">${this.escapeHtml(labels.total)}</th>
+          </tr>
+        </thead>
+        <tbody>${itemsHtml}</tbody>
+      </table>
+    </section>
+
+    <section>
+      <div class="totals-grid">
+        <div class="notes">
+          <h2>${this.escapeHtml(labels.commercialConditions)}</h2>
+          <ul>${conditions}</ul>
+          <h2 style="margin-top: 16px;">${this.escapeHtml(labels.notes)}</h2>
+          ${notesHtml}
+        </div>
+        <div class="totals-card">
+          <strong>${this.escapeHtml(labels.totals)}</strong>
+          <div class="row"><span>${this.escapeHtml(labels.subtotal)}</span><span>${this.escapeHtml(this.formatMoney(Number(proposal.subtotal_amount_cents || 0) / 100, proposal.currency_code, locale))}</span></div>
+          <div class="row"><span>${this.escapeHtml(labels.discount)}</span><span>${this.escapeHtml(this.formatMoney(Number(proposal.discount_amount_cents || 0) / 100, proposal.currency_code, locale))}</span></div>
+          <div class="row"><span>${this.escapeHtml(labels.tax)}</span><span>${this.escapeHtml(this.formatMoney(Number(proposal.tax_amount_cents || 0) / 100, proposal.currency_code, locale))}</span></div>
+          <div class="row total"><span>${this.escapeHtml(labels.total)}</span><span>${this.escapeHtml(this.formatMoney(Number(proposal.total_amount_cents || 0) / 100, proposal.currency_code, locale))}</span></div>
+        </div>
+      </div>
+    </section>
+
+    <section>
+      <h2>${this.escapeHtml(labels.acceptanceSection)}</h2>
+      <div class="acceptance">
+        <p>${this.escapeHtml(labels.acceptanceMessage)}</p>
+        <p><strong>${this.escapeHtml(labels.acceptanceStatus)}:</strong> ${this.escapeHtml(labels.pending)}</p>
+      </div>
+    </section>
+
+    <footer>
+      ${this.escapeHtml(labels.generatedOn)} ${this.escapeHtml(this.formatDateLabel(new Date().toISOString(), locale, labels.notInformed))} · ${this.escapeHtml(companyName)}
+    </footer>
+  </body>
+</html>`;
+    }
+    async resolveProposalDocumentLogoUrl() {
+        var _a;
+        const settings = await this.settingService.getSettingValues([
+            'image-url',
+            'icon-url',
+        ]);
+        const configuredUrl = (_a = this.normalizeOptionalText(settings['image-url'])) !== null && _a !== void 0 ? _a : this.normalizeOptionalText(settings['icon-url']);
+        if (configuredUrl && /^https?:\/\//i.test(configuredUrl)) {
+            return configuredUrl;
+        }
+        const inlineSvg = encodeURIComponent(`<svg xmlns="http://www.w3.org/2000/svg" width="240" height="72" viewBox="0 0 240 72">
+        <rect width="240" height="72" rx="18" fill="#0f172a"/>
+        <circle cx="38" cy="36" r="18" fill="#3b82f6"/>
+        <text x="72" y="43" fill="#ffffff" font-size="26" font-family="Arial, sans-serif" font-weight="700">HedHog</text>
+      </svg>`);
+        return `data:image/svg+xml;charset=UTF-8,${inlineSvg}`;
+    }
+    async resolveProposalDocumentCompanyName() {
+        var _a;
+        const settings = await this.settingService.getSettingValues(['system-name']);
+        return (_a = this.normalizeOptionalText(settings['system-name'])) !== null && _a !== void 0 ? _a : 'HedHog';
+    }
+    buildProposalDocumentFileName(proposal, revision) {
+        var _a, _b;
+        const base = (_b = (_a = this.normalizeOptionalText(proposal.code)) !== null && _a !== void 0 ? _a : this.normalizeOptionalText(proposal.title)) !== null && _b !== void 0 ? _b : `proposal-${proposal.id}`;
+        const revisionLabel = Number((revision === null || revision === void 0 ? void 0 : revision.revision_number) || proposal.current_revision_number || 1);
+        return `${base
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 72) || `proposal-${proposal.id}`}-r${revisionLabel}.pdf`;
+    }
+    mergeProposalRevisionSnapshot(existingSnapshot, patch) {
+        const base = this.normalizeSnapshotJson(existingSnapshot);
+        return Object.assign(Object.assign(Object.assign({}, base), patch), { commercialDocument: Object.assign(Object.assign({}, (base.commercialDocument || {})), (patch.commercialDocument || {})) });
+    }
+    normalizeSnapshotJson(value) {
+        if (!value) {
+            return {};
+        }
+        if (typeof value === 'string') {
+            try {
+                const parsed = JSON.parse(value);
+                return parsed && typeof parsed === 'object' ? parsed : {};
+            }
+            catch (_a) {
+                return {};
+            }
+        }
+        return typeof value === 'object' && !Array.isArray(value) ? value : {};
+    }
+    getProposalDocumentLabels(locale) {
+        const isPt = String(locale || '').toLowerCase().startsWith('pt');
+        return isPt
+            ? {
+                documentTag: 'Proposta Comercial',
+                documentTitle: 'Proposta Comercial',
+                code: 'Código',
+                version: 'Versão',
+                status: 'Status',
+                client: 'Cliente',
+                validity: 'Validade',
+                email: 'E-mail',
+                document: 'Documento',
+                executiveSummary: 'Resumo Executivo',
+                items: 'Itens da Proposta',
+                item: 'Item',
+                description: 'Descrição',
+                qty: 'Qtd.',
+                recurrence: 'Recorrência',
+                unitPrice: 'Valor Unitário',
+                total: 'Total',
+                totals: 'Totais',
+                subtotal: 'Subtotal',
+                discount: 'Desconto',
+                tax: 'Impostos',
+                commercialConditions: 'Condições Comerciais',
+                notes: 'Observações',
+                noNotes: 'Nenhuma observação adicional informada.',
+                emptyItems: 'Nenhum item comercial foi registrado nesta versão.',
+                notInformed: 'Não informado',
+                openEnded: 'Em aberto',
+                billingModel: 'Modelo de cobrança',
+                proposalType: 'Tipo comercial',
+                acceptanceReady: 'Documento preparado para aceite eletrônico simples em uma etapa futura.',
+                acceptanceSection: 'Aceite Eletrônico (preparação)',
+                acceptanceMessage: 'Esta versão já preserva o HTML da proposta e o PDF assinado visualmente, facilitando a inclusão de um aceite eletrônico simples no futuro.',
+                acceptanceStatus: 'Status do aceite',
+                pending: 'Pendente',
+                generatedOn: 'Gerado em',
+            }
+            : {
+                documentTag: 'Commercial Proposal',
+                documentTitle: 'Commercial Proposal',
+                code: 'Code',
+                version: 'Version',
+                status: 'Status',
+                client: 'Client',
+                validity: 'Validity',
+                email: 'Email',
+                document: 'Document',
+                executiveSummary: 'Executive Summary',
+                items: 'Proposal Items',
+                item: 'Item',
+                description: 'Description',
+                qty: 'Qty.',
+                recurrence: 'Recurrence',
+                unitPrice: 'Unit Price',
+                total: 'Total',
+                totals: 'Totals',
+                subtotal: 'Subtotal',
+                discount: 'Discount',
+                tax: 'Tax',
+                commercialConditions: 'Commercial Conditions',
+                notes: 'Notes',
+                noNotes: 'No additional notes were provided.',
+                emptyItems: 'No commercial items were registered for this version.',
+                notInformed: 'Not informed',
+                openEnded: 'Open ended',
+                billingModel: 'Billing model',
+                proposalType: 'Commercial type',
+                acceptanceReady: 'This document is ready for a future lightweight electronic acceptance step.',
+                acceptanceSection: 'Electronic Acceptance (prepared)',
+                acceptanceMessage: 'This version already preserves the rendered HTML and visual PDF, which will simplify adding a lightweight electronic acceptance flow later.',
+                acceptanceStatus: 'Acceptance status',
+                pending: 'Pending',
+                generatedOn: 'Generated on',
+            };
+    }
+    formatMoney(amount, currencyCode, locale = 'en') {
+        var _a;
+        const currency = (_a = this.normalizeOptionalText(currencyCode)) !== null && _a !== void 0 ? _a : 'BRL';
+        try {
+            return new Intl.NumberFormat(locale || 'en', {
+                style: 'currency',
+                currency,
+            }).format(Number(amount || 0));
+        }
+        catch (_b) {
+            return `${currency} ${Number(amount || 0).toFixed(2)}`;
+        }
+    }
+    formatDateLabel(value, locale = 'en', fallback = '—') {
+        if (!value) {
+            return fallback;
+        }
+        const date = value instanceof Date ? value : new Date(value);
+        if (Number.isNaN(date.getTime())) {
+            return fallback;
+        }
+        try {
+            return new Intl.DateTimeFormat(locale || 'en', {
+                dateStyle: 'medium',
+            }).format(date);
+        }
+        catch (_a) {
+            return date.toISOString().slice(0, 10);
+        }
+    }
+    sanitizeDocumentHtml(value) {
+        const html = this.normalizeOptionalText(value);
+        if (!html) {
+            return null;
+        }
+        return html
+            .replace(/<script[\s\S]*?<\/script>/gi, '')
+            .replace(/\son\w+=("[^"]*"|'[^']*')/gi, '')
+            .replace(/javascript:/gi, '');
+    }
+    humanizeEnumLabel(value) {
+        return String(value !== null && value !== void 0 ? value : '')
+            .split('_')
+            .filter(Boolean)
+            .map((part) => { var _a; return ((_a = part[0]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) + part.slice(1); })
+            .join(' ');
+    }
+    escapeHtml(value) {
+        return String(value !== null && value !== void 0 ? value : '')
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#39;');
+    }
+    async lockProposalForTransition(client, proposalId) {
+        const rows = await client.$queryRawUnsafe(`SELECT id
+         FROM proposal
+        WHERE id = $1
+          AND deleted_at IS NULL
+        FOR UPDATE`, proposalId);
+        if (!Array.isArray(rows) || rows.length === 0) {
+            return null;
+        }
+        return this.loadProposalDetail(client, proposalId);
+    }
+    assertProposalWorkflowReadiness(proposal, actionLabel) {
+        var _a, _b;
+        const currentRevision = this.getCurrentProposalRevision(proposal);
+        if (!currentRevision) {
+            throw new common_1.NotFoundException('Current proposal revision not found.');
+        }
+        const validUntil = (_b = (_a = proposal === null || proposal === void 0 ? void 0 : proposal.valid_until) !== null && _a !== void 0 ? _a : currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.valid_until) !== null && _b !== void 0 ? _b : null;
+        if (validUntil) {
+            const validUntilDate = new Date(validUntil);
+            if (!Number.isNaN(validUntilDate.getTime()) &&
+                validUntilDate.getTime() < Date.now()) {
+                throw new common_1.BadRequestException(`Expired proposals cannot be ${actionLabel}.`);
+            }
+        }
+        const revisionItems = Array.isArray(currentRevision === null || currentRevision === void 0 ? void 0 : currentRevision.proposal_item)
+            ? currentRevision.proposal_item.filter((item) => item && item.deleted_at == null)
+            : [];
+        const hasPositiveTotal = Number((proposal === null || proposal === void 0 ? void 0 : proposal.total_amount_cents) || 0) > 0;
+        if (revisionItems.length === 0 && !hasPositiveTotal) {
+            throw new common_1.BadRequestException(`Proposals without items or value cannot be ${actionLabel}.`);
+        }
+    }
+    assertCanEdit(status, locale) {
+        if (status === proposal_dto_1.ProposalStatus.APPROVED ||
+            status === proposal_dto_1.ProposalStatus.CONTRACT_GENERATED) {
+            throw new common_1.BadRequestException((0, api_locale_1.getLocaleText)('validation.invalidStatus', locale, 'Approved proposals can no longer be edited'));
+        }
+    }
+    normalizeOptionalText(value) {
+        const normalized = String(value || '').trim();
+        return normalized.length > 0 ? normalized : null;
+    }
+    getPrimaryPersonContactValue(contacts, codes) {
+        var _a, _b;
+        const normalizedCodes = new Set(codes.map((code) => code.toUpperCase()));
+        const items = Array.isArray(contacts)
+            ? contacts.filter((contact) => {
+                var _a;
+                return normalizedCodes.has(String(((_a = contact === null || contact === void 0 ? void 0 : contact.contact_type) === null || _a === void 0 ? void 0 : _a.code) || '').toUpperCase());
+            })
+            : [];
+        const primary = items.find((contact) => contact === null || contact === void 0 ? void 0 : contact.is_primary);
+        const fallback = items[0];
+        const value = (_b = (_a = primary === null || primary === void 0 ? void 0 : primary.value) !== null && _a !== void 0 ? _a : fallback === null || fallback === void 0 ? void 0 : fallback.value) !== null && _b !== void 0 ? _b : null;
+        return value != null && String(value).trim().length > 0
+            ? String(value).trim()
+            : null;
+    }
+    async attachPersonTradeNames(client, input) {
+        var _a, _b;
+        if (!input) {
+            return input;
+        }
+        const proposals = Array.isArray(input) ? input : [input];
+        const personIds = Array.from(new Set(proposals
+            .map((proposal) => { var _a, _b, _c; return Number((_c = (_b = (_a = proposal === null || proposal === void 0 ? void 0 : proposal.person) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : proposal === null || proposal === void 0 ? void 0 : proposal.person_id) !== null && _c !== void 0 ? _c : 0); })
+            .filter((id) => id > 0)));
+        if (personIds.length === 0) {
+            return input;
+        }
+        const [companyRows, contactRows, documentRows] = await Promise.all([
+            client.person_company.findMany({
+                where: {
+                    id: {
+                        in: personIds,
+                    },
+                },
+                select: {
+                    id: true,
+                    trade_name: true,
+                },
+            }),
+            client.contact.findMany({
+                where: {
+                    person_id: {
+                        in: personIds,
+                    },
+                },
+                include: {
+                    contact_type: {
+                        select: {
+                            code: true,
+                        },
+                    },
+                },
+                orderBy: [{ is_primary: 'desc' }, { id: 'asc' }],
+            }),
+            client.document.findMany({
+                where: {
+                    person_id: {
+                        in: personIds,
+                    },
+                },
+                select: {
+                    id: true,
+                    person_id: true,
+                    value: true,
+                },
+                orderBy: [{ id: 'asc' }],
+            }),
+        ]);
+        const tradeNameByPersonId = new Map(companyRows.map((row) => {
+            var _a;
+            return [
+                row.id,
+                (_a = row.trade_name) !== null && _a !== void 0 ? _a : null,
+            ];
+        }));
+        const contactsByPersonId = new Map();
+        for (const contact of contactRows) {
+            const current = (_a = contactsByPersonId.get(Number(contact.person_id))) !== null && _a !== void 0 ? _a : [];
+            current.push(contact);
+            contactsByPersonId.set(Number(contact.person_id), current);
+        }
+        const documentsByPersonId = new Map();
+        for (const document of documentRows) {
+            const current = (_b = documentsByPersonId.get(Number(document.person_id))) !== null && _b !== void 0 ? _b : [];
+            current.push(document);
+            documentsByPersonId.set(Number(document.person_id), current);
+        }
+        const normalized = proposals.map((proposal) => {
+            var _a, _b, _c, _d;
+            if (!(proposal === null || proposal === void 0 ? void 0 : proposal.person)) {
+                return proposal;
+            }
+            const personId = Number(proposal.person.id);
+            const contacts = (_a = contactsByPersonId.get(personId)) !== null && _a !== void 0 ? _a : [];
+            const documents = (_b = documentsByPersonId.get(personId)) !== null && _b !== void 0 ? _b : [];
+            return Object.assign(Object.assign({}, proposal), { person: Object.assign(Object.assign({}, proposal.person), { trade_name: (_c = tradeNameByPersonId.get(personId)) !== null && _c !== void 0 ? _c : null, email: this.getPrimaryPersonContactValue(contacts, ['EMAIL']), phone: this.getPrimaryPersonContactValue(contacts, [
+                        'PHONE',
+                        'MOBILE',
+                        'WHATSAPP',
+                    ]), document: ((_d = documents[0]) === null || _d === void 0 ? void 0 : _d.value) != null &&
+                        String(documents[0].value).trim().length > 0
+                        ? String(documents[0].value).trim()
+                        : null }) });
+        });
+        return Array.isArray(input) ? normalized : normalized[0];
+    }
+    async loadProposalDetail(client, proposalId) {
+        const proposal = await client.proposal.findFirst({
+            where: {
+                id: proposalId,
+                deleted_at: null,
+            },
+            include: {
+                person: {
+                    select: {
+                        id: true,
+                        name: true,
+                    },
+                },
+                proposal_revision: {
+                    where: {
+                        deleted_at: null,
+                    },
+                    include: {
+                        proposal_item: {
+                            where: { deleted_at: null },
+                            orderBy: { order: 'asc' },
+                        },
+                        proposal_document: {
+                            where: { deleted_at: null },
+                            orderBy: { id: 'desc' },
+                        },
+                        proposal_approval: {
+                            where: { deleted_at: null },
+                            orderBy: { step_order: 'asc' },
+                        },
+                    },
+                    orderBy: { revision_number: 'desc' },
+                },
+                proposal_document: {
+                    where: {
+                        deleted_at: null,
+                    },
+                    orderBy: {
+                        id: 'desc',
+                    },
+                },
+                proposal_approval: {
+                    where: {
+                        deleted_at: null,
+                    },
+                    orderBy: {
+                        step_order: 'asc',
+                    },
+                },
+            },
+        });
+        return this.attachPersonTradeNames(client, proposal);
+    }
+    async loadProposalIntegrationSnapshot(client, proposalId) {
+        const proposal = await client.proposal.findFirst({
+            where: {
+                id: proposalId,
+                deleted_at: null,
+            },
+            include: {
+                person: {
+                    select: {
+                        id: true,
+                        name: true,
+                        type: true,
+                    },
+                },
+                proposal_revision: {
+                    where: {
+                        deleted_at: null,
+                        is_current: true,
+                    },
+                    include: {
+                        proposal_item: {
+                            where: { deleted_at: null },
+                            orderBy: { order: 'asc' },
+                        },
+                        proposal_document: {
+                            where: { deleted_at: null },
+                            orderBy: { id: 'desc' },
+                        },
+                    },
+                    orderBy: { revision_number: 'desc' },
+                    take: 1,
+                },
+            },
+        });
+        if (!proposal) {
+            throw new common_1.NotFoundException('Proposal snapshot not found.');
+        }
+        return this.attachPersonTradeNames(client, proposal);
+    }
+};
+exports.ProposalService = ProposalService;
+exports.ProposalService = ProposalService = ProposalService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)((0, common_1.forwardRef)(() => core_1.FileService))),
+    __param(3, (0, common_1.Inject)((0, common_1.forwardRef)(() => core_1.SettingService))),
+    __metadata("design:paramtypes", [api_prisma_1.PrismaService,
+        core_1.IntegrationDeveloperApiService,
+        core_1.FileService,
+        core_1.SettingService])
+], ProposalService);
+//# sourceMappingURL=proposal.service.js.map