medusajs-documents-plugin 0.0.0-stage → 1.1.1

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.

package/README.md

@@ -1,3 +1,202 @@
-# Temporary Holding Version
+# Medusa v2 Documents Plugin (`medusajs-documents-plugin`)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A powerful, production-ready document generation, accounting, and multi-channel notification plugin for **Medusa v2**, modeled after `@rsc-labs/medusa-documents-v2` with deep **Zoho Books** accounting integration, **PDFKit multi-template fallback**, **Paystack QR codes & short payment links**, **Medusa Workflows**, and a **unified Admin Documents Hub**.
+
+---
+
+## Key Features
+
+1. **Unified Documents Hub**
+   - Access all invoices, payment receipts, quotations/estimates, packing slips, and custom certificates in one single Medusa Admin tab.
+   - Eliminates the need to switch back and forth into the Zoho Books app for day-to-day document lookup.
+   - Includes full-text search, type filtering, source filtering (Zoho vs PDFKit), and direct actions: View PDF, Send Notification, Push to Zoho, and Copy Short Link.
+
+2. **Zoho Books Integration & Exposed Customizations**
+   - Official Zoho Books API v3 integration with automated OAuth access token refreshing.
+   - Contacts, Invoices, and Estimates automatically sync to your Zoho organization.
+   - Exposes common Zoho customizations directly in the plugin settings (Terms & Conditions, Customer Notes, Net Payment Due Days, Tax Inclusive/Exclusive treatment, Invoice Prefix) so you don't have to open Zoho Books to tweak them.
+
+3. **PDFKit Fallback with Multiple Design Templates**
+   - Automatically takes over when Zoho Books is disabled, credentials are unset, or for documents that Zoho doesn't support (such as Packing Slips and Custom Warranty Certificates).
+   - Choose between 3 distinct aesthetic templates in the **PDF Templates** tab:
+     - **Modern Minimalist**: Crisp headers, subtle borders, accent banners, and modern typography.
+     - **Classic Corporate**: Traditional formal grid, serif typography, double border lines.
+     - **Clean Tech Monospace**: High-contrast, monospace typography optimized for hardware, repairs, and technical orders.
+   - Instant live PDF preview button for each template directly in Admin.
+
+4. **Paystack Payment Links & Embedded QR Codes**
+   - For all unpaid documents (orders with remaining balance or repair tickets):
+     - Computes exact balance due.
+     - Generates secure Paystack storefront HMAC checkout URL (`/pay/:hash/:order_id` or `/repairs/track?token=...`).
+     - Shortens the link to keep text messages clean.
+     - Appends the payment link directly to Zoho invoice notes and custom fields.
+     - Embeds a scan-to-pay QR code onto the top right of the PDF invoice!
+
+5. **Automations & Captured Events Tab**
+   - Dedicated tab in the Admin UI with on/off switches for each event subscriber:
+     - `order.placed`: Autogenerates Tax Invoice + QR payment link.
+     - `order.completed`: Autogenerates Packing Slip.
+     - `payment.captured`: Autogenerates Payment Receipt.
+     - `order.fulfillment_created`: Autogenerates Packing Slip.
+     - `repair.status_changed`: Autogenerates updated repair invoice or quote.
+     - `repair.ticket.compliance_requested`: Autogenerates Quotation.
+     - `repair.created`: Autogenerates initial Job Card / Estimate.
+     - `repair.completed`: Autogenerates final Repair Invoice.
+     - `repair.customer_reminder`: Nudges customer with document link.
+
+6. **Custom Document Creator with Direct Email Delivery**
+   - Create custom certificates (e.g. Warranty Certificates, Work Orders, Proforma Invoices, Agreements) with custom body text and optional line items.
+   - Immediately dispatches the document PDF link and customized message to the customer's email via the Medusa notification module.
+
+7. **Multi-Channel Dispatch Optimized for Email, SMS & WhatsApp**
+   - **Email**: Responsive HTML email with document branding, summary, action buttons (download PDF, pay online if unpaid).
+   - **SMS**: Concise SMS message with company name, doc reference, amount, due status, and short links.
+   - **WhatsApp**: Clean message with emojis, bold formatting, and short links.
+
+8. **Shortened Links Engine**
+   - Database model & public route (`/api/store/documents/r/:code`) providing 302 redirection for clean, short messages.
+
+9. **Inter-Plugin Delegation Helper**
+   - Exported helper function `delegateDocumentGeneration` allowing `medusajs-repairshop-plugin` or custom checkout modules to resolve `documents` and offload document creation.
+
+10. **Medusa v2 Workflows**
+    - `generateDocumentWorkflow`: Full compensation-safe document generation pipeline.
+    - `sendDocumentNotificationWorkflow`: Multi-channel notification pipeline.
+    - `createManualDocumentWorkflow`: Manual document creation pipeline.
+
+---
+
+## How to Enable the Zoho QR Code Feature
+
+Our plugin gives you two complementary ways to enable and display QR codes on Zoho invoices:
+
+### Method A: Plugin Automatic QR Code Embedding (Recommended)
+Our plugin automatically embeds a high-resolution, scan-to-pay Paystack QR code on the top-right corner of the generated Zoho PDF, and includes the short payment link in the Zoho invoice customer notes:
+1. In the Medusa Admin sidebar, open **Documents**.
+2. Click the **Settings & Zoho** tab.
+3. Under **Zoho Books Integration**, ensure **Enable Zoho Books Sync** is turned on.
+4. Under **Exposed Zoho Invoice Customizations**, ensure **Embed Payment QR Code on Zoho Invoices** is switched **ON** (enabled by default).
+5. (Optional) Set the **Custom Field Name for Payment Link** (e.g., `Payment Link`).
+6. Click **Save All Settings**.
+
+Whenever an invoice with an unpaid balance is generated, our post-processor streams the Zoho PDF, stamps the payment QR code on the top right, and adds the payment instructions directly into the document.
+
+### Method B: Zoho Books Native Invoice QR Code Setting
+If you also want Zoho Books' web portal and native email templates to display QR codes:
+1. Log in to your [Zoho Books Dashboard](https://books.zoho.com).
+2. Go to **Settings (Gear Icon)** > **Preferences** > **Invoices**.
+3. Scroll down to the **Invoice QR Code** section and toggle it to **Enabled**.
+4. Under **QR Code Type**, choose **Invoice URL** or **Custom**.
+5. If using custom invoice templates, ensure the `%InvoiceQRCodeImage%` or `<img src="%InvQRCodeImgSrcURL%"/>` placeholder is positioned in your template header.
+6. Click **Save** in Zoho Books.
+
+---
+
+## Installation & Setup
+
+### 1. Add to `medusa-config.ts`
+In your Medusa project's `medusa-config.ts` (or `medusa-config.js`):
+
+```typescript
+module.exports = defineConfig({
+  plugins: [
+    {
+      resolve: "medusajs-documents-plugin",
+      options: {}
+    },
+    // other plugins...
+  ],
+  modules: [
+    {
+      key: "documents",
+      resolve: "medusajs-documents-plugin",
+      options: {}
+    }
+  ]
+});
+```
+
+### 2. Run Database Migrations
+```bash
+npx medusa db:migrate
+```
+
+### 3. Build & Run
+```bash
+yarn build
+yarn dev
+```
+
+---
+
+## Inter-Plugin Integration: How to Use in `medusajs-repairshop-plugin`
+
+To delegate document generation from your repair plugin to this plugin:
+
+```typescript
+import { delegateDocumentGeneration } from "medusajs-documents-plugin";
+
+// Inside your repair endpoint or service:
+const result = await delegateDocumentGeneration(container, {
+  display_id: `RT-${ticket.ticket_number}`,
+  title: "Repair Invoice",
+  type: "invoice",
+  repair_ticket_id: ticket.id,
+  customer: {
+    name: customer.first_name,
+    email: customer.email,
+    phone: customer.phone,
+  },
+  items: [
+    { title: "OEM Screen Replacement", quantity: 1, unit_price: 150 },
+    { title: "Labor Fee", quantity: 1, unit_price: 45 }
+  ],
+  total: 195,
+  currency_code: "usd",
+  payment_link: `https://store.example.com/repairs/track?token=${ticket.approval_token}`,
+  auto_send: true,
+});
+
+if (result) {
+  // Successfully generated through Documents plugin (via Zoho or PDFKit)!
+  console.log("Generated Document ID:", result.record.id);
+}
+```
+
+---
+
+## Running Automated Tests
+
+```bash
+yarn test
+```
+
+Runs the 6 unit and integration test suites:
+- PDFKit Generator (Modern, Classic, Minimal templates & Custom documents)
+- PDF Post-Processor (QR Code embedding, watermark validation)
+- Payment Link Generator (HMAC calculation & balance due validation)
+- Zoho Books Service (OAuth & API payload mapping)
+- Notification Sender (Channel routing & payload formatting)
+
+---
+
+## Automated Releases & NPM Publishing
+
+This repository includes a fully automated GitHub Actions pipeline (`.github/workflows/release.yml`):
+- **Automated Versioning**: Automatically detects existing release tags, tags the version, and bumps `patch` on pushes to `main`.
+- **Changelog Extraction**: Extracts the corresponding version section from `CHANGELOG.md` to format the GitHub Release notes / release readme.
+- **Compressed Release Assets**: Builds and packages:
+  - 📦 `medusajs-documents-plugin-vX.Y.Z.zip` (compressed distribution zipfile)
+  - 📦 `medusajs-documents-plugin-vX.Y.Z.tgz` (npm tarball)
+- **NPM Publishing**: Publishes to [npm](https://www.npmjs.com/package/medusajs-documents-plugin) using `NODE_AUTH_TOKEN`.
+
+### Setting Up NPM Publishing
+To enable automated publishing to npm:
+1. Generate an Automation or Publish token on [npmjs.com](https://www.npmjs.com) (`Access Tokens -> Generate New Token -> Automation`).
+2. In your GitHub repository: Go to **Settings** > **Secrets and variables** > **Actions** > **New repository secret**.
+3. Name: `NPM_TOKEN`, Value: `<your_npm_token>`.
+
+---
+
+## License
+MIT © [Urban Device Care](https://urbandevicecare.co.uk)

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "medusajs-documents-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.1",
+  "description": "Comprehensive document generation and management module for Medusa v2 with Zoho Books integration, PDFKit fallback, QR codes, shortlinks, multi-channel notifications and unified admin hub.",
+  "author": "Urban Device Care <info@urbandevicecare.co.uk>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/urbandevicecare/medusajs-documents-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/urbandevicecare/medusajs-documents-plugin/issues"
+  },
+  "homepage": "https://github.com/urbandevicecare/medusajs-documents-plugin#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    ".medusa/server",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "main": "./.medusa/server/src/index.js",
+  "exports": {
+    ".": "./.medusa/server/src/index.js",
+    "./package.json": "./package.json",
+    "./workflows": "./.medusa/server/src/workflows/index.js",
+    "./.medusa/server/src/modules/*": "./.medusa/server/src/modules/*/index.js",
+    "./modules/*": "./.medusa/server/src/modules/*/index.js",
+    "./*": "./.medusa/server/src/*.js",
+    "./admin": {
+      "import": "./.medusa/server/src/admin/index.mjs",
+      "require": "./.medusa/server/src/admin/index.js",
+      "default": "./.medusa/server/src/admin/index.js"
+    }
+  },
+  "keywords": [
+    "medusa",
+    "plugin",
+    "medusa-plugin",
+    "medusa-documents",
+    "medusa-documents-v2",
+    "zoho-books",
+    "pdfkit",
+    "invoices"
+  ],
+  "scripts": {
+    "build": "medusa plugin:build",
+    "dev": "medusa plugin:dev",
+    "test": "npx tsx --test tests/run-all-tests.ts",
+    "prepack": "medusa plugin:build"
+  },
+  "dependencies": {
+    "pdf-lib": "^1.17.1",
+    "pdfkit": "^0.18.0",
+    "qrcode": "^1.5.4"
+  },
+  "devDependencies": {
+    "@medusajs/admin-sdk": "2.17.2",
+    "@medusajs/cli": "2.17.2",
+    "@medusajs/framework": "2.17.2",
+    "@medusajs/icons": "2.17.2",
+    "@medusajs/medusa": "2.17.2",
+    "@medusajs/ui": "4.1.8",
+    "@types/node": "^20.0.0",
+    "@types/pdfkit": "^0.17.6",
+    "@types/qrcode": "^1.5.6",
+    "@types/react": "^18.3.2",
+    "@types/react-dom": "^18.2.25",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.2",
+    "vite": "^5.2.11"
+  },
+  "peerDependencies": {
+    "@medusajs/admin-sdk": "2.17.2",
+    "@medusajs/framework": "2.17.2",
+    "@medusajs/icons": "2.17.2",
+    "@medusajs/ui": "4.1.8",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-router-dom": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "yarn@4.18.0"
+}