@sakeetech/medusa-payment-viva 0.2.2

package/dist/migrations/Migration_20260425000001_init_viva_payments.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Migration_20260425000001_init_viva_payments = void 0;
+const migrations_1 = require("@medusajs/framework/mikro-orm/migrations");
+/**
+ * S7 — initial migration: creates all three plugin-owned tables atomically.
+ *
+ * up()   — CREATE TABLE IF NOT EXISTS + indexes (idempotent).
+ * down() — Attempts COPY of viva_webhook_event raw_payload to /tmp before drop
+ *          for forensic preservation per plan line 205.
+ *          NOTE: COPY TO file requires the postgres superuser role. If the
+ *          migration runner connects as a non-superuser, this COPY will fail.
+ *          In that case, wrap the COPY in a DO block that catches the error and
+ *          logs a notice — data preservation is best-effort in non-superuser
+ *          deployments. Operators should take a pg_dump backup before running
+ *          down() in production.
+ */
+class Migration_20260425000001_init_viva_payments extends migrations_1.Migration {
+    async up() {
+        // Require gen_random_uuid() for viva_webhook_event PK default.
+        this.addSql(`CREATE EXTENSION IF NOT EXISTS pgcrypto;`);
+        // ------------------------------------------------------------------ --
+        // Table: viva_tenant_merchant
+        // ------------------------------------------------------------------ --
+        this.addSql(`
+      CREATE TABLE IF NOT EXISTS viva_tenant_merchant (
+        tenant_id             text        PRIMARY KEY,
+        connected_account_id  uuid        NOT NULL,
+        viva_merchant_id      uuid        NOT NULL,
+        verification_status   text        NOT NULL DEFAULT 'pending',
+        created_at            timestamptz NOT NULL DEFAULT now(),
+        updated_at            timestamptz NOT NULL DEFAULT now()
+      );
+    `);
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_tenant_merchant_viva_merchant_id_uniq
+        ON viva_tenant_merchant (viva_merchant_id);
+    `);
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_tenant_merchant_connected_account_id_uniq
+        ON viva_tenant_merchant (connected_account_id);
+    `);
+        // ------------------------------------------------------------------ --
+        // Table: viva_transaction
+        // ------------------------------------------------------------------ --
+        this.addSql(`
+      CREATE TABLE IF NOT EXISTS viva_transaction (
+        viva_transaction_id   uuid        PRIMARY KEY,
+        viva_order_code       bigint      NOT NULL,
+        medusa_payment_id     text        NOT NULL,
+        viva_merchant_id      uuid        NOT NULL,
+        status                text        NOT NULL CHECK (status IN (
+          'initiated','authorized','captured','refunded','cancelled','failed','disputed'
+        )),
+        claim_substate        text,
+        amount_minor          bigint      NOT NULL,
+        refunded_amount_minor bigint      NOT NULL DEFAULT 0,
+        currency_code         text        NOT NULL,
+        idempotency_key       text        NOT NULL,
+        raw_payload           jsonb,
+        created_at            timestamptz NOT NULL DEFAULT now(),
+        updated_at            timestamptz NOT NULL DEFAULT now()
+      );
+    `);
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_transaction_idempotency_key_uniq
+        ON viva_transaction (idempotency_key);
+    `);
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_transaction_viva_order_code_uniq
+        ON viva_transaction (viva_order_code);
+    `);
+        this.addSql(`
+      CREATE INDEX IF NOT EXISTS viva_transaction_medusa_payment_id_idx
+        ON viva_transaction (medusa_payment_id);
+    `);
+        this.addSql(`
+      CREATE INDEX IF NOT EXISTS viva_transaction_merchant_created_idx
+        ON viva_transaction (viva_merchant_id, created_at);
+    `);
+        // ------------------------------------------------------------------ --
+        // Table: viva_webhook_event
+        // ------------------------------------------------------------------ --
+        this.addSql(`
+      CREATE TABLE IF NOT EXISTS viva_webhook_event (
+        viva_webhook_event_id uuid        PRIMARY KEY DEFAULT gen_random_uuid(),
+        transaction_id        uuid,
+        event_type_id         int         NOT NULL,
+        message_id            uuid        NOT NULL,
+        viva_merchant_id      uuid,
+        connected_account_id  uuid,
+        processed_at          timestamptz,
+        raw_payload           jsonb       NOT NULL,
+        received_at           timestamptz NOT NULL DEFAULT now()
+      );
+    `);
+        // Partial unique: one event_type_id per transaction (dedup), only when
+        // transaction_id IS NOT NULL (onboarding events have NULL transaction_id).
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_webhook_event_txn_type_uniq
+        ON viva_webhook_event (transaction_id, event_type_id)
+        WHERE transaction_id IS NOT NULL;
+    `);
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_webhook_event_message_id_uniq
+        ON viva_webhook_event (message_id);
+    `);
+        this.addSql(`
+      CREATE INDEX IF NOT EXISTS viva_webhook_event_type_received_idx
+        ON viva_webhook_event (event_type_id, received_at);
+    `);
+    }
+    async down() {
+        // Best-effort: export raw_payload rows to /tmp before drop.
+        // COPY TO requires pg superuser. Wrapped in a DO block so non-superuser
+        // deployments degrade gracefully (notice logged, drop proceeds).
+        // TODO(ops): run pg_dump before down() in production.
+        const exportTs = new Date().toISOString().replace(/[^0-9]/g, "").slice(0, 14);
+        this.addSql(`
+      DO $$
+      BEGIN
+        COPY (SELECT * FROM viva_webhook_event)
+          TO '/tmp/viva_webhook_event_${exportTs}.json';
+        RAISE NOTICE 'viva_webhook_event exported to /tmp/viva_webhook_event_${exportTs}.json';
+      EXCEPTION WHEN insufficient_privilege THEN
+        RAISE NOTICE 'COPY skipped (insufficient privilege) — backup viva_webhook_event manually before drop.';
+      END;
+      $$;
+    `);
+        this.addSql(`DROP TABLE IF EXISTS viva_webhook_event;`);
+        this.addSql(`DROP TABLE IF EXISTS viva_transaction;`);
+        this.addSql(`DROP TABLE IF EXISTS viva_tenant_merchant;`);
+    }
+}
+exports.Migration_20260425000001_init_viva_payments = Migration_20260425000001_init_viva_payments;
+//# sourceMappingURL=Migration_20260425000001_init_viva_payments.js.map

package/dist/migrations/Migration_20260425000001_init_viva_payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration_20260425000001_init_viva_payments.js","sourceRoot":"","sources":["../../src/migrations/Migration_20260425000001_init_viva_payments.ts"],"names":[],"mappings":";;;AAAA,yEAAqE;AAErE;;;;;;;;;;;;GAYG;AACH,MAAa,2CAA4C,SAAQ,sBAAS;IAC/D,KAAK,CAAC,EAAE;QACf,+DAA+D;QAC/D,IAAI,CAAC,MAAM,CACT,0CAA0C,CAC3C,CAAC;QAEF,wEAAwE;QACxE,8BAA8B;QAC9B,wEAAwE;QACxE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;KASX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,wEAAwE;QACxE,0BAA0B;QAC1B,wEAAwE;QACxE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;KAkBX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,wEAAwE;QACxE,4BAA4B;QAC5B,wEAAwE;QACxE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;KAYX,CAAC,CAAC;QAEH,uEAAuE;QACvE,2EAA2E;QAC3E,IAAI,CAAC,MAAM,CAAC;;;;KAIX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,4DAA4D;QAC5D,wEAAwE;QACxE,iEAAiE;QACjE,sDAAsD;QACtD,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC;;;;wCAIwB,QAAQ;+EAC+B,QAAQ;;;;;KAKlF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,0CAA0C,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;CACF;AApID,kGAoIC"}

package/dist/migrations/Migration_20260425000002_allow_null_order_code.d.ts

@@ -0,0 +1,31 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations";
+/**
+ * Migration_20260425000002_allow_null_order_code
+ *
+ * Write-pending-first (A4): makes viva_transaction.viva_order_code nullable
+ * so the plugin can INSERT a pending row BEFORE calling Viva's createOrder API.
+ *
+ * Rationale: the A4 amendment requires that a local DB record exists before any
+ * outbound HTTP call. If createOrder fails after INSERT, the row stays at
+ * status='initiated' with viva_order_code=NULL. A reaper job (S10/S11) will
+ * retry or expire these stuck rows. The alternative (NOT NULL DEFAULT 0) would
+ * require app-level enforcement that 0 means "not yet assigned", which is
+ * error-prone and not semantically clean.
+ *
+ * Decision: chose nullable over DEFAULT 0 because NULL is semantically honest —
+ * an absent order code is not the same as order code 0.
+ *
+ * The UNIQUE index on viva_order_code uses a partial index (WHERE viva_order_code
+ * IS NOT NULL) to allow multiple NULL rows without violating the constraint.
+ * Multiple in-flight pending rows (each with NULL order_code) are valid as long
+ * as their idempotency_key is unique — the idempotency_key UNIQUE index covers
+ * the dedup requirement.
+ *
+ * up():   ALTER COLUMN → nullable; recreate unique index as partial.
+ * down(): backfill NULLs to 0; ALTER COLUMN → NOT NULL.
+ */
+export declare class Migration_20260425000002_allow_null_order_code extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=Migration_20260425000002_allow_null_order_code.d.ts.map

package/dist/migrations/Migration_20260425000002_allow_null_order_code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration_20260425000002_allow_null_order_code.d.ts","sourceRoot":"","sources":["../../src/migrations/Migration_20260425000002_allow_null_order_code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,8CAA+C,SAAQ,SAAS;IAC5D,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAwBrC"}

package/dist/migrations/Migration_20260425000002_allow_null_order_code.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Migration_20260425000002_allow_null_order_code = void 0;
+const migrations_1 = require("@medusajs/framework/mikro-orm/migrations");
+/**
+ * Migration_20260425000002_allow_null_order_code
+ *
+ * Write-pending-first (A4): makes viva_transaction.viva_order_code nullable
+ * so the plugin can INSERT a pending row BEFORE calling Viva's createOrder API.
+ *
+ * Rationale: the A4 amendment requires that a local DB record exists before any
+ * outbound HTTP call. If createOrder fails after INSERT, the row stays at
+ * status='initiated' with viva_order_code=NULL. A reaper job (S10/S11) will
+ * retry or expire these stuck rows. The alternative (NOT NULL DEFAULT 0) would
+ * require app-level enforcement that 0 means "not yet assigned", which is
+ * error-prone and not semantically clean.
+ *
+ * Decision: chose nullable over DEFAULT 0 because NULL is semantically honest —
+ * an absent order code is not the same as order code 0.
+ *
+ * The UNIQUE index on viva_order_code uses a partial index (WHERE viva_order_code
+ * IS NOT NULL) to allow multiple NULL rows without violating the constraint.
+ * Multiple in-flight pending rows (each with NULL order_code) are valid as long
+ * as their idempotency_key is unique — the idempotency_key UNIQUE index covers
+ * the dedup requirement.
+ *
+ * up():   ALTER COLUMN → nullable; recreate unique index as partial.
+ * down(): backfill NULLs to 0; ALTER COLUMN → NOT NULL.
+ */
+class Migration_20260425000002_allow_null_order_code extends migrations_1.Migration {
+    async up() {
+        // 1. Drop the existing non-partial unique index on viva_order_code
+        this.addSql(`
+      DROP INDEX IF EXISTS viva_transaction_viva_order_code_uniq;
+    `);
+        // 2. Make viva_order_code nullable
+        this.addSql(`
+      ALTER TABLE viva_transaction
+        ALTER COLUMN viva_order_code DROP NOT NULL;
+    `);
+        // 3. Recreate as partial unique index (NULL values are excluded)
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_transaction_viva_order_code_uniq
+        ON viva_transaction (viva_order_code)
+        WHERE viva_order_code IS NOT NULL;
+    `);
+    }
+    async down() {
+        // Backfill any NULL viva_order_code rows to 0 before restoring NOT NULL.
+        // 0 is not a valid Viva order code, so operators can identify affected rows.
+        this.addSql(`
+      UPDATE viva_transaction SET viva_order_code = 0 WHERE viva_order_code IS NULL;
+    `);
+        // Drop partial unique index
+        this.addSql(`
+      DROP INDEX IF EXISTS viva_transaction_viva_order_code_uniq;
+    `);
+        // Restore NOT NULL constraint
+        this.addSql(`
+      ALTER TABLE viva_transaction
+        ALTER COLUMN viva_order_code SET NOT NULL;
+    `);
+        // Recreate original non-partial unique index
+        this.addSql(`
+      CREATE UNIQUE INDEX IF NOT EXISTS viva_transaction_viva_order_code_uniq
+        ON viva_transaction (viva_order_code);
+    `);
+    }
+}
+exports.Migration_20260425000002_allow_null_order_code = Migration_20260425000002_allow_null_order_code;
+//# sourceMappingURL=Migration_20260425000002_allow_null_order_code.js.map

package/dist/migrations/Migration_20260425000002_allow_null_order_code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration_20260425000002_allow_null_order_code.js","sourceRoot":"","sources":["../../src/migrations/Migration_20260425000002_allow_null_order_code.ts"],"names":[],"mappings":";;;AAAA,yEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,8CAA+C,SAAQ,sBAAS;IAClE,KAAK,CAAC,EAAE;QACf,mEAAmE;QACnE,IAAI,CAAC,MAAM,CAAC;;KAEX,CAAC,CAAC;QAEH,mCAAmC;QACnC,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,iEAAiE;QACjE,IAAI,CAAC,MAAM,CAAC;;;;KAIX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,yEAAyE;QACzE,6EAA6E;QAC7E,IAAI,CAAC,MAAM,CAAC;;KAEX,CAAC,CAAC;QAEH,4BAA4B;QAC5B,IAAI,CAAC,MAAM,CAAC;;KAEX,CAAC,CAAC;QAEH,8BAA8B;QAC9B,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,6CAA6C;QAC7C,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;CACF;AA7CD,wGA6CC"}

package/dist/migrations/Migration_20260425000003_webhook_retry_count.d.ts

@@ -0,0 +1,18 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations";
+/**
+ * Migration_20260425000003_webhook_retry_count
+ *
+ * A6: adds `retry_count int NOT NULL DEFAULT 0` to `viva_webhook_event`.
+ * Required by `reprocessUnresolvedTenants` to track how many times tenant
+ * resolution has been attempted for unresolved webhook events.
+ *
+ * up():   ADD COLUMN retry_count int NOT NULL DEFAULT 0.
+ * down(): DROP COLUMN retry_count.
+ *
+ * @see references/viva-docs/md/isv-partner-program.txt:61 (A6 tenant fallback + reprocess)
+ */
+export declare class Migration_20260425000003_webhook_retry_count extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=Migration_20260425000003_webhook_retry_count.d.ts.map

package/dist/migrations/Migration_20260425000003_webhook_retry_count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration_20260425000003_webhook_retry_count.d.ts","sourceRoot":"","sources":["../../src/migrations/Migration_20260425000003_webhook_retry_count.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,qBAAa,4CAA6C,SAAQ,SAAS;IAC1D,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAenB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAUrC"}

package/dist/migrations/Migration_20260425000003_webhook_retry_count.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Migration_20260425000003_webhook_retry_count = void 0;
+const migrations_1 = require("@medusajs/framework/mikro-orm/migrations");
+/**
+ * Migration_20260425000003_webhook_retry_count
+ *
+ * A6: adds `retry_count int NOT NULL DEFAULT 0` to `viva_webhook_event`.
+ * Required by `reprocessUnresolvedTenants` to track how many times tenant
+ * resolution has been attempted for unresolved webhook events.
+ *
+ * up():   ADD COLUMN retry_count int NOT NULL DEFAULT 0.
+ * down(): DROP COLUMN retry_count.
+ *
+ * @see references/viva-docs/md/isv-partner-program.txt:61 (A6 tenant fallback + reprocess)
+ */
+class Migration_20260425000003_webhook_retry_count extends migrations_1.Migration {
+    async up() {
+        this.addSql(`
+      ALTER TABLE viva_webhook_event
+        ADD COLUMN IF NOT EXISTS retry_count int NOT NULL DEFAULT 0;
+    `);
+        // Index to make the reprocess query efficient:
+        // SELECT ... WHERE processed_at IS NULL AND received_at < ... AND retry_count < ...
+        this.addSql(`
+      CREATE INDEX IF NOT EXISTS viva_webhook_event_unresolved_retry_idx
+        ON viva_webhook_event (received_at, retry_count)
+        WHERE processed_at IS NULL;
+    `);
+    }
+    async down() {
+        this.addSql(`
+      DROP INDEX IF EXISTS viva_webhook_event_unresolved_retry_idx;
+    `);
+        this.addSql(`
+      ALTER TABLE viva_webhook_event
+        DROP COLUMN IF EXISTS retry_count;
+    `);
+    }
+}
+exports.Migration_20260425000003_webhook_retry_count = Migration_20260425000003_webhook_retry_count;
+//# sourceMappingURL=Migration_20260425000003_webhook_retry_count.js.map

package/dist/migrations/Migration_20260425000003_webhook_retry_count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration_20260425000003_webhook_retry_count.js","sourceRoot":"","sources":["../../src/migrations/Migration_20260425000003_webhook_retry_count.ts"],"names":[],"mappings":";;;AAAA,yEAAqE;AAErE;;;;;;;;;;;GAWG;AACH,MAAa,4CAA6C,SAAQ,sBAAS;IAChE,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,+CAA+C;QAC/C,oFAAoF;QACpF,IAAI,CAAC,MAAM,CAAC;;;;KAIX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC;;KAEX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;CACF;AA1BD,oGA0BC"}

package/dist/migrations/Migration_20260425000004_webhook_error_and_nullable_merchant.d.ts

@@ -0,0 +1,29 @@
+import { Migration } from "@medusajs/framework/mikro-orm/migrations";
+/**
+ * Migration_20260425000004_webhook_error_and_nullable_merchant
+ *
+ * Phase 2 slice D — unifies the Medusa schema with Vendure for multi-mode v0.2.0.
+ *
+ *   1. viva_webhook_event.error (text, nullable) — last failure envelope (JSON);
+ *      operator playbook in docs/ERRORS.md §6 reads this column to diagnose
+ *      stuck payments. Vendure already has it.
+ *   2. viva_transaction.viva_merchant_id — drop NOT NULL. Merchant-mode rows
+ *      don't have a per-cart merchant id (the plugin operates a single account).
+ *
+ * Forward-safe:
+ *   - Existing viva_webhook_event rows get error=NULL (no backfill needed).
+ *   - viva_transaction.viva_merchant_id stays populated for existing rows.
+ *
+ * Reversible:
+ *   - down() drops the error column. The viva_merchant_id NOT NULL constraint
+ *     is restored ONLY if no rows currently have NULL — otherwise the migration
+ *     aborts with a clear error so the operator can backfill before retry.
+ *
+ * @see docs/plans/multi-mode-v0.md §9.6.5 (schema migration spec)
+ * @see docs/ERRORS.md §6 (operator playbook requires `error` column)
+ */
+export declare class Migration_20260425000004_webhook_error_and_nullable_merchant extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=Migration_20260425000004_webhook_error_and_nullable_merchant.d.ts.map

package/dist/migrations/Migration_20260425000004_webhook_error_and_nullable_merchant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration_20260425000004_webhook_error_and_nullable_merchant.d.ts","sourceRoot":"","sources":["../../src/migrations/Migration_20260425000004_webhook_error_and_nullable_merchant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,4DAA6D,SAAQ,SAAS;IAC1E,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAcnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiCrC"}

package/dist/migrations/Migration_20260425000004_webhook_error_and_nullable_merchant.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Migration_20260425000004_webhook_error_and_nullable_merchant = void 0;
+const migrations_1 = require("@medusajs/framework/mikro-orm/migrations");
+/**
+ * Migration_20260425000004_webhook_error_and_nullable_merchant
+ *
+ * Phase 2 slice D — unifies the Medusa schema with Vendure for multi-mode v0.2.0.
+ *
+ *   1. viva_webhook_event.error (text, nullable) — last failure envelope (JSON);
+ *      operator playbook in docs/ERRORS.md §6 reads this column to diagnose
+ *      stuck payments. Vendure already has it.
+ *   2. viva_transaction.viva_merchant_id — drop NOT NULL. Merchant-mode rows
+ *      don't have a per-cart merchant id (the plugin operates a single account).
+ *
+ * Forward-safe:
+ *   - Existing viva_webhook_event rows get error=NULL (no backfill needed).
+ *   - viva_transaction.viva_merchant_id stays populated for existing rows.
+ *
+ * Reversible:
+ *   - down() drops the error column. The viva_merchant_id NOT NULL constraint
+ *     is restored ONLY if no rows currently have NULL — otherwise the migration
+ *     aborts with a clear error so the operator can backfill before retry.
+ *
+ * @see docs/plans/multi-mode-v0.md §9.6.5 (schema migration spec)
+ * @see docs/ERRORS.md §6 (operator playbook requires `error` column)
+ */
+class Migration_20260425000004_webhook_error_and_nullable_merchant extends migrations_1.Migration {
+    async up() {
+        // ---- viva_webhook_event.error (nullable text) ----
+        this.addSql(`
+      ALTER TABLE viva_webhook_event
+        ADD COLUMN IF NOT EXISTS error text;
+    `);
+        // ---- viva_transaction.viva_merchant_id → nullable ----
+        this.addSql(`
+      ALTER TABLE viva_transaction
+        ALTER COLUMN viva_merchant_id DROP NOT NULL;
+    `);
+    }
+    async down() {
+        // Drop the error column (data loss for any recorded failures — log it).
+        this.addSql(`
+      ALTER TABLE viva_webhook_event
+        DROP COLUMN IF EXISTS error;
+    `);
+        // Restore NOT NULL on viva_merchant_id. Guard against NULL rows: if any
+        // exist (merchant-mode rows from v0.2.0+), the migration aborts cleanly.
+        // Operators must backfill or delete those rows before downgrading.
+        this.addSql(`
+      DO $$
+      DECLARE
+        null_count int;
+      BEGIN
+        SELECT count(*) INTO null_count
+          FROM viva_transaction
+         WHERE viva_merchant_id IS NULL;
+        IF null_count > 0 THEN
+          RAISE EXCEPTION
+            'Cannot restore NOT NULL on viva_transaction.viva_merchant_id: % rows have NULL. '
+            'Backfill or delete those rows (merchant-mode rows from v0.2.0+) before downgrading.',
+            null_count;
+        END IF;
+      END;
+      $$;
+    `);
+        this.addSql(`
+      ALTER TABLE viva_transaction
+        ALTER COLUMN viva_merchant_id SET NOT NULL;
+    `);
+    }
+}
+exports.Migration_20260425000004_webhook_error_and_nullable_merchant = Migration_20260425000004_webhook_error_and_nullable_merchant;
+//# sourceMappingURL=Migration_20260425000004_webhook_error_and_nullable_merchant.js.map

package/dist/migrations/Migration_20260425000004_webhook_error_and_nullable_merchant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration_20260425000004_webhook_error_and_nullable_merchant.js","sourceRoot":"","sources":["../../src/migrations/Migration_20260425000004_webhook_error_and_nullable_merchant.ts"],"names":[],"mappings":";;;AAAA,yEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,4DAA6D,SAAQ,sBAAS;IAChF,KAAK,CAAC,EAAE;QACf,qDAAqD;QACrD,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,yDAAyD;QACzD,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,wEAAwE;QACxE,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,wEAAwE;QACxE,yEAAyE;QACzE,mEAAmE;QACnE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;KAgBX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;CACF;AAhDD,oIAgDC"}

package/dist/models/index.d.ts

@@ -0,0 +1,7 @@
+export { VivaTenantMerchantSchema } from "./viva-tenant-merchant.js";
+export type { VivaTenantMerchant } from "./viva-tenant-merchant.js";
+export { VivaTransactionSchema } from "./viva-transaction.js";
+export type { VivaTransaction, VivaTransactionStatus } from "./viva-transaction.js";
+export { VivaWebhookEventSchema } from "./viva-webhook-event.js";
+export type { VivaWebhookEvent } from "./viva-webhook-event.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VivaWebhookEventSchema = exports.VivaTransactionSchema = exports.VivaTenantMerchantSchema = void 0;
+var viva_tenant_merchant_js_1 = require("./viva-tenant-merchant.js");
+Object.defineProperty(exports, "VivaTenantMerchantSchema", { enumerable: true, get: function () { return viva_tenant_merchant_js_1.VivaTenantMerchantSchema; } });
+var viva_transaction_js_1 = require("./viva-transaction.js");
+Object.defineProperty(exports, "VivaTransactionSchema", { enumerable: true, get: function () { return viva_transaction_js_1.VivaTransactionSchema; } });
+var viva_webhook_event_js_1 = require("./viva-webhook-event.js");
+Object.defineProperty(exports, "VivaWebhookEventSchema", { enumerable: true, get: function () { return viva_webhook_event_js_1.VivaWebhookEventSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AAA5D,mIAAA,wBAAwB,OAAA;AAEjC,6DAA8D;AAArD,4HAAA,qBAAqB,OAAA;AAE9B,iEAAiE;AAAxD,+HAAA,sBAAsB,OAAA"}

package/dist/models/viva-tenant-merchant.d.ts

@@ -0,0 +1,11 @@
+import { EntitySchema } from "@medusajs/framework/mikro-orm/core";
+export interface VivaTenantMerchant {
+    tenant_id: string;
+    connected_account_id: string;
+    viva_merchant_id: string;
+    verification_status: string;
+    created_at: Date;
+    updated_at: Date;
+}
+export declare const VivaTenantMerchantSchema: EntitySchema<VivaTenantMerchant, never>;
+//# sourceMappingURL=viva-tenant-merchant.d.ts.map

package/dist/models/viva-tenant-merchant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva-tenant-merchant.d.ts","sourceRoot":"","sources":["../../src/models/viva-tenant-merchant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,eAAO,MAAM,wBAAwB,yCAgDnC,CAAC"}

package/dist/models/viva-tenant-merchant.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VivaTenantMerchantSchema = void 0;
+const core_1 = require("@medusajs/framework/mikro-orm/core");
+exports.VivaTenantMerchantSchema = new core_1.EntitySchema({
+    name: "VivaTenantMerchant",
+    tableName: "viva_tenant_merchant",
+    uniques: [
+        {
+            name: "viva_tenant_merchant_viva_merchant_id_uniq",
+            properties: ["viva_merchant_id"],
+        },
+        {
+            name: "viva_tenant_merchant_connected_account_id_uniq",
+            properties: ["connected_account_id"],
+        },
+    ],
+    properties: {
+        tenant_id: {
+            type: "string",
+            columnType: "text",
+            primary: true,
+        },
+        connected_account_id: {
+            type: "string",
+            columnType: "uuid",
+            nullable: false,
+        },
+        viva_merchant_id: {
+            type: "string",
+            columnType: "uuid",
+            nullable: false,
+        },
+        verification_status: {
+            type: "string",
+            columnType: "text",
+            nullable: false,
+            default: "pending",
+        },
+        created_at: {
+            type: "Date",
+            columnType: "timestamptz",
+            nullable: false,
+            defaultRaw: "now()",
+        },
+        updated_at: {
+            type: "Date",
+            columnType: "timestamptz",
+            nullable: false,
+            defaultRaw: "now()",
+        },
+    },
+});
+//# sourceMappingURL=viva-tenant-merchant.js.map

package/dist/models/viva-tenant-merchant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva-tenant-merchant.js","sourceRoot":"","sources":["../../src/models/viva-tenant-merchant.ts"],"names":[],"mappings":";;;AAAA,6DAAkE;AAWrD,QAAA,wBAAwB,GAAG,IAAI,mBAAY,CAAqB;IAC3E,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE;QACP;YACE,IAAI,EAAE,4CAA4C;YAClD,UAAU,EAAE,CAAC,kBAAkB,CAAC;SACjC;QACD;YACE,IAAI,EAAE,gDAAgD;YACtD,UAAU,EAAE,CAAC,sBAAsB,CAAC;SACrC;KACF;IACD,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,IAAI;SACd;QACD,oBAAoB,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,KAAK;SAChB;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,KAAK;SAChB;QACD,mBAAmB,EAAE;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,SAAS;SACnB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,OAAO;SACpB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,OAAO;SACpB;KACF;CACF,CAAC,CAAC"}

package/dist/models/viva-transaction.d.ts

@@ -0,0 +1,34 @@
+import { EntitySchema } from "@medusajs/framework/mikro-orm/core";
+export type VivaTransactionStatus = "initiated" | "authorized" | "captured" | "refunded" | "cancelled" | "failed" | "disputed";
+export interface VivaTransaction {
+    viva_transaction_id: string;
+    /**
+     * Viva order code (int64, stored as string for bigint safety).
+     * NULL until viva createOrder returns successfully (A4 write-pending-first).
+     * Migration_20260425000002 made this column nullable.
+     *
+     * @see references/viva-docs/md/payment-isv-api.txt:1 (createOrder response)
+     * @see references/viva-docs/md/isv-partner-program.txt:61 (A4 write-pending-first)
+     */
+    viva_order_code: string | null | undefined;
+    medusa_payment_id: string;
+    /**
+     * Viva merchant id (uuid). NULL for merchant-mode rows where there is no
+     * per-cart tenant merchant id — the plugin operates a single account.
+     * Migration_20260425000004 made this column nullable.
+     *
+     * @see references/viva-docs/md/isv-partner-program.txt:61 (multi-mode v0.2.0)
+     */
+    viva_merchant_id: string | null | undefined;
+    status: VivaTransactionStatus;
+    claim_substate: string | null | undefined;
+    amount_minor: string;
+    refunded_amount_minor: string;
+    currency_code: string;
+    idempotency_key: string;
+    raw_payload: Record<string, unknown> | null | undefined;
+    created_at: Date;
+    updated_at: Date;
+}
+export declare const VivaTransactionSchema: EntitySchema<VivaTransaction, never>;
+//# sourceMappingURL=viva-transaction.d.ts.map

package/dist/models/viva-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva-transaction.d.ts","sourceRoot":"","sources":["../../src/models/viva-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE1C,YAAY,EAAE,MAAM,CAAC;IAErB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACxD,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,eAAO,MAAM,qBAAqB,sCAkGhC,CAAC"}