medusajs-documents-plugin 0.0.0-stage → 1.1.2

package/.medusa/server/src/subscribers/repair-documents.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.default = repairDocumentsSubscriber;
+const utils_1 = require("@medusajs/framework/utils");
+const documents_1 = require("../modules/documents");
+const payment_link_1 = require("../utils/payment-link");
+async function repairDocumentsSubscriber({ event, container, }) {
+    const logger = container.resolve("logger");
+    const eventName = event.name;
+    const data = event.data;
+    logger.info(`[Documents-Subscriber] Handling repair event '${eventName}'`);
+    try {
+        const documentService = container.resolve(documents_1.DOCUMENTS_MODULE, {
+            allowUnregistered: true,
+        });
+        if (!documentService)
+            return;
+        const settings = await documentService.getSettings();
+        // Fix 5: Handle repair completion via repair.status_changed where status === "completed"
+        const isCompleted = eventName === "repair.completed" ||
+            (eventName === "repair.status_changed" &&
+                (data.status === "completed" || data.status === "repaired"));
+        // Check on/off toggles
+        if (isCompleted) {
+            if (!settings.event_repair_completed_enabled) {
+                logger.info(`[Documents-Subscriber] Repair completed document processing is disabled in settings.`);
+                return;
+            }
+        }
+        else if (eventName === "repair.status_changed") {
+            if (!settings.event_repair_status_changed_enabled)
+                return;
+        }
+        if (eventName === "repair.ticket.compliance_requested" && !settings.event_repair_compliance_enabled)
+            return;
+        if (eventName === "repair.created" && !settings.event_repair_created_enabled)
+            return;
+        if (eventName === "repair.customer_reminder" && !settings.event_repair_reminder_enabled)
+            return;
+        const ticketId = data.id || data.repair_ticket_id;
+        if (!ticketId)
+            return;
+        const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+        const { data: tickets } = await query
+            .graph({
+            entity: "repair_ticket",
+            fields: [
+                "*",
+                "device.*",
+                "product_variants.*",
+                "product_variants.prices.*",
+                "product_variants.product.*",
+            ],
+            filters: { id: ticketId },
+        })
+            .catch(() => ({ data: [] }));
+        if (!tickets || tickets.length === 0)
+            return;
+        const ticket = tickets[0];
+        // Customer resolution
+        let customerName = "Valued Customer";
+        let customerEmail = undefined;
+        let customerPhone = undefined;
+        if (ticket.customer_id) {
+            try {
+                const customerModule = container.resolve("customer", { allowUnregistered: true });
+                if (customerModule) {
+                    const c = await customerModule.retrieveCustomer(ticket.customer_id);
+                    if (c) {
+                        customerName = c.first_name ? `${c.first_name} ${c.last_name || ""}`.trim() : c.email;
+                        customerEmail = c.email || undefined;
+                        customerPhone = c.phone || undefined;
+                    }
+                }
+            }
+            catch (e) { }
+        }
+        const storeUrl = settings.storefront_url || process.env.STORE_URL || "http://localhost:3000";
+        const paymentInfo = (0, payment_link_1.generateRepairPaymentLink)(ticket, storeUrl);
+        // Fix 4: Build line items mapping inventory parts from product_variants as well as custom_parts
+        const lineItems = [];
+        // 1. Map inventory parts from product_variants (SKU, title, unit price, quantity)
+        if (ticket.product_variants && ticket.product_variants.length > 0) {
+            for (const pv of ticket.product_variants) {
+                const qty = Number(pv.quantity || pv.pivot?.quantity || 1);
+                const unitPrice = Number(pv.unit_price ?? pv.price ?? pv.prices?.[0]?.amount ?? 0);
+                const partTitle = pv.product?.title
+                    ? `${pv.product.title}${pv.title && pv.title !== "Default Variant" ? ` (${pv.title})` : ""}`
+                    : pv.title || pv.product?.title || "Inventory Part";
+                lineItems.push({
+                    title: partTitle,
+                    description: pv.sku ? `SKU: ${pv.sku}` : (pv.product?.title ? `${pv.title || ""}`.trim() : ""),
+                    quantity: qty,
+                    unit_price: unitPrice,
+                    total: qty * unitPrice,
+                });
+            }
+        }
+        // 2. Map parts from device.parts_used if present
+        if (ticket.device?.parts_used && ticket.device.parts_used.length > 0) {
+            for (const part of ticket.device.parts_used) {
+                const qty = Number(part.quantity || 1);
+                const unitPrice = Number(part.price || part.unit_price || 0);
+                lineItems.push({
+                    title: part.name || part.title || "Replacement Part",
+                    description: part.sku ? `SKU: ${part.sku}` : "",
+                    quantity: qty,
+                    unit_price: unitPrice,
+                    total: qty * unitPrice,
+                });
+            }
+        }
+        // 3. Labor estimate
+        if (Number(ticket.labor_estimate || 0) > 0) {
+            lineItems.push({
+                title: "Labor Charge",
+                quantity: 1,
+                unit_price: Number(ticket.labor_estimate),
+                total: Number(ticket.labor_estimate),
+            });
+        }
+        // 4. Custom parts / services
+        if (ticket.custom_parts && ticket.custom_parts.length > 0) {
+            for (const cp of ticket.custom_parts) {
+                const qty = Number(cp.quantity || 1);
+                const unitPrice = Number(cp.price || cp.unit_price || 0);
+                lineItems.push({
+                    title: cp.name || cp.title || "Custom Service / Part",
+                    description: cp.description || (cp.sku ? `SKU: ${cp.sku}` : ""),
+                    quantity: qty,
+                    unit_price: unitPrice,
+                    total: qty * unitPrice,
+                });
+            }
+        }
+        // 5. Fallback line item if none specified
+        if (lineItems.length === 0) {
+            const tot = Number(ticket.total_actual || ticket.total_estimate || 0);
+            lineItems.push({
+                title: `Repair Service (#${ticket.ticket_number})`,
+                quantity: 1,
+                unit_price: tot,
+                total: tot,
+            });
+        }
+        const isPaid = ticket.payment_status === "captured" ||
+            ticket.payment_status === "paid" ||
+            eventName === "repair.payment_received";
+        const isAwaitingApproval = ticket.status === "awaiting_approval";
+        let docType = isPaid ? "receipt" : (isAwaitingApproval ? "estimate" : "invoice");
+        let docTitle = isPaid
+            ? "Repair Payment Receipt"
+            : isAwaitingApproval
+                ? "Repair Estimate / Quote"
+                : isCompleted
+                    ? "Final Repair Invoice"
+                    : "Repair Invoice";
+        if (eventName === "repair.created") {
+            docType = "job_card";
+            docTitle = "Repair Job Card";
+        }
+        const displayId = docType === "job_card" ? `JOB-${ticket.ticket_number}` : `RT-${ticket.ticket_number}`;
+        const totalEstimate = Number(ticket.total_actual && ticket.total_actual > 0 ? ticket.total_actual : ticket.total_estimate || 0);
+        const trackingUrl = ticket.approval_token ? `${storeUrl}/repairs/track?token=${ticket.approval_token}` : undefined;
+        const paymentOrTrackingLink = docType === "job_card" ? (trackingUrl || paymentInfo.paymentLink) : paymentInfo.paymentLink;
+        // Fix 1: Stop duplicate notifications on repair status changes.
+        // The repair subscriber already notifies the customer on repair status changes.
+        // Auto-send is kept false for status updates and job cards; receipts and customer reminders auto-send.
+        const autoSend = eventName === "repair.payment_received" || eventName === "repair.customer_reminder";
+        await documentService.generateDocument({
+            display_id: displayId,
+            title: docTitle,
+            type: docType,
+            repair_ticket_id: ticket.id,
+            customer: {
+                name: customerName,
+                email: customerEmail,
+                phone: customerPhone,
+            },
+            items: lineItems,
+            total: totalEstimate,
+            currency_code: "usd",
+            payment_status: isPaid ? "paid" : "unpaid",
+            payment_link: paymentOrTrackingLink || undefined,
+            auto_send: autoSend,
+            email_subject: `${docTitle} for Ticket #${ticket.ticket_number} (${ticket.device?.model_name || "Device"})`,
+            notes: ticket.terms_accepted != null
+                ? `Intake Consent: Terms Accepted: ${ticket.terms_accepted ? "Yes" : "No"} | Data Wipe: ${ticket.data_wiped_consent ? "Yes" : "No"}`
+                : undefined,
+            custom_fields: {
+                "Device Model": ticket.device?.model_name || "N/A",
+                Brand: ticket.device?.brand || "N/A",
+                "Serial / IMEI": ticket.device?.serial_number || ticket.device?.imei || "N/A",
+                Condition: ticket.device?.condition || "Not specified",
+                Accessories: ticket.accessories || "None",
+                Technician: ticket.technician_name || "Unassigned",
+                Issue: ticket.issue_description || "Standard Repair",
+            },
+        }, container);
+    }
+    catch (error) {
+        logger.error(`[Documents-Subscriber] Failed processing repair event '${eventName}': ${error.message}`);
+    }
+}
+exports.config = {
+    event: [
+        "repair.status_changed",
+        "repair.ticket.compliance_requested",
+        "repair.customer_reminder",
+        "repair.created",
+        "repair.completed",
+        "repair.payment_received",
+    ],
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVwYWlyLWRvY3VtZW50cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9zdWJzY3JpYmVycy9yZXBhaXItZG9jdW1lbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQU1BLDRDQThOQztBQW5PRCxxREFBc0U7QUFDdEUsb0RBQXdEO0FBRXhELHdEQUFrRTtBQUVuRCxLQUFLLFVBQVUseUJBQXlCLENBQUMsRUFDdEQsS0FBSyxFQUNMLFNBQVMsR0FDVztJQUNwQixNQUFNLE1BQU0sR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzNDLE1BQU0sU0FBUyxHQUFHLEtBQUssQ0FBQyxJQUFJLENBQUM7SUFDN0IsTUFBTSxJQUFJLEdBQUcsS0FBSyxDQUFDLElBQUksQ0FBQztJQUV4QixNQUFNLENBQUMsSUFBSSxDQUFDLGlEQUFpRCxTQUFTLEdBQUcsQ0FBQyxDQUFDO0lBRTNFLElBQUksQ0FBQztRQUNILE1BQU0sZUFBZSxHQUEwQixTQUFTLENBQUMsT0FBTyxDQUFDLDRCQUFnQixFQUFFO1lBQ2pGLGlCQUFpQixFQUFFLElBQUk7U0FDeEIsQ0FBQyxDQUFDO1FBQ0gsSUFBSSxDQUFDLGVBQWU7WUFBRSxPQUFPO1FBRTdCLE1BQU0sUUFBUSxHQUFHLE1BQU0sZUFBZSxDQUFDLFdBQVcsRUFBRSxDQUFDO1FBRXJELHlGQUF5RjtRQUN6RixNQUFNLFdBQVcsR0FDZixTQUFTLEtBQUssa0JBQWtCO1lBQ2hDLENBQUMsU0FBUyxLQUFLLHVCQUF1QjtnQkFDcEMsQ0FBQyxJQUFJLENBQUMsTUFBTSxLQUFLLFdBQVcsSUFBSSxJQUFJLENBQUMsTUFBTSxLQUFLLFVBQVUsQ0FBQyxDQUFDLENBQUM7UUFFakUsdUJBQXVCO1FBQ3ZCLElBQUksV0FBVyxFQUFFLENBQUM7WUFDaEIsSUFBSSxDQUFDLFFBQVEsQ0FBQyw4QkFBOEIsRUFBRSxDQUFDO2dCQUM3QyxNQUFNLENBQUMsSUFBSSxDQUFD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

package/.medusa/server/src/utils/integrate.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delegateDocumentGeneration = delegateDocumentGeneration;
+/**
+ * Universal helper for third-party plugins (e.g. medusajs-repairshop-plugin, custom checkout)
+ * to delegate document generation to the Documents Plugin when installed.
+ *
+ * Usage in another plugin:
+ * ```ts
+ * import { delegateDocumentGeneration } from "medusajs-documents-plugin";
+ *
+ * const result = await delegateDocumentGeneration(container, {
+ *   display_id: "RT-1001",
+ *   title: "Repair Invoice",
+ *   type: "invoice",
+ *   customer: { name: "John Doe", email: "john@example.com" },
+ *   items: [{ title: "Screen Repair", quantity: 1, unit_price: 120 }],
+ *   total: 120,
+ *   currency_code: "usd",
+ *   auto_send: true
+ * });
+ * ```
+ */
+async function delegateDocumentGeneration(container, input) {
+    try {
+        const documentService = container.resolve("documents", { allowUnregistered: true });
+        if (documentService) {
+            return await documentService.generateDocument(input, container);
+        }
+    }
+    catch (err) {
+        console.warn("[Documents-Integration] Failed to resolve documents module:", err);
+    }
+    return null;
+}
+exports.default = delegateDocumentGeneration;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZWdyYXRlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3V0aWxzL2ludGVncmF0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQXVCQSxnRUFhQztBQWpDRDs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNJLEtBQUssVUFBVSwwQkFBMEIsQ0FDOUMsU0FBMEIsRUFDMUIsS0FBNEI7SUFFNUIsSUFBSSxDQUFDO1FBQ0gsTUFBTSxlQUFlLEdBQVEsU0FBUyxDQUFDLE9BQU8sQ0FBQyxXQUFXLEVBQUUsRUFBRSxpQkFBaUIsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQ3pGLElBQUksZUFBZSxFQUFFLENBQUM7WUFDcEIsT0FBTyxNQUFNLGVBQWUsQ0FBQyxnQkFBZ0IsQ0FBQyxLQUFLLEVBQUUsU0FBUyxDQUFDLENBQUM7UUFDbEUsQ0FBQztJQUNILENBQUM7SUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1FBQ2IsT0FBTyxDQUFDLElBQUksQ0FBQyw2REFBNkQsRUFBRSxHQUFHLENBQUMsQ0FBQztJQUNuRixDQUFDO0lBQ0QsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDO0FBRUQsa0JBQWUsMEJBQTBCLENBQUMifQ==

package/.medusa/server/src/utils/payment-link.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateOrderPaymentLink = generateOrderPaymentLink;
+exports.generateRepairPaymentLink = generateRepairPaymentLink;
+const crypto_1 = __importDefault(require("crypto"));
+function generateOrderPaymentLink(order, storefrontUrl) {
+    let capturedAmount = 0;
+    if (order.payment_collections) {
+        for (const pc of order.payment_collections) {
+            if (pc.captured_amount != null) {
+                capturedAmount += Number(pc.captured_amount);
+            }
+            else if (pc.payments) {
+                capturedAmount += pc.payments.reduce((acc, p) => {
+                    const isPaid = Boolean(p.captured_at) && !p.canceled_at;
+                    return acc + (isPaid ? Number(p.amount) : 0);
+                }, 0);
+            }
+        }
+    }
+    const total = Number(order.total || 0);
+    const remainingBalance = Math.max(0, total - capturedAmount);
+    if (remainingBalance <= 0) {
+        return {
+            paymentLink: null,
+            remainingBalance: 0,
+            isUnpaid: false,
+        };
+    }
+    // Generate secure Paystack HMAC storefront payment URL
+    const secretKey = process.env.MEDUSA_PUBLISHABLE_KEY ||
+        process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY ||
+        process.env.MEDUSA_PUBLISHABLE_API_KEY ||
+        "super_secret_fallback_key";
+    const hash = crypto_1.default
+        .createHmac("sha256", secretKey)
+        .update(order.id)
+        .digest("hex");
+    const cleanStorefrontUrl = storefrontUrl.replace(/\/$/, "");
+    const paymentLink = `${cleanStorefrontUrl}/pay/${hash}/${order.id}`;
+    return {
+        paymentLink,
+        remainingBalance,
+        isUnpaid: true,
+    };
+}
+function generateRepairPaymentLink(ticket, storefrontUrl) {
+    const targetTotal = Number((ticket.total_actual && ticket.total_actual > 0) ? ticket.total_actual : ticket.total_estimate || 0);
+    const paid = Number(ticket.amount_paid || 0);
+    const remainingBalance = Math.max(0, targetTotal - paid);
+    if (remainingBalance <= 0 || !ticket.approval_token) {
+        return {
+            paymentLink: null,
+            remainingBalance,
+            isUnpaid: false,
+        };
+    }
+    const cleanStorefrontUrl = storefrontUrl.replace(/\/$/, "");
+    const paymentLink = `${cleanStorefrontUrl}/repairs/track?token=${ticket.approval_token}`;
+    return {
+        paymentLink,
+        remainingBalance,
+        isUnpaid: true,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF5bWVudC1saW5rLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3V0aWxzL3BheW1lbnQtbGluay50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQVFBLDREQStDQztBQUVELDhEQXFCQztBQTlFRCxvREFBNEI7QUFRNUIsU0FBZ0Isd0JBQXdCLENBQUMsS0FBVSxFQUFFLGFBQXFCO0lBQ3hFLElBQUksY0FBYyxHQUFHLENBQUMsQ0FBQztJQUV2QixJQUFJLEtBQUssQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1FBQzlCLEtBQUssTUFBTSxFQUFFLElBQUksS0FBSyxDQUFDLG1CQUE0QixFQUFFLENBQUM7WUFDcEQsSUFBSSxFQUFFLENBQUMsZUFBZSxJQUFJLElBQUksRUFBRSxDQUFDO2dCQUMvQixjQUFjLElBQUksTUFBTSxDQUFDLEVBQUUsQ0FBQyxlQUFlLENBQUMsQ0FBQztZQUMvQyxDQUFDO2lCQUFNLElBQUksRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDO2dCQUN2QixjQUFjLElBQUksRUFBRSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxHQUFXLEVBQUUsQ0FBTSxFQUFFLEVBQUU7b0JBQzNELE1BQU0sTUFBTSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsV0FBVyxDQUFDO29CQUN4RCxPQUFPLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7Z0JBQy9DLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQztZQUNSLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUVELE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsS0FBSyxJQUFJLENBQUMsQ0FBQyxDQUFDO0lBQ3ZDLE1BQU0sZ0JBQWdCLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQUUsS0FBSyxHQUFHLGNBQWMsQ0FBQyxDQUFDO0lBRTdELElBQUksZ0JBQWdCLElBQUksQ0FBQyxFQUFFLENBQUM7UUFDMUIsT0FBTztZQUNMLFdBQVcsRUFBRSxJQUFJO1lBQ2pCLGdCQUFnQixFQUFFLENBQUM7WUFDbkIsUUFBUSxFQUFFLEtBQUs7U0FDaEIsQ0FBQztJQUNKLENBQUM7SUFFRCx1REFBdUQ7SUFDdkQsTUFBTSxTQUFTLEdBQ2IsT0FBTyxDQUFDLEdBQUcsQ0FBQyxzQkFBc0I7UUFDbEMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxrQ0FBa0M7UUFDOUMsT0FBTyxDQUFDLEdBQUcsQ0FBQywwQkFBMEI7UUFDdEMsMkJBQTJCLENBQUM7SUFFOUIsTUFBTSxJQUFJLEdBQUcsZ0JBQU07U0FDaEIsVUFBVSxDQUFDLFFBQVEsRUFBRSxTQUFTLENBQUM7U0FDL0IsTUFBTSxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7U0FDaEIsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBRWpCLE1BQU0sa0JBQWtCLEdBQUcsYUFBYSxDQUFDLE9BQU8sQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDNUQsTUFBTSxXQUFXLEdBQUcsR0FBRyxrQkFBa0IsUUFBUSxJQUFJLElBQUksS0FBSyxDQUFDLEVBQUUsRUFBRSxDQUFDO0lBRXBFLE9BQU87UUFDTCxXQUFXO1FBQ1gsZ0JBQWdCO1FBQ2hCLFFBQVEsRUFBRSxJQUFJO0tBQ2YsQ0FBQztBQUNKLENBQUM7QUFFRCxTQUFnQix5QkFBeUIsQ0FBQyxNQUFXLEVBQUUsYUFBcUI7SUFDMUUsTUFBTSxXQUFXLEdBQUcsTUFBTSxDQUFDLENBQUMsTUFBTSxDQUFDLFlBQVksSUFBSSxNQUFNLENBQUMsWUFBWSxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsWUFBWSxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsY0FBYyxJQUFJLENBQUMsQ0FBQyxDQUFDO0lBQ2hJLE1BQU0sSUFBSSxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUMsV0FBVyxJQUFJLENBQUMsQ0FBQyxDQUFDO0lBQzdDLE1BQU0sZ0JBQWdCLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQUUsV0FBVyxHQUFHLElBQUksQ0FBQyxDQUFDO0lBRXpELElBQUksZ0JBQWdCLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLGNBQWMsRUFBRSxDQUFDO1FBQ3BELE9BQU87WUFDTCxXQUFXLEVBQUUsSUFBSTtZQUNqQixnQkFBZ0I7WUFDaEIsUUFBUSxFQUFFLEtBQUs7U0FDaEIsQ0FBQztJQUNKLENBQUM7SUFFRCxNQUFNLGtCQUFrQixHQUFHLGFBQWEsQ0FBQyxPQUFPLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxDQUFDO0lBQzVELE1BQU0sV0FBVyxHQUFHLEdBQUcsa0JBQWtCLHdCQUF3QixNQUFNLENBQUMsY0FBYyxFQUFFLENBQUM7SUFFekYsT0FBTztRQUNMLFdBQVc7UUFDWCxnQkFBZ0I7UUFDaEIsUUFBUSxFQUFFLElBQUk7S0FDZixDQUFDO0FBQ0osQ0FBQyJ9

package/.medusa/server/src/workflows/create-manual-document.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createManualDocumentWorkflow = exports.createManualDocumentStep = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const documents_1 = require("../modules/documents");
+exports.createManualDocumentStep = (0, workflows_sdk_1.createStep)("create-manual-document-step", async (input, { container }) => {
+    const documentService = container.resolve(documents_1.DOCUMENTS_MODULE);
+    const result = await documentService.generateDocument({
+        ...input,
+        auto_send: input.send_email_now || input.auto_send,
+    }, container);
+    return new workflows_sdk_1.StepResponse(result, { id: result.record.id });
+}, async (compensationData, { container }) => {
+    if (compensationData?.id) {
+        try {
+            const documentService = container.resolve(documents_1.DOCUMENTS_MODULE);
+            await documentService.deleteDocumentRecords(compensationData.id);
+        }
+        catch (e) { }
+    }
+});
+exports.createManualDocumentWorkflow = (0, workflows_sdk_1.createWorkflow)("create-manual-document-workflow", (input) => {
+    const result = (0, exports.createManualDocumentStep)(input);
+    return new workflows_sdk_1.WorkflowResponse(result);
+});
+exports.default = exports.createManualDocumentWorkflow;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlYXRlLW1hbnVhbC1kb2N1bWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3MvY3JlYXRlLW1hbnVhbC1kb2N1bWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxxRUFLMkM7QUFDM0Msb0RBQXdEO0FBTzNDLFFBQUEsd0JBQXdCLEdBQUcsSUFBQSwwQkFBVSxFQUNoRCw2QkFBNkIsRUFDN0IsS0FBSyxFQUFFLEtBQWdDLEVBQUUsRUFBRSxTQUFTLEVBQUUsRUFBRSxFQUFFO0lBQ3hELE1BQU0sZUFBZSxHQUEwQixTQUFTLENBQUMsT0FBTyxDQUFDLDRCQUFnQixDQUFDLENBQUM7SUFDbkYsTUFBTSxNQUFNLEdBQUcsTUFBTSxlQUFlLENBQUMsZ0JBQWdCLENBQUM7UUFDcEQsR0FBRyxLQUFLO1FBQ1IsU0FBUyxFQUFFLEtBQUssQ0FBQyxjQUFjLElBQUksS0FBSyxDQUFDLFNBQVM7S0FDbkQsRUFBRSxTQUFTLENBQUMsQ0FBQztJQUVkLE9BQU8sSUFBSSw0QkFBWSxDQUFDLE1BQU0sRUFBRSxFQUFFLEVBQUUsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7QUFDNUQsQ0FBQyxFQUNELEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxFQUFFLFNBQVMsRUFBRSxFQUFFLEVBQUU7SUFDeEMsSUFBSSxnQkFBZ0IsRUFBRSxFQUFFLEVBQUUsQ0FBQztRQUN6QixJQUFJLENBQUM7WUFDSCxNQUFNLGVBQWUsR0FBMEIsU0FBUyxDQUFDLE9BQU8sQ0FBQyw0QkFBZ0IsQ0FBQyxDQUFDO1lBQ25GLE1BQU0sZUFBZSxDQUFDLHFCQUFxQixDQUFDLGdCQUFnQixDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ25FLENBQUM7UUFBQyxPQUFPLENBQUMsRUFBRSxDQUFDLENBQUEsQ0FBQztJQUNoQixDQUFDO0FBQ0gsQ0FBQyxDQUNGLENBQUM7QUFFVyxRQUFBLDRCQUE0QixHQUFHLElBQUEsOEJBQWMsRUFDeEQsaUNBQWlDLEVBQ2pDLENBQUMsS0FBZ0MsRUFBRSxFQUFFO0lBQ25DLE1BQU0sTUFBTSxHQUFHLElBQUEsZ0NBQXdCLEVBQUMsS0FBSyxDQUFDLENBQUM7SUFDL0MsT0FBTyxJQUFJLGdDQUFnQixDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ3RDLENBQUMsQ0FDRixDQUFDO0FBRUYsa0JBQWUsb0NBQTRCLENBQUMifQ==

package/.medusa/server/src/workflows/generate-document.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateDocumentWorkflow = exports.generateDocumentStep = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const documents_1 = require("../modules/documents");
+exports.generateDocumentStep = (0, workflows_sdk_1.createStep)("generate-document-step", async (input, { container }) => {
+    const documentService = container.resolve(documents_1.DOCUMENTS_MODULE);
+    const result = await documentService.generateDocument(input, container);
+    return new workflows_sdk_1.StepResponse(result, { id: result.record.id });
+}, async (compensationData, { container }) => {
+    if (compensationData?.id) {
+        try {
+            const documentService = container.resolve(documents_1.DOCUMENTS_MODULE);
+            await documentService.deleteDocumentRecords(compensationData.id);
+        }
+        catch (e) { }
+    }
+});
+exports.generateDocumentWorkflow = (0, workflows_sdk_1.createWorkflow)("generate-document-workflow", (input) => {
+    const result = (0, exports.generateDocumentStep)(input);
+    return new workflows_sdk_1.WorkflowResponse(result);
+});
+exports.default = exports.generateDocumentWorkflow;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2VuZXJhdGUtZG9jdW1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL2dlbmVyYXRlLWRvY3VtZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFFQUsyQztBQUMzQyxvREFBd0Q7QUFHM0MsUUFBQSxvQkFBb0IsR0FBRyxJQUFBLDBCQUFVLEVBQzVDLHdCQUF3QixFQUN4QixLQUFLLEVBQUUsS0FBNEIsRUFBRSxFQUFFLFNBQVMsRUFBRSxFQUFFLEVBQUU7SUFDcEQsTUFBTSxlQUFlLEdBQTBCLFNBQVMsQ0FBQyxPQUFPLENBQUMsNEJBQWdCLENBQUMsQ0FBQztJQUNuRixNQUFNLE1BQU0sR0FBRyxNQUFNLGVBQWUsQ0FBQyxnQkFBZ0IsQ0FBQyxLQUFLLEVBQUUsU0FBUyxDQUFDLENBQUM7SUFDeEUsT0FBTyxJQUFJLDRCQUFZLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQztBQUM1RCxDQUFDLEVBQ0QsS0FBSyxFQUFFLGdCQUFnQixFQUFFLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRTtJQUN4QyxJQUFJLGdCQUFnQixFQUFFLEVBQUUsRUFBRSxDQUFDO1FBQ3pCLElBQUksQ0FBQztZQUNILE1BQU0sZUFBZSxHQUEwQixTQUFTLENBQUMsT0FBTyxDQUFDLDRCQUFnQixDQUFDLENBQUM7WUFDbkYsTUFBTSxlQUFlLENBQUMscUJBQXFCLENBQUMsZ0JBQWdCLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDbkUsQ0FBQztRQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FBQSxDQUFDO0lBQ2hCLENBQUM7QUFDSCxDQUFDLENBQ0YsQ0FBQztBQUVXLFFBQUEsd0JBQXdCLEdBQUcsSUFBQSw4QkFBYyxFQUNwRCw0QkFBNEIsRUFDNUIsQ0FBQyxLQUE0QixFQUFFLEVBQUU7SUFDL0IsTUFBTSxNQUFNLEdBQUcsSUFBQSw0QkFBb0IsRUFBQyxLQUFLLENBQUMsQ0FBQztJQUMzQyxPQUFPLElBQUksZ0NBQWdCLENBQUMsTUFBTSxDQUFDLENBQUM7QUFDdEMsQ0FBQyxDQUNGLENBQUM7QUFFRixrQkFBZSxnQ0FBd0IsQ0FBQyJ9

package/.medusa/server/src/workflows/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./generate-document"), exports);
+__exportStar(require("./send-document-notification"), exports);
+__exportStar(require("./create-manual-document"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxzREFBb0M7QUFDcEMsK0RBQTZDO0FBQzdDLDJEQUF5QyJ9

package/.medusa/server/src/workflows/send-document-notification.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendDocumentNotificationWorkflow = exports.sendDocumentNotificationStep = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const documents_1 = require("../modules/documents");
+const notification_sender_1 = require("../services/notification-sender");
+exports.sendDocumentNotificationStep = (0, workflows_sdk_1.createStep)("send-document-notification-step", async (input, { container }) => {
+    const documentService = container.resolve(documents_1.DOCUMENTS_MODULE);
+    const record = await documentService.retrieveDocumentRecord(input.documentId);
+    const settings = await documentService.getSettings();
+    const dispatchResult = await notification_sender_1.NotificationSender.send({
+        container,
+        document: {
+            id: record.id,
+            display_id: record.display_id,
+            title: record.title,
+            type: record.type,
+            customer_name: record.customer_name,
+            customer_email: record.customer_email,
+            customer_phone: record.customer_phone,
+            total_amount: record.total_amount,
+            currency_code: record.currency_code,
+            payment_status: record.payment_status,
+            payment_link: record.payment_link,
+            short_payment_link: record.short_payment_link,
+            pdf_url: record.pdf_url,
+            short_pdf_link: record.short_pdf_link,
+            custom_message: input.custom_message,
+            subject: input.subject,
+        },
+        channels: input.channels,
+        settings,
+    });
+    return new workflows_sdk_1.StepResponse(dispatchResult);
+});
+exports.sendDocumentNotificationWorkflow = (0, workflows_sdk_1.createWorkflow)("send-document-notification-workflow", (input) => {
+    const result = (0, exports.sendDocumentNotificationStep)(input);
+    return new workflows_sdk_1.WorkflowResponse(result);
+});
+exports.default = exports.sendDocumentNotificationWorkflow;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VuZC1kb2N1bWVudC1ub3RpZmljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvd29ya2Zsb3dzL3NlbmQtZG9jdW1lbnQtbm90aWZpY2F0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFFQUsyQztBQUMzQyxvREFBd0Q7QUFFeEQseUVBQXFFO0FBU3hELFFBQUEsNEJBQTRCLEdBQUcsSUFBQSwwQkFBVSxFQUNwRCxpQ0FBaUMsRUFDakMsS0FBSyxFQUFFLEtBQW9DLEVBQUUsRUFBRSxTQUFTLEVBQUUsRUFBRSxFQUFFO0lBQzVELE1BQU0sZUFBZSxHQUEwQixTQUFTLENBQUMsT0FBTyxDQUFDLDRCQUFnQixDQUFDLENBQUM7SUFDbkYsTUFBTSxNQUFNLEdBQUcsTUFBTSxlQUFlLENBQUMsc0JBQXNCLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQzlFLE1BQU0sUUFBUSxHQUFHLE1BQU0sZUFBZSxDQUFDLFdBQVcsRUFBRSxDQUFDO0lBRXJELE1BQU0sY0FBYyxHQUFHLE1BQU0sd0NBQWtCLENBQUMsSUFBSSxDQUFDO1FBQ25ELFNBQVM7UUFDVCxRQUFRLEVBQUU7WUFDUixFQUFFLEVBQUUsTUFBTSxDQUFDLEVBQUU7WUFDYixVQUFVLEVBQUUsTUFBTSxDQUFDLFVBQVU7WUFDN0IsS0FBSyxFQUFFLE1BQU0sQ0FBQyxLQUFLO1lBQ25CLElBQUksRUFBRSxNQUFNLENBQUMsSUFBSTtZQUNqQixhQUFhLEVBQUUsTUFBTSxDQUFDLGFBQWE7WUFDbkMsY0FBYyxFQUFFLE1BQU0sQ0FBQyxjQUFjO1lBQ3JDLGNBQWMsRUFBRSxNQUFNLENBQUMsY0FBYztZQUNyQyxZQUFZLEVBQUUsTUFBTSxDQUFDLFlBQVk7WUFDakMsYUFBYSxFQUFFLE1BQU0sQ0FBQyxhQUFhO1lBQ25DLGNBQWMsRUFBRSxNQUFNLENBQUMsY0FBYztZQUNyQyxZQUFZLEVBQUUsTUFBTSxDQUFDLFlBQVk7WUFDakMsa0JBQWtCLEVBQUUsTUFBTSxDQUFDLGtCQUFrQjtZQUM3QyxPQUFPLEVBQUUsTUFBTSxDQUFDLE9BQU87WUFDdkIsY0FBYyxFQUFFLE1BQU0sQ0FBQyxjQUFjO1lBQ3JDLGNBQWMsRUFBRSxLQUFLLENBQUMsY0FBYztZQUNwQyxPQUFPLEVBQUUsS0FBSyxDQUFDLE9BQU87U0FDdkI7UUFDRCxRQUFRLEVBQUUsS0FBSyxDQUFDLFFBQVE7UUFDeEIsUUFBUTtLQUNULENBQUMsQ0FBQztJQUVILE9BQU8sSUFBSSw0QkFBWSxDQUFDLGNBQWMsQ0FBQyxDQUFDO0FBQzFDLENBQUMsQ0FDRixDQUFDO0FBRVcsUUFBQSxnQ0FBZ0MsR0FBRyxJQUFBLDhCQUFjLEVBQzVELHFDQUFxQyxFQUNyQyxDQUFDLEtBQW9DLEVBQUUsRUFBRTtJQUN2QyxNQUFNLE1BQU0sR0FBRyxJQUFBLG9DQUE0QixFQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ25ELE9BQU8sSUFBSSxnQ0FBZ0IsQ0FBQyxNQUFNLENBQUMsQ0FBQztBQUN0QyxDQUFDLENBQ0YsQ0FBQztBQUVGLGtCQUFlLHdDQUFnQyxDQUFDIn0=

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to `medusajs-documents-plugin` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.1.0] - 2026-10-12
+
+### Minor Release: Repair Job Card Intake & Automated Release Pipeline
+
+#### ✨ What's New in v1.1.0
+
+- **First-Class Repair Job Card Generation (`type: "job_card"`)**:
+  - Automatically triggered upon repair intake (`repair.created`).
+  - Device specifications: Brand, Model, Serial Number, and IMEI.
+  - Workshop physical intake condition, accessories left, and customer reported fault.
+  - Workshop technician diagnostic checklist `[ ]`.
+  - Dual physical sign-off lines: **Customer Signature** & **Workshop Technician Signature**.
+  - Dynamic QR code directing straight to customer online repair tracking portal.
+
+- **Repair Event Subscribers & Delegation**:
+  - Event listeners for `repair.created` and `repair.payment_received`.
+  - Automatic Query Graph hydration of repair ticket details for document rendering.
+  - Seamless delegation from `Meduajs-repair-plugin` with fallback protection.
+
+- **Automated CI/CD & Distribution Pipeline**:
+  - GitHub Actions release pipeline with automated version tagging.
+  - Dynamic changelog extraction as release notes.
+  - Release asset bundling with compressed `.zip` distribution archive and `.tgz` npm package.
+  - Automated public publishing to the npm registry with authentication tokens.
+
+---
+
+## [1.0.0] - 2026-10-12
+
+### Initial Release: Medusa v2 Documents & Accounting Plugin
+
+Comprehensive document generation, accounting synchronization, and multi-channel notification engine for Medusa v2 with Zoho Books integration, local PDFKit fallback, dynamic QR codes, short links, and a unified Admin Documents Hub.
+
+#### ✨ Key Features
+
+- **First-Class Repair Job Cards (`job_card`)**:
+  - Automatic intake generation when `repair.created` fires.
+  - Device specifications (Brand, Model, Serial Number, IMEI).
+  - Cosmetic condition, accessories left with workshop, and reported fault description.
+  - Diagnostic checklist `[ ]` tasks for workshop technicians.
+  - Dual physical sign-off lines: **Customer Signature** & **Workshop Technician Signature**.
+  - Scannable QR code directing straight to customer online repair tracking portal.
+
+- **Zoho Books Synchronization**:
+  - Automatic customer contact creation and matching.
+  - Real-time generation of Invoices, Estimates, and Payment Receipts via Zoho Books API.
+  - Native Zoho invoice QR code customization and notes injection.
+  - Two-way reference mapping with local fallback records.
+
+- **Local PDFKit Generation Engine (Fallback)**:
+  - 3 modern, clean, print-ready document templates:
+    - **Modern Minimalist**: Crisp clean lines, typography-driven hierarchy, accent color branding.
+    - **Classic Corporate**: Traditional business layout with header grids and signature blocks.
+    - **Clean Tech Monospace**: Tech-repair inspired monospace layout with scannable barcodes and checklist grids.
+  - Document types: Job Cards, Tax Invoices, Payment Receipts, Estimates / Quotes, Packing Slips, and Custom Certificates.
+  - Complete removal of semi-transparent watermarks for sharp, professional PDFs.
+
+- **Paystack Dynamic Scan-to-Pay QR Codes & Short Links**:
+  - Direct QR code embedded onto invoices and estimates for instant mobile checkout.
+  - Built-in URL shortener (`/store/documents/r/:code`) for clean, deliverable SMS and WhatsApp links.
+
+- **Multi-Channel Notification Dispatcher**:
+  - **Email**: Responsive HTML emails with document branding, summary tables, and download/pay CTAs.
+  - **SMS**: Concise SMS notifications powered by TalkSasa SMS provider.
+  - **WhatsApp**: Rich formatting with emoji bullets and direct short links.
+
+- **Unified Admin Documents Hub (`/app/documents`)**:
+  - **All Documents Tab**: Search, filter by document type (including Job Cards), view statuses, create manual invoices, and resend notifications.
+  - **PDF Templates Tab**: Live document previewers and template style switchers.
+  - **Automations Tab**: Per-event subscriber toggle switches for order and repair events.
+  - **Settings Tab**: Zoho Books OAuth configuration, domain selector, company branding, and QR options.
+
+- **Automated Event Subscribers**:
+  - Order events: `order.placed`, `order.completed`, `payment.captured`, `order.fulfillment_created`.
+  - Repair events: `repair.created`, `repair.status_changed`, `repair.payment_received`, `repair.completed`, `repair.customer_reminder`.
+
+- **Graceful Integration Utility**:
+  - Exported `delegateDocumentGeneration` and `DOCUMENTS_MODULE` helpers allowing external plugins (like `Meduajs-repair-plugin`) to delegate document generation while maintaining safe fallbacks.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Urban Device Care
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.