@sam-ael/medusa-plugin-whatsapp 0.1.1 → 0.2.0

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

@@ -39,7 +39,7 @@ function ConfigSection() {
   const [form, setForm] = react.useState({
     phone_number_id: "",
     access_token: "",
-    api_version: "v21.0",
+    api_version: "v25.0",
     default_language_code: "en_US",
     active: true
   });
@@ -51,7 +51,7 @@ function ConfigSection() {
       setForm({
         phone_number_id: data.config.phone_number_id || "",
         access_token: "",
-        api_version: data.config.api_version || "v21.0",
+        api_version: data.config.api_version || "v25.0",
         default_language_code: data.config.default_language_code || "en_US",
         active: data.config.active ?? true
       });
@@ -121,7 +121,7 @@ function ConfigSection() {
           ui.Input,
           {
             id: "api-version",
-            placeholder: "v21.0",
+            placeholder: "v25.0",
             value: form.api_version,
             onChange: (e) => setForm({ ...form, api_version: e.target.value })
           }

package/.medusa/server/src/admin/index.mjs

@@ -38,7 +38,7 @@ function ConfigSection() {
   const [form, setForm] = useState({
     phone_number_id: "",
     access_token: "",
-    api_version: "v21.0",
+    api_version: "v25.0",
     default_language_code: "en_US",
     active: true
   });
@@ -50,7 +50,7 @@ function ConfigSection() {
       setForm({
         phone_number_id: data.config.phone_number_id || "",
         access_token: "",
-        api_version: data.config.api_version || "v21.0",
+        api_version: data.config.api_version || "v25.0",
         default_language_code: data.config.default_language_code || "en_US",
         active: data.config.active ?? true
       });
@@ -120,7 +120,7 @@ function ConfigSection() {
           Input,
           {
             id: "api-version",
-            placeholder: "v21.0",
+            placeholder: "v25.0",
             value: form.api_version,
             onChange: (e) => setForm({ ...form, api_version: e.target.value })
           }

package/.medusa/server/src/api/admin/whatsapp/config/route.js

@@ -7,7 +7,11 @@ async function GET(req, res) {
     const whatsappModule = req.scope.resolve(WHATSAPP_MODULE);
     const [configs] = await whatsappModule.listAndCountWhatsappConfigs({}, { take: 1 });
     if (configs.length === 0) {
-        return res.json({ config: null });
+        // Return env-based status so admin UI can show whether env vars are set
+        return res.json({
+            config: null,
+            env_configured: !!(process.env.WHATSAPP_PHONE_NUMBER_ID && process.env.WHATSAPP_ACCESS_TOKEN),
+        });
     }
     // Mask the access token for security
     const config = { ...configs[0] };
@@ -29,7 +33,7 @@ async function POST(req, res) {
         const updateData = {};
         if (phone_number_id !== undefined)
             updateData.phone_number_id = phone_number_id;
-        if (access_token !== undefined)
+        if (access_token !== undefined && access_token !== "")
             updateData.access_token = access_token;
         if (api_version !== undefined)
             updateData.api_version = api_version;
@@ -44,11 +48,17 @@ async function POST(req, res) {
         config = await whatsappModule.createWhatsappConfigs({
             phone_number_id: phone_number_id || process.env.WHATSAPP_PHONE_NUMBER_ID || "",
             access_token: access_token || process.env.WHATSAPP_ACCESS_TOKEN || "",
-            api_version: api_version || process.env.WHATSAPP_API_VERSION || "v21.0",
+            api_version: api_version || process.env.WHATSAPP_API_VERSION || "v25.0",
             default_language_code: default_language_code || "en_US",
             active: active !== undefined ? active : true,
         });
     }
-    res.json({ config });
+    // Mask token in response
+    const responseConfig = { ...config };
+    if (responseConfig.access_token) {
+        responseConfig.access_token =
+            responseConfig.access_token.substring(0, 8) + "..." + responseConfig.access_token.slice(-4);
+    }
+    res.json({ config: responseConfig });
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL3doYXRzYXBwL2NvbmZpZy9yb3V0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUlBLGtCQW9CQztBQUVELG9CQW1DQztBQTNERCxNQUFNLGVBQWUsR0FBRyxVQUFVLENBQUE7QUFFM0IsS0FBSyxVQUFVLEdBQUcsQ0FBQyxHQUFrQixFQUFFLEdBQW1CO0lBQzdELE1BQU0sY0FBYyxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFBO0lBRXpELE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxNQUFPLGNBQXNCLENBQUMsMkJBQTJCLENBQ3ZFLEVBQUUsRUFDRixFQUFFLElBQUksRUFBRSxDQUFDLEVBQUUsQ0FDZCxDQUFBO0lBRUQsSUFBSSxPQUFPLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3ZCLE9BQU8sR0FBRyxDQUFDLElBQUksQ0FBQyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFBO0lBQ3JDLENBQUM7SUFFRCxxQ0FBcUM7SUFDckMsTUFBTSxNQUFNLEdBQUcsRUFBRSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFBO0lBQ2hDLElBQUksTUFBTSxDQUFDLFlBQVksRUFBRSxDQUFDO1FBQ3RCLE1BQU0sQ0FBQyxZQUFZO1lBQ2YsTUFBTSxDQUFDLFlBQVksQ0FBQyxTQUFTLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxHQUFHLEtBQUssR0FBRyxNQUFNLENBQUMsWUFBWSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFBO0lBQ25GLENBQUM7SUFFRCxHQUFHLENBQUMsSUFBSSxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQTtBQUN4QixDQUFDO0FBRU0sS0FBSyxVQUFVLElBQUksQ0FBQyxHQUFrQixFQUFFLEdBQW1CO0lBQzlELE1BQU0sY0FBYyxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFBO0lBQ3pELE1BQU0sSUFBSSxHQUFHLEdBQUcsQ0FBQyxJQUEyQixDQUFBO0lBRTVDLE1BQU0sRUFBRSxlQUFlLEVBQUUsWUFBWSxFQUFFLFdBQVcsRUFBRSxxQkFBcUIsRUFBRSxNQUFNLEVBQUUsR0FBRyxJQUFJLENBQUE7SUFFMUYsbUNBQW1DO0lBQ25DLE1BQU0sQ0FBQyxRQUFRLENBQUMsR0FBRyxNQUFPLGNBQXNCLENBQUMsMkJBQTJCLENBQ3hFLEVBQUUsRUFDRixFQUFFLElBQUksRUFBRSxDQUFDLEVBQUUsQ0FDZCxDQUFBO0lBRUQsSUFBSSxNQUFNLENBQUE7SUFDVixJQUFJLFFBQVEsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDdEIseUJBQXlCO1FBQ3pCLE1BQU0sVUFBVSxHQUF3QixFQUFFLENBQUE7UUFDMUMsSUFBSSxlQUFlLEtBQUssU0FBUztZQUFFLFVBQVUsQ0FBQyxlQUFlLEdBQUcsZUFBZSxDQUFBO1FBQy9FLElBQUksWUFBWSxLQUFLLFNBQVM7WUFBRSxVQUFVLENBQUMsWUFBWSxHQUFHLFlBQVksQ0FBQTtRQUN0RSxJQUFJLFdBQVcsS0FBSyxTQUFTO1lBQUUsVUFBVSxDQUFDLFdBQVcsR0FBRyxXQUFXLENBQUE7UUFDbkUsSUFBSSxxQkFBcUIsS0FBSyxTQUFTO1lBQUUsVUFBVSxDQUFDLHFCQUFxQixHQUFHLHFCQUFxQixDQUFBO1FBQ2pHLElBQUksTUFBTSxLQUFLLFNBQVM7WUFBRSxVQUFVLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQTtRQUVwRCxNQUFNLEdBQUcsTUFBTyxjQUFzQixDQUFDLHFCQUFxQixDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsVUFBVSxDQUFDLENBQUE7SUFDNUYsQ0FBQztTQUFNLENBQUM7UUFDSixvQkFBb0I7UUFDcEIsTUFBTSxHQUFHLE1BQU8sY0FBc0IsQ0FBQyxxQkFBcUIsQ0FBQztZQUN6RCxlQUFlLEVBQUUsZUFBZSxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsd0JBQXdCLElBQUksRUFBRTtZQUM5RSxZQUFZLEVBQUUsWUFBWSxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMscUJBQXFCLElBQUksRUFBRTtZQUNyRSxXQUFXLEVBQUUsV0FBVyxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsb0JBQW9CLElBQUksT0FBTztZQUN2RSxxQkFBcUIsRUFBRSxxQkFBcUIsSUFBSSxPQUFPO1lBQ3ZELE1BQU0sRUFBRSxNQUFNLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLElBQUk7U0FDL0MsQ0FBQyxDQUFBO0lBQ04sQ0FBQztJQUVELEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQyxDQUFBO0FBQ3hCLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvYXBpL2FkbWluL3doYXRzYXBwL2NvbmZpZy9yb3V0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUlBLGtCQXdCQztBQUVELG9CQTBDQztBQXRFRCxNQUFNLGVBQWUsR0FBRyxVQUFVLENBQUE7QUFFM0IsS0FBSyxVQUFVLEdBQUcsQ0FBQyxHQUFrQixFQUFFLEdBQW1CO0lBQzdELE1BQU0sY0FBYyxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFBO0lBRXpELE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxNQUFPLGNBQXNCLENBQUMsMkJBQTJCLENBQ3ZFLEVBQUUsRUFDRixFQUFFLElBQUksRUFBRSxDQUFDLEVBQUUsQ0FDZCxDQUFBO0lBRUQsSUFBSSxPQUFPLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3ZCLHdFQUF3RTtRQUN4RSxPQUFPLEdBQUcsQ0FBQyxJQUFJLENBQUM7WUFDWixNQUFNLEVBQUUsSUFBSTtZQUNaLGNBQWMsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLHdCQUF3QixJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMscUJBQXFCLENBQUM7U0FDaEcsQ0FBQyxDQUFBO0lBQ04sQ0FBQztJQUVELHFDQUFxQztJQUNyQyxNQUFNLE1BQU0sR0FBRyxFQUFFLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUE7SUFDaEMsSUFBSSxNQUFNLENBQUMsWUFBWSxFQUFFLENBQUM7UUFDdEIsTUFBTSxDQUFDLFlBQVk7WUFDZixNQUFNLENBQUMsWUFBWSxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEdBQUcsS0FBSyxHQUFHLE1BQU0sQ0FBQyxZQUFZLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUE7SUFDbkYsQ0FBQztJQUVELEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQyxDQUFBO0FBQ3hCLENBQUM7QUFFTSxLQUFLLFVBQVUsSUFBSSxDQUFDLEdBQWtCLEVBQUUsR0FBbUI7SUFDOUQsTUFBTSxjQUFjLEdBQUcsR0FBRyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsZUFBZSxDQUFDLENBQUE7SUFDekQsTUFBTSxJQUFJLEdBQUcsR0FBRyxDQUFDLElBQTJCLENBQUE7SUFFNUMsTUFBTSxFQUFFLGVBQWUsRUFBRSxZQUFZLEVBQUUsV0FBVyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sRUFBRSxHQUFHLElBQUksQ0FBQTtJQUUxRixtQ0FBbUM7SUFDbkMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxHQUFHLE1BQU8sY0FBc0IsQ0FBQywyQkFBMkIsQ0FDeEUsRUFBRSxFQUNGLEVBQUUsSUFBSSxFQUFFLENBQUMsRUFBRSxDQUNkLENBQUE7SUFFRCxJQUFJLE1BQU0sQ0FBQTtJQUNWLElBQUksUUFBUSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUN0Qix5QkFBeUI7UUFDekIsTUFBTSxVQUFVLEdBQXdCLEVBQUUsQ0FBQTtRQUMxQyxJQUFJLGVBQWUsS0FBSyxTQUFTO1lBQUUsVUFBVSxDQUFDLGVBQWUsR0FBRyxlQUFlLENBQUE7UUFDL0UsSUFBSSxZQUFZLEtBQUssU0FBUyxJQUFJLFlBQVksS0FBSyxFQUFFO1lBQUUsVUFBVSxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUE7UUFDN0YsSUFBSSxXQUFXLEtBQUssU0FBUztZQUFFLFVBQVUsQ0FBQyxXQUFXLEdBQUcsV0FBVyxDQUFBO1FBQ25FLElBQUkscUJBQXFCLEtBQUssU0FBUztZQUFFLFVBQVUsQ0FBQyxxQkFBcUIsR0FBRyxxQkFBcUIsQ0FBQTtRQUNqRyxJQUFJLE1BQU0sS0FBSyxTQUFTO1lBQUUsVUFBVSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUE7UUFFcEQsTUFBTSxHQUFHLE1BQU8sY0FBc0IsQ0FBQyxxQkFBcUIsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLFVBQVUsQ0FBQyxDQUFBO0lBQzVGLENBQUM7U0FBTSxDQUFDO1FBQ0osb0JBQW9CO1FBQ3BCLE1BQU0sR0FBRyxNQUFPLGNBQXNCLENBQUMscUJBQXFCLENBQUM7WUFDekQsZUFBZSxFQUFFLGVBQWUsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLHdCQUF3QixJQUFJLEVBQUU7WUFDOUUsWUFBWSxFQUFFLFlBQVksSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLHFCQUFxQixJQUFJLEVBQUU7WUFDckUsV0FBVyxFQUFFLFdBQVcsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLG9CQUFvQixJQUFJLE9BQU87WUFDdkUscUJBQXFCLEVBQUUscUJBQXFCLElBQUksT0FBTztZQUN2RCxNQUFNLEVBQUUsTUFBTSxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxJQUFJO1NBQy9DLENBQUMsQ0FBQTtJQUNOLENBQUM7SUFFRCx5QkFBeUI7SUFDekIsTUFBTSxjQUFjLEdBQUcsRUFBRSxHQUFHLE1BQU0sRUFBRSxDQUFBO0lBQ3BDLElBQUksY0FBYyxDQUFDLFlBQVksRUFBRSxDQUFDO1FBQzlCLGNBQWMsQ0FBQyxZQUFZO1lBQ3ZCLGNBQWMsQ0FBQyxZQUFZLENBQUMsU0FBUyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsR0FBRyxLQUFLLEdBQUcsY0FBYyxDQUFDLFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUNuRyxDQUFDO0lBRUQsR0FBRyxDQUFDLElBQUksQ0FBQyxFQUFFLE1BQU0sRUFBRSxjQUFjLEVBQUUsQ0FBQyxDQUFBO0FBQ3hDLENBQUMifQ==

package/.medusa/server/src/modules/whatsapp/migrations/{Migration20260303172046.js → Migration20260303202037.js}

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Migration20260303172046 = void 0;
+exports.Migration20260303202037 = void 0;
 const migrations_1 = require("@medusajs/framework/mikro-orm/migrations");
-class Migration20260303172046 extends migrations_1.Migration {
+class Migration20260303202037 extends migrations_1.Migration {
     async up() {
-        this.addSql(`create table if not exists "whatsapp_config" ("id" text not null, "production_phone_number_id" text null, "test_phone_number_id" text null, "mode" text check ("mode" in ('test', 'production')) not null default 'test', "api_version" text not null default 'v21.0', "default_language_code" text not null default 'en_US', "active" boolean not null default true, "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), "deleted_at" timestamptz null, constraint "whatsapp_config_pkey" primary key ("id"));`);
+        this.addSql(`create table if not exists "whatsapp_config" ("id" text not null, "phone_number_id" text null, "access_token" text null, "api_version" text not null default 'v25.0', "default_language_code" text not null default 'en_US', "active" boolean not null default true, "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), "deleted_at" timestamptz null, constraint "whatsapp_config_pkey" primary key ("id"));`);
         this.addSql(`CREATE INDEX IF NOT EXISTS "IDX_whatsapp_config_deleted_at" ON "whatsapp_config" ("deleted_at") WHERE deleted_at IS NULL;`);
         this.addSql(`create table if not exists "whatsapp_event_mapping" ("id" text not null, "event_name" text not null, "template_name" text not null, "language_code" text not null default 'en_US', "template_variables" jsonb not null default '{}', "recipient_type" text not null default 'billing_shipping', "recipient_phone" text null, "active" boolean not null default true, "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), "deleted_at" timestamptz null, constraint "whatsapp_event_mapping_pkey" primary key ("id"));`);
         this.addSql(`CREATE INDEX IF NOT EXISTS "IDX_whatsapp_event_mapping_deleted_at" ON "whatsapp_event_mapping" ("deleted_at") WHERE deleted_at IS NULL;`);
@@ -17,5 +17,5 @@ class Migration20260303172046 extends migrations_1.Migration {
         this.addSql(`drop table if exists "whatsapp_message_log" cascade;`);
     }
 }
-exports.Migration20260303172046 = Migration20260303172046;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTWlncmF0aW9uMjAyNjAzMDMxNzIwNDYuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy93aGF0c2FwcC9taWdyYXRpb25zL01pZ3JhdGlvbjIwMjYwMzAzMTcyMDQ2LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHlFQUFxRTtBQUVyRSxNQUFhLHVCQUF3QixTQUFRLHNCQUFTO0lBRXpDLEtBQUssQ0FBQyxFQUFFO1FBQ2IsSUFBSSxDQUFDLE1BQU0sQ0FBQywraEJBQStoQixDQUFDLENBQUM7UUFDN2lCLElBQUksQ0FBQyxNQUFNLENBQUMsMkhBQTJILENBQUMsQ0FBQztRQUV6SSxJQUFJLENBQUMsTUFBTSxDQUFDLHFpQkFBcWlCLENBQUMsQ0FBQztRQUNuakIsSUFBSSxDQUFDLE1BQU0sQ0FBQyx5SUFBeUksQ0FBQyxDQUFDO1FBRXZKLElBQUksQ0FBQyxNQUFNLENBQUMsK2xCQUErbEIsQ0FBQyxDQUFDO1FBQzdtQixJQUFJLENBQUMsTUFBTSxDQUFDLHFJQUFxSSxDQUFDLENBQUM7SUFDdkosQ0FBQztJQUVRLEtBQUssQ0FBQyxJQUFJO1FBQ2YsSUFBSSxDQUFDLE1BQU0sQ0FBQyxpREFBaUQsQ0FBQyxDQUFDO1FBRS9ELElBQUksQ0FBQyxNQUFNLENBQUMsd0RBQXdELENBQUMsQ0FBQztRQUV0RSxJQUFJLENBQUMsTUFBTSxDQUFDLHNEQUFzRCxDQUFDLENBQUM7SUFDeEUsQ0FBQztDQUVKO0FBckJELDBEQXFCQyJ9
+exports.Migration20260303202037 = Migration20260303202037;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTWlncmF0aW9uMjAyNjAzMDMyMDIwMzcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy93aGF0c2FwcC9taWdyYXRpb25zL01pZ3JhdGlvbjIwMjYwMzAzMjAyMDM3LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHlFQUFxRTtBQUVyRSxNQUFhLHVCQUF3QixTQUFRLHNCQUFTO0lBRTNDLEtBQUssQ0FBQyxFQUFFO1FBQ2YsSUFBSSxDQUFDLE1BQU0sQ0FBQyw4YkFBOGIsQ0FBQyxDQUFDO1FBQzVjLElBQUksQ0FBQyxNQUFNLENBQUMsMkhBQTJILENBQUMsQ0FBQztRQUV6SSxJQUFJLENBQUMsTUFBTSxDQUFDLHFpQkFBcWlCLENBQUMsQ0FBQztRQUNuakIsSUFBSSxDQUFDLE1BQU0sQ0FBQyx5SUFBeUksQ0FBQyxDQUFDO1FBRXZKLElBQUksQ0FBQyxNQUFNLENBQUMsK2xCQUErbEIsQ0FBQyxDQUFDO1FBQzdtQixJQUFJLENBQUMsTUFBTSxDQUFDLHFJQUFxSSxDQUFDLENBQUM7SUFDckosQ0FBQztJQUVRLEtBQUssQ0FBQyxJQUFJO1FBQ2pCLElBQUksQ0FBQyxNQUFNLENBQUMsaURBQWlELENBQUMsQ0FBQztRQUUvRCxJQUFJLENBQUMsTUFBTSxDQUFDLHdEQUF3RCxDQUFDLENBQUM7UUFFdEUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxzREFBc0QsQ0FBQyxDQUFDO0lBQ3RFLENBQUM7Q0FFRjtBQXJCRCwwREFxQkMifQ==

package/.medusa/server/src/modules/whatsapp/models/whatsapp_config.js

@@ -3,12 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("@medusajs/framework/utils");
 const WhatsappConfig = utils_1.model.define("whatsapp_config", {
     id: utils_1.model.id().primaryKey(),
-    production_phone_number_id: utils_1.model.text().nullable(),
-    test_phone_number_id: utils_1.model.text().nullable(),
-    mode: utils_1.model.enum(["test", "production"]).default("test"),
-    api_version: utils_1.model.text().default("v21.0"),
+    phone_number_id: utils_1.model.text().nullable(),
+    access_token: utils_1.model.text().nullable(),
+    api_version: utils_1.model.text().default("v25.0"),
     default_language_code: utils_1.model.text().default("en_US"),
     active: utils_1.model.boolean().default(true),
 });
 exports.default = WhatsappConfig;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2hhdHNhcHBfY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvd2hhdHNhcHAvbW9kZWxzL3doYXRzYXBwX2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLHFEQUFpRDtBQUVqRCxNQUFNLGNBQWMsR0FBRyxhQUFLLENBQUMsTUFBTSxDQUFDLGlCQUFpQixFQUFFO0lBQ25ELEVBQUUsRUFBRSxhQUFLLENBQUMsRUFBRSxFQUFFLENBQUMsVUFBVSxFQUFFO0lBQzNCLDBCQUEwQixFQUFFLGFBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxRQUFRLEVBQUU7SUFDbkQsb0JBQW9CLEVBQUUsYUFBSyxDQUFDLElBQUksRUFBRSxDQUFDLFFBQVEsRUFBRTtJQUM3QyxJQUFJLEVBQUUsYUFBSyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sRUFBRSxZQUFZLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUM7SUFDeEQsV0FBVyxFQUFFLGFBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDO0lBQzFDLHFCQUFxQixFQUFFLGFBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDO0lBQ3BELE1BQU0sRUFBRSxhQUFLLENBQUMsT0FBTyxFQUFFLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQztDQUN4QyxDQUFDLENBQUE7QUFFRixrQkFBZSxjQUFjLENBQUEifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2hhdHNhcHBfY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvd2hhdHNhcHAvbW9kZWxzL3doYXRzYXBwX2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLHFEQUFpRDtBQUVqRCxNQUFNLGNBQWMsR0FBRyxhQUFLLENBQUMsTUFBTSxDQUFDLGlCQUFpQixFQUFFO0lBQ25ELEVBQUUsRUFBRSxhQUFLLENBQUMsRUFBRSxFQUFFLENBQUMsVUFBVSxFQUFFO0lBQzNCLGVBQWUsRUFBRSxhQUFLLENBQUMsSUFBSSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQ3hDLFlBQVksRUFBRSxhQUFLLENBQUMsSUFBSSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQ3JDLFdBQVcsRUFBRSxhQUFLLENBQUMsSUFBSSxFQUFFLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQztJQUMxQyxxQkFBcUIsRUFBRSxhQUFLLENBQUMsSUFBSSxFQUFFLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQztJQUNwRCxNQUFNLEVBQUUsYUFBSyxDQUFDLE9BQU8sRUFBRSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUM7Q0FDeEMsQ0FBQyxDQUFBO0FBRUYsa0JBQWUsY0FBYyxDQUFBIn0=

package/.medusa/server/src/subscribers/whatsapp-event-handler.js

@@ -8,22 +8,17 @@ async function whatsappEventHandler({ event: { name, data }, container, }) {
     const logger = container.resolve(utils_1.ContainerRegistrationKeys.LOGGER);
     const whatsappModule = container.resolve(WHATSAPP_MODULE);
     try {
-        // Get active WhatsApp config
+        // Get active WhatsApp config from DB
         const [configs] = await whatsappModule.listAndCountWhatsappConfigs({ active: true }, { take: 1 });
-        const config = configs[0];
-        if (!config) {
-            // Fallback to env vars
-            const phoneNumberId = process.env.WHATSAPP_PHONE_NUMBER_ID;
-            const accessToken = process.env.WHATSAPP_ACCESS_TOKEN;
-            if (!phoneNumberId || !accessToken) {
-                return; // WhatsApp not configured, silently skip
-            }
-        }
+        const config = configs?.[0];
+        // Resolve credentials: DB config takes priority, then env vars
         const phoneNumberId = config?.phone_number_id || process.env.WHATSAPP_PHONE_NUMBER_ID;
         const accessToken = config?.access_token || process.env.WHATSAPP_ACCESS_TOKEN;
-        const apiVersion = config?.api_version || process.env.WHATSAPP_API_VERSION || "v21.0";
-        if (!phoneNumberId || !accessToken)
-            return;
+        const apiVersion = config?.api_version || process.env.WHATSAPP_API_VERSION || "v25.0";
+        const defaultLangCode = config?.default_language_code || "en_US";
+        if (!phoneNumberId || !accessToken) {
+            return; // WhatsApp not configured, silently skip
+        }
         // Find mappings for this event
         const [mappings] = await whatsappModule.listAndCountWhatsappEventMappings({ event_name: name, active: true });
         if (!mappings || mappings.length === 0)
@@ -54,7 +49,7 @@ async function whatsappEventHandler({ event: { name, data }, container, }) {
                 template: {
                     name: mapping.template_name,
                     language: {
-                        code: mapping.language_code || config?.default_language_code || "en_US",
+                        code: mapping.language_code || defaultLangCode,
                     },
                     ...(components.length > 0 ? { components } : {}),
                 },
@@ -186,4 +181,4 @@ exports.config = {
         "exchange.created",
     ],
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2hhdHNhcHAtZXZlbnQtaGFuZGxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9zdWJzY3JpYmVycy93aGF0c2FwcC1ldmVudC1oYW5kbGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUtBLHVDQWlJQztBQXJJRCxxREFBcUU7QUFFckUsTUFBTSxlQUFlLEdBQUcsVUFBVSxDQUFBO0FBRW5CLEtBQUssVUFBVSxvQkFBb0IsQ0FBQyxFQUMvQyxLQUFLLEVBQUUsRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEVBQ3JCLFNBQVMsR0FDeUI7SUFDbEMsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBQyxpQ0FBeUIsQ0FBQyxNQUFNLENBQUMsQ0FBQTtJQUNsRSxNQUFNLGNBQWMsR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFBO0lBRXpELElBQUksQ0FBQztRQUNELDZCQUE2QjtRQUM3QixNQUFNLENBQUMsT0FBTyxDQUFDLEdBQUcsTUFBTyxjQUFzQixDQUFDLDJCQUEyQixDQUN2RSxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsRUFDaEIsRUFBRSxJQUFJLEVBQUUsQ0FBQyxFQUFFLENBQ2QsQ0FBQTtRQUVELE1BQU0sTUFBTSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQTtRQUN6QixJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDVix1QkFBdUI7WUFDdkIsTUFBTSxhQUFhLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyx3QkFBd0IsQ0FBQTtZQUMxRCxNQUFNLFdBQVcsR0FBRyxPQUFPLENBQUMsR0FBRyxDQUFDLHFCQUFxQixDQUFBO1lBQ3JELElBQUksQ0FBQyxhQUFhLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztnQkFDakMsT0FBTSxDQUFDLHlDQUF5QztZQUNwRCxDQUFDO1FBQ0wsQ0FBQztRQUVELE1BQU0sYUFBYSxHQUFHLE1BQU0sRUFBRSxlQUFlLElB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2hhdHNhcHAtZXZlbnQtaGFuZGxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9zdWJzY3JpYmVycy93aGF0c2FwcC1ldmVudC1oYW5kbGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUtBLHVDQTZIQztBQWpJRCxxREFBcUU7QUFFckUsTUFBTSxlQUFlLEdBQUcsVUFBVSxDQUFBO0FBRW5CLEtBQUssVUFBVSxvQkFBb0IsQ0FBQyxFQUMvQyxLQUFLLEVBQUUsRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEVBQ3JCLFNBQVMsR0FDeUI7SUFDbEMsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBQyxpQ0FBeUIsQ0FBQyxNQUFNLENBQUMsQ0FBQTtJQUNsRSxNQUFNLGNBQWMsR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFBO0lBRXpELElBQUksQ0FBQztRQUNELHFDQUFxQztRQUNyQyxNQUFNLENBQUMsT0FBTyxDQUFDLEdBQUcsTUFBTyxjQUFzQixDQUFDLDJCQUEyQixDQUN2RSxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsRUFDaEIsRUFBRSxJQUFJLEVBQUUsQ0FBQyxFQUFFLENBQ2QsQ0FBQTtRQUVELE1BQU0sTUFBTSxHQUFHLE9BQU8sRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFBO1FBRTNCLCtEQUErRDtRQUMvRCxNQUFNLGFBQWEsR0FBRyxNQUFNLEVBQUUsZUFBZSxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsd0JBQXdCLENBQUE7UUFDckYsTUFBTSxXQUFXLEdBQUcsTUFBTSxFQUFFLFlBQVksSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLHFCQUFxQixDQUFBO1FBQzdFLE1BQU0sVUFBVSxHQUFHLE1BQU0sRUFBRSxXQUFXLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxvQkFBb0IsSUFBSSxPQUFPLENBQUE7UUFDckYsTUFBTSxlQUFlLEdBQUcsTUFBTSxFQUFF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

package/README.md

@@ -1,8 +1,51 @@
-# Medusa WhatsApp Business Fulfillment & Notifications Plugin
+<p align="center">
+  <img src="https://img.shields.io/npm/v/@sam-ael/medusa-plugin-whatsapp?style=flat-square&color=25D366" alt="npm version" />
+  <img src="https://img.shields.io/badge/medusa-v2-7C3AED?style=flat-square" alt="Medusa v2" />
+  <img src="https://img.shields.io/badge/WhatsApp_Cloud_API-v25.0-25D366?style=flat-square&logo=whatsapp&logoColor=white" alt="WhatsApp API v25.0" />
+  <img src="https://img.shields.io/npm/l/@sam-ael/medusa-plugin-whatsapp?style=flat-square" alt="license" />
+</p>
 
-A complete WhatsApp Business integration for Medusa v2 stores.
+# @sam-ael/medusa-plugin-whatsapp
 
-This plugin bridges the gap between your Medusa core logic and your customers by dispatching real-time notifications directly to their WhatsApp accounts through the Cloud API. Automatically dispatch template-based updates mapped directly to fundamental store events mapping directly from your Medusa Dashboard.
+A **MedusaJS v2 plugin** for sending WhatsApp Business template messages to customers when store events happen — like order placements, fulfillments, returns, and more.
+
+Map any Medusa event to a WhatsApp template, configure recipient logic, and manage everything from a built-in admin dashboard. No code required after installation.
+
+---
+
+## Features
+
+- 📱 **WhatsApp Cloud API** — Sends template messages through the official WhatsApp Business Cloud API (v25.0)
+- 🗺️ **Event → Template Mapping** — Map Medusa events (`order.placed`, `fulfillment.created`, etc.) to your WhatsApp templates from the admin UI
+- 🎛️ **Admin Dashboard** — Full configuration page inside the Medusa admin panel with no extra setup
+- 📋 **Message Logs** — Every sent (and failed) message is logged with request/response payloads for debugging
+- 🧪 **Test Messages** — Send test template messages directly from the admin UI before going live
+- 📦 **Template Variables** — Map dynamic order data (order ID, customer name, total, etc.) to WhatsApp template body parameters
+- 📞 **Smart Recipient Resolution** — Automatically resolves phone numbers from billing address, shipping address, or customer profile
+- 🔑 **Flexible Configuration** — Configure via the admin UI, environment variables, or both (DB config takes priority)
+- 🏗️ **Zero Dependencies** — Uses native `fetch` — no external HTTP libraries needed
+
+---
+
+## Supported Events
+
+The plugin listens to the following events out of the box. You can also type in any custom event name in the admin UI.
+
+| Category | Events |
+|---|---|
+| **Orders** | `order.placed` · `order.completed` · `order.canceled` · `order.updated` · `order.fulfillment_created` |
+| **Fulfillment** | `fulfillment.created` · `fulfillment.shipment_created` · `fulfillment.delivery_created` |
+| **Customers** | `customer.created` · `customer.updated` |
+| **Returns & Claims** | `return.created` · `return.received` · `claim.created` · `exchange.created` |
+
+---
+
+## Prerequisites
+
+- **MedusaJS v2** (`>= 2.x`)
+- A **WhatsApp Business Account** with access to the [Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api)
+- A **Phone Number ID** and **Access Token** from the [Meta Developer Console](https://developers.facebook.com/apps/)
+- At least one **approved WhatsApp template** in your Business Manager
 
 ---
 
@@ -12,143 +55,166 @@ This plugin bridges the gap between your Medusa core logic and your customers by
 yarn add @sam-ael/medusa-plugin-whatsapp
 ```
 
+Or with npm:
+
+```bash
+npm install @sam-ael/medusa-plugin-whatsapp
+```
+
+---
+
 ## Configuration
 
-First, define your WhatsApp core credentials inside your environment `.env` file (these can be also controlled and updated inside your Medusa Admin dashboard):
+### 1. Add the plugin to `medusa-config.ts`
 
-```bash
-# Required or Configured Via Admin
-WHATSAPP_PHONE_NUMBER_ID="your_phone_number_id"
-WHATSAPP_ACCESS_TOKEN="your_access_token_secure_token"
+```ts
+plugins: [
+  {
+    resolve: "@sam-ael/medusa-plugin-whatsapp",
+    options: {},
+  },
+]
+```
 
-# Optional
-WHATSAPP_API_VERSION="v21.0"          # Facebook API Graph Version (default: v21.0)
+### 2. Set environment variables
+
+Add these to your `.env` file:
+
+```env
+WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id
+WHATSAPP_ACCESS_TOKEN=your_access_token
+WHATSAPP_API_VERSION=v25.0         # optional, defaults to v25.0
 ```
 
-Then, register the plugin inside `medusa-config.ts`. You need to add it to the `plugins` section ensuring its features correctly hook into your API layouts and dashboard admin logic.
+> **Note:** You can also configure these through the admin dashboard. Database-stored config takes priority over environment variables.
 
-```typescript
-import { defineConfig } from "@medusajs/framework/utils"
+### 3. Run migrations
 
-export default defineConfig({
-  plugins: [
-    {
-      resolve: "@sam-ael/medusa-plugin-whatsapp",
-      options: {},
-    },
-  ],
-})
+```bash
+npx medusa db:migrate
 ```
 
-Once installed and configured, generate and push the database schemas. Make sure to map these correctly to your current instance.
+### 4. Start Medusa
 
 ```bash
-npx medusa telemetry --disable 
-npx medusa db:generate whatsapp    # Run to generate plugin configurations
-npx medusa db:migrate              # Migrate WhatsApp structures
+npx medusa develop
 ```
 
+Navigate to **WhatsApp** in the admin sidebar to configure and start mapping events.
+
 ---
 
-## How It Works
+## Admin Dashboard
 
-### Live Event Webhooks & Subscriber Mapping
-Medusa routes specific core events natively in the framework — such as creating orders or fulfilling packages. This plugin seamlessly introduces a routing subscriber that hooks up directly to Medusa events:
+The plugin adds a **WhatsApp** page to the Medusa admin panel with four sections:
 
-| Supported Medusa Event | Actions |
-|-------------------------|---------|
-| `order.placed` | Fires exactly when a new user checks-out. |
-| `order.updated` | Notification upon any order state change. |
-| `order.canceled` / `order.completed` | Notify regarding active payment cancelations or when successfully finalized. |
-| `fulfillment.created` /  `fulfillment.shipment_created` | Shipment update, AWBs triggers or parcel dispatches. |
-| `customer.created` | Notify sign ups automatically! | 
+### Configuration
 
-You also can implement and configure **any Custom Event** that fires within your implementation — the underlying logic catches these dynamically!
+Set your WhatsApp Cloud API credentials, API version, and default language code. Toggle the integration on/off.
 
-### Zero-Code Admin UI Map & Templates
-We provide a plug-and-play UI directly inside your Medusa Dashboard.
+### Event → Template Mappings
 
-1. **Dashboard Interface**: Toggle settings, update `API_VERSION` limits or override Tokens completely without touching codebase.
-2. **Template Mapping**: Assign WhatsApp App templates (`template_name`) into active Medusa Events. You can specify different templates for `order.placed` & `fulfillment.shipment`.
-3. **Payload Variables via UI**: Automatically inject standard payload nodes dynamically without touching scripts. Select from over **15 Dynamic Identifiers** to route inside the templates payload components (`{{1}}` -> `order.display_id`). 
+Create rules that map Medusa events to WhatsApp templates:
 
-### Adaptive Smart Recipient Rules
-You don't need to write validation queries internally. The dashboard enables 4 different logic trees mapped individually per template configuration via the Admin panel on how user's numbers are extracted from the store:
+- Select a Medusa event (or type a custom one)
+- Enter the WhatsApp template name (as it appears in your Business Manager)
+- Set the language code
+- Choose the recipient type:
+  - **Billing phone** (fallback: shipping) — default
+  - **Billing phone only**
+  - **Shipping phone only**
+  - **Custom phone number** — for sending to a fixed number (e.g., store owner notifications)
+- Map up to 5 template variables to order data paths (e.g., `order.display_id`, `order.total`, `order.customer.first_name`)
 
-- **Billing/Shipping Pipeline**: (Default) Try checking `Billing_Address`, fallback to `Shipping_Address`, fallback to account `Customer` phone.
-- **Billing Strict Mode**.
-- **Shipping Strict Mode**.
-- **Custom Overwrites** - Target explicit admin notifications exclusively whenever a system event hooks.
+### Test Messages
 
----
+Send a template message to any phone number directly from the admin UI — useful for verifying your templates work before enabling event mappings.
 
-## API Reference
+### Message Logs
 
-All exposed endpoints are authenticated via current active Admin sessions for internal dashboard queries, testing, and operations.
+View a log of all sent and failed messages, including timestamps, recipient, status, and the event that triggered them.
 
-### Admin Configuration
-**GET & POST Setup**
-`GET /admin/whatsapp/config`
-`POST /admin/whatsapp/config`
+---
 
-Handles environment token settings mapped straight to database schemas vs `process.env`.
-```json
-{
-  "phone_number_id": "123456...",
-  "access_token": "EAA...",
-  "active": true
-}
-```
+## Template Variables
+
+When creating a mapping, you can map WhatsApp template body parameters to data from the event. Use dot-notation paths to reference nested data:
+
+| Path | Description |
+|---|---|
+| `order.display_id` | Human-readable order number |
+| `order.total` | Order total amount |
+| `order.currency_code` | Currency code (e.g., `INR`, `USD`) |
+| `order.email` | Order contact email |
+| `order.shipping_address.first_name` | Shipping first name |
+| `order.shipping_address.last_name` | Shipping last name |
+| `order.shipping_address.phone` | Shipping phone |
+| `order.shipping_address.city` | Shipping city |
+| `order.billing_address.first_name` | Billing first name |
+| `order.billing_address.last_name` | Billing last name |
+| `order.billing_address.phone` | Billing phone |
+| `order.customer.first_name` | Customer first name |
+| `order.customer.last_name` | Customer last name |
+| `order.customer.email` | Customer email |
+| `order.customer.phone` | Customer phone |
+
+You can also type any custom dot-path to reference data specific to your event payloads.
 
-### Event & Payload Mappings
-**Create Map Link**
-`POST /admin/whatsapp/mappings`
+---
 
-Bind templates with structured user configurations. You can optionally bind `template_variables` and structure `recipient_type`.
+## API Routes
 
-```json
-{
-  "event_name": "order.completed",
-  "template_name": "delivery_confirmation",
-  "template_variables": { "1": "order.display_id" },
-  "recipient_type": "billing_shipping"
-}
-```
+The plugin exposes the following admin API routes (all require authentication):
 
-### Automated Logs & Analytics
-**Messages & Delivery Results**
-`GET /admin/whatsapp/logs`
+| Method | Endpoint | Description |
+|---|---|---|
+| `GET` | `/admin/whatsapp/config` | Get current WhatsApp configuration |
+| `POST` | `/admin/whatsapp/config` | Create or update configuration |
+| `GET` | `/admin/whatsapp/mappings` | List all event → template mappings |
+| `POST` | `/admin/whatsapp/mappings` | Create a new mapping |
+| `PUT` | `/admin/whatsapp/mappings/:id` | Update a mapping |
+| `DELETE` | `/admin/whatsapp/mappings/:id` | Delete a mapping |
+| `GET` | `/admin/whatsapp/logs` | Get message logs |
+| `POST` | `/admin/whatsapp/test` | Send a test message |
 
-A complete dashboard table is exposed directly into Medusa that actively fetches sent dispatches logging metadata requests including success criteria, tracking ID blocks from Graph API or full response payload bodies.
+---
 
-**Testing Tool**
-`POST /admin/whatsapp/test`
-Send tests using manually configured layouts and payloads.
+## How It Works
+
+1. A Medusa event fires (e.g., `order.placed`)
+2. The subscriber checks if a WhatsApp config is active (DB → env vars fallback)
+3. It looks up all active event mappings for that event
+4. For each mapping, it resolves the recipient phone number based on the `recipient_type`
+5. It builds the WhatsApp Cloud API payload with template name, language, and variable parameters
+6. It sends the request to `https://graph.facebook.com/v25.0/{phone_number_id}/messages`
+7. The result (success or failure) is logged to the `whatsapp_message_log` table
 
 ---
 
-## Development & Local Testing
+## Database Schema
 
-If you want to modify this plugin locally, you can use local deployment environments such as Yalc.
+The plugin creates three tables:
 
-```bash
-# Build the plugin locally
-yarn build
+| Table | Purpose |
+|---|---|
+| `whatsapp_config` | Stores API credentials and settings (phone number ID, access token, API version, language, active toggle) |
+| `whatsapp_event_mapping` | Maps events to templates with recipient type, language, and variable configuration |
+| `whatsapp_message_log` | Logs every message attempt with status, payloads, and WhatsApp message ID |
 
-# Push to your local yalc footprint
-npx yalc push
-```
+---
 
-Then in your main Medusa Application directory:
-```bash
-npx yalc add @sam-ael/medusa-plugin-whatsapp
-yarn install
-```
+## Environment Variables Reference
 
-## Prerequisites
-- [WhatsApp Business Platform](https://business.facebook.com/) configuration.
-- A functional Meta Graph Token.
-- At least one active and approved message template.
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `WHATSAPP_PHONE_NUMBER_ID` | Yes* | — | Your WhatsApp Business phone number ID |
+| `WHATSAPP_ACCESS_TOKEN` | Yes* | — | Your WhatsApp Cloud API access token |
+| `WHATSAPP_API_VERSION` | No | `v25.0` | Facebook Graph API version |
+
+\* *Not required if configured through the admin dashboard.*
+
+---
 
 ## License
-MIT
+
+MIT — see [LICENSE](./LICENSE) for details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sam-ael/medusa-plugin-whatsapp",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "A MedusaJS 2 plugin for sending WhatsApp Business template messages on store events.",
   "author": "Samuel Ael (https://www.github.com/SAM-AEL)",
   "license": "MIT",