@sakeetech/vendure-payment-viva 0.2.1

package/dist/jobs/process-viva-webhook.handler.js

@@ -0,0 +1,530 @@
+/**
+ * jobs/process-viva-webhook.handler.ts — BullMQ webhook worker job handler.
+ *
+ * Registered with Vendure's JobQueueService at bootstrap. Processes one
+ * `viva_webhook_event` row per job execution.
+ *
+ * Process flow (see plan §"Webhook Design — Process flow"):
+ *  1. Load row by messageId. Already-processed or missing → no-op.
+ *  2. Resolve channel by EventData.MerchantId (60s LRU cache).
+ *     If not found → A6 NULL-merchant fallback: schedule reprocess with backoff.
+ *  3. Acquire per-merchant in-process semaphore (5 permits).
+ *  4. Switch on eventTypeId:
+ *     1796 → Retrieve-Transaction → validate → settle
+ *     1798 → mark Declined, leave order in ArrangingPayment
+ *     1797 → audit log only
+ *     4865 → optional cancel detection
+ *     8193 → log only
+ *     8194 → write vivaMerchantId THEN vivaPayoutsEnabled
+ *  5. Release semaphore.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Build Plan — V7"
+ * @see docs/plans/vendure-plugin-v0.md §"Webhook Design — Process flow"
+ * @see docs/VENDURE-CONTRACT.MD §4, §5, §10
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Injectable, Inject } from '@nestjs/common';
+import { JobQueueService, JobQueue, Logger, TransactionalConnection, RequestContextService, OrderService, ChannelService, PaymentService, } from '@vendure/core';
+import { IsvHttpClient, IsvAccounts } from '@sakeetech/viva-payments-core/isv';
+import { Payments } from '@sakeetech/viva-payments-core/payments';
+import { VivaOAuth2StrategyProvider } from '../providers/viva-oauth2-strategy.provider.js';
+import { StateMachineService } from '../services/state-machine.service.js';
+import { PerMerchantSemaphore } from '../services/per-merchant-semaphore.service.js';
+import { ConnectedAccountsService } from '../services/connected-accounts.service.js';
+import { VivaWebhookEvent } from '../entities/viva-webhook-event.entity.js';
+import { VivaTransaction } from '../entities/viva-transaction.entity.js';
+import { VivaPluginError } from '../util/error-envelope.js';
+import { VIVA_PLUGIN_OPTIONS, VIVA_OAUTH2_STRATEGY_TOKEN, VIVA_LOG_CONTEXT, VIVA_WEBHOOK_QUEUE, VIVA_PROCESS_EVENT_JOB, } from '../constants.js';
+const CHANNEL_CACHE_TTL_MS = 60_000;
+const merchantChannelCache = new Map();
+function getCachedChannelId(merchantId) {
+    const entry = merchantChannelCache.get(merchantId);
+    if (!entry)
+        return undefined;
+    if (Date.now() > entry.expiresAt) {
+        merchantChannelCache.delete(merchantId);
+        return undefined;
+    }
+    return entry.channelId;
+}
+function setCachedChannelId(merchantId, channelId) {
+    merchantChannelCache.set(merchantId, { channelId, expiresAt: Date.now() + CHANNEL_CACHE_TTL_MS });
+}
+// ---------------------------------------------------------------------------
+// Backoff schedule for A6 NULL-merchant fallback (4 attempts max)
+// ---------------------------------------------------------------------------
+const A6_BACKOFF_DELAYS_MS = [
+    60_000, //  1 min
+    5 * 60_000, //  5 min
+    30 * 60_000, // 30 min
+    2 * 60 * 60_000, //  2 hr
+];
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+let ProcessVivaWebhookHandler = class ProcessVivaWebhookHandler {
+    jobQueueService;
+    connection;
+    stateMachine;
+    semaphore;
+    connectedAccounts;
+    orderService;
+    paymentService;
+    channelService;
+    requestContextService;
+    options;
+    oauth2;
+    queue;
+    constructor(jobQueueService, connection, stateMachine, semaphore, connectedAccounts, orderService, paymentService, channelService, requestContextService, options, oauth2) {
+        this.jobQueueService = jobQueueService;
+        this.connection = connection;
+        this.stateMachine = stateMachine;
+        this.semaphore = semaphore;
+        this.connectedAccounts = connectedAccounts;
+        this.orderService = orderService;
+        this.paymentService = paymentService;
+        this.channelService = channelService;
+        this.requestContextService = requestContextService;
+        this.options = options;
+        this.oauth2 = oauth2;
+    }
+    async onApplicationBootstrap() {
+        this.queue = await this.jobQueueService.createQueue({
+            name: VIVA_WEBHOOK_QUEUE,
+            process: (job) => this._processJob(job),
+        });
+    }
+    /**
+     * Enqueue a new webhook processing job.
+     * Called by the webhook controller (V6) after INSERT-OR-NOTHING succeeds.
+     */
+    async enqueue(data, delayMs = 0) {
+        await this.queue.add(data, delayMs > 0 ? { retries: 0 } : undefined);
+    }
+    // ---------------------------------------------------------------------------
+    // Core job logic
+    // ---------------------------------------------------------------------------
+    async _processJob(job) {
+        const { messageId } = job.data;
+        // -------------------------------------------------------------------------
+        // Step 1: load event row
+        // -------------------------------------------------------------------------
+        const eventRepo = this.connection.rawConnection.getRepository(VivaWebhookEvent);
+        const event = await eventRepo.findOne({ where: { messageId } });
+        if (!event) {
+            Logger.info(`[webhook:${messageId}] Row not found — possibly deleted or never inserted. Skipping.`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        if (event.processedAt !== null) {
+            Logger.info(`[webhook:${messageId}] Already processed at ${event.processedAt.toISOString()}. Idempotent no-op.`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        // -------------------------------------------------------------------------
+        // Step 2: resolve channel.
+        //
+        //   ISV mode      → look up by `EventData.MerchantId` (LRU + linear scan).
+        //                   A NULL merchantId triggers A6 backoff fallback.
+        //   Merchant mode → there is no per-tenant merchantId in single-merchant
+        //                   deployments. Resolve to the default channel; only one
+        //                   merchant is configured plugin-wide, so all webhook
+        //                   events belong to the default channel.
+        //                   @see docs/plans/multi-mode-v0.md §9 (webhook channel resolution)
+        // -------------------------------------------------------------------------
+        const merchantId = event.merchantId;
+        // Build a system-level ctx for channel operations (no channel known yet)
+        const systemCtx = await this.requestContextService.create({ apiType: 'admin' });
+        let channelId;
+        if (this.options.mode !== 'isv') {
+            // Merchant mode: use the default channel. Single-merchant deployments
+            // have no per-tenant mapping to perform — the operator may run multiple
+            // Vendure channels for catalog/locale split, but Viva traffic belongs
+            // to the default channel registered when the plugin was initialized.
+            const defaultChannel = await this.channelService.getDefaultChannel(systemCtx);
+            channelId = defaultChannel.id;
+        }
+        else if (merchantId) {
+            // ISV mode: check LRU cache first.
+            channelId = getCachedChannelId(merchantId);
+            if (!channelId) {
+                // Linear scan over channels (typically ≤ N=10 channels per deployment)
+                const allChannels = await this.channelService.findAll(systemCtx);
+                for (const ch of allChannels.items) {
+                    const cf = ch.customFields;
+                    if (cf && cf['vivaMerchantId'] === merchantId) {
+                        channelId = ch.id;
+                        setCachedChannelId(merchantId, channelId);
+                        break;
+                    }
+                }
+            }
+        }
+        if (!channelId) {
+            // A6 NULL-merchant fallback: set merchantId NULL on row, schedule reprocess with backoff.
+            await eventRepo.update({ messageId }, { merchantId: null, error: 'channel-not-found' });
+            // Determine which attempt this is (retry_count starts at 0)
+            const attemptIndex = event.retryCount;
+            if (attemptIndex < A6_BACKOFF_DELAYS_MS.length) {
+                const delayMs = A6_BACKOFF_DELAYS_MS[attemptIndex];
+                Logger.warn(`[webhook:${messageId}] Channel not found for merchantId=${merchantId ?? 'null'}. Scheduling reprocess attempt ${attemptIndex + 1} in ${delayMs}ms.`, VIVA_LOG_CONTEXT);
+                // Increment retry_count on the row
+                await eventRepo.increment({ messageId }, 'retryCount', 1);
+                // Re-enqueue with backoff (BullMQ delay option)
+                await this.queue.add({ messageId }, { retries: 0 });
+            }
+            else {
+                Logger.error(`[webhook:${messageId}] Channel not found after ${attemptIndex} attempts for merchantId=${merchantId ?? 'null'}. Row left stuck — check metrics.`, VIVA_LOG_CONTEXT);
+            }
+            return;
+        }
+        // -------------------------------------------------------------------------
+        // Step 3: acquire per-merchant semaphore
+        // -------------------------------------------------------------------------
+        const release = await this.semaphore.acquire(merchantId ?? `channel:${String(channelId)}`);
+        try {
+            // Build a channel-scoped ctx for order/payment operations
+            const ctx = await this.requestContextService.create({ apiType: 'admin', channelOrToken: await this._loadChannel(channelId) });
+            // -----------------------------------------------------------------------
+            // Step 4: switch on eventTypeId
+            // -----------------------------------------------------------------------
+            switch (event.eventTypeId) {
+                case 1796:
+                    await this._handle1796(ctx, event, eventRepo);
+                    break;
+                case 1798:
+                    await this._handle1798(ctx, event, eventRepo);
+                    break;
+                case 1797:
+                    Logger.info(`[webhook:${messageId}] 1797 Refund Created — audit log only (refund was admin-initiated).`, VIVA_LOG_CONTEXT);
+                    await this._markProcessed(eventRepo, messageId);
+                    break;
+                case 4865:
+                    await this._handle4865(ctx, event, eventRepo);
+                    break;
+                case 8193:
+                    // Onboarding lifecycle event — only meaningful in ISV mode (there is
+                    // no onboarding flow in merchant mode). Mark processed in both modes
+                    // to prevent infinite reprocessing.
+                    Logger.info(`[webhook:${messageId}] 8193 Account Connected — analytics, no state change` +
+                        `${this.options.mode === 'isv' ? '' : ' (merchant mode: no-op)'}.`, VIVA_LOG_CONTEXT);
+                    await this._markProcessed(eventRepo, messageId);
+                    break;
+                case 8194:
+                    if (this.options.mode === 'isv') {
+                        await this._handle8194(systemCtx, event, eventRepo);
+                    }
+                    else {
+                        // Merchant mode: no onboarding flip — the merchant configured the
+                        // plugin with their own legacyMerchantId / legacyApiKey directly,
+                        // so the verification status is moot for plugin behaviour.
+                        Logger.info(`[webhook:${messageId}] 8194 Account Verification — merchant mode: no-op.`, VIVA_LOG_CONTEXT);
+                        await this._markProcessed(eventRepo, messageId);
+                    }
+                    break;
+                default:
+                    Logger.info(`[webhook:${messageId}] Unknown eventTypeId=${event.eventTypeId} — marking processed to prevent infinite reprocessing.`, VIVA_LOG_CONTEXT);
+                    await this._markProcessed(eventRepo, messageId);
+                    break;
+            }
+        }
+        finally {
+            await release();
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Event handlers
+    // ---------------------------------------------------------------------------
+    /**
+     * 1796 — Transaction Payment Created (settle path).
+     *
+     * a. Retrieve transaction from Viva.
+     * b. Validate orderCode, statusId='F', amount.
+     * c. Load order + payment, check current state.
+     * d. Settle (or re-walk if AddingItems).
+     * e. Update viva_transaction row.
+     * f. Mark event processed.
+     */
+    async _handle1796(ctx, event, eventRepo) {
+        const { messageId } = event;
+        const payload = event.payload;
+        const eventData = (payload['EventData'] ?? payload);
+        const transactionId = (event.transactionId ?? eventData['TransactionId']);
+        const merchantId = event.merchantId;
+        if (!transactionId) {
+            await eventRepo.update({ messageId }, { error: 'missing-transaction-id' });
+            Logger.error(`[webhook:${messageId}] 1796: no transactionId in payload.`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        // a. Retrieve transaction from Viva.
+        // - ISV mode: pass merchantId from the webhook payload → /isv/transactions/{id}?merchantId=…
+        // - Merchant mode: omit merchantId → /transactions/{id} (Payments drops it anyway).
+        const isvPayments = this._getIsvPayments();
+        let vivaTransaction;
+        try {
+            const retrieveOpts = this.options.mode === 'isv' && merchantId ? { merchantId } : {};
+            vivaTransaction = await isvPayments.retrieveTransaction(transactionId, retrieveOpts);
+        }
+        catch (err) {
+            await eventRepo.update({ messageId }, { error: `retrieve-failed: ${err instanceof Error ? err.message : String(err)}` });
+            throw err; // Let BullMQ retry
+        }
+        // b. Validate
+        // CSO-Finding-1 (defensive): we look up the local row by vivaTransaction.orderCode
+        // (the value returned by Viva's authenticated retrieveTransaction call) — NOT by
+        // the OrderCode in the webhook envelope, which is attacker-controlled. Do not
+        // regress this to use the envelope OrderCode without adding an explicit
+        // envelope-vs-live cross-check first. See docs/TODO-CSO.md "Finding 1" and the
+        // canonical Viva WooCommerce plugin (class-wc-vivacom-smart-endpoints.php:132).
+        const vivaOrderCodeStr = vivaTransaction.orderCode?.toString();
+        const txnRepo = this.connection.rawConnection.getRepository(VivaTransaction);
+        // Find the viva_transaction row by order code
+        const vivaRow = await txnRepo.findOne({ where: { vivaOrderCode: vivaOrderCodeStr } });
+        if (!vivaRow) {
+            const errMsg = `viva_transaction row not found for orderCode=${vivaOrderCodeStr}`;
+            await eventRepo.update({ messageId }, { error: errMsg });
+            Logger.error(`[webhook:${messageId}] 1796: ${errMsg}`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        if (vivaTransaction.statusId !== 'F') {
+            const errMsg = `statusId is '${vivaTransaction.statusId}', expected 'F'`;
+            await eventRepo.update({ messageId }, { error: errMsg });
+            Logger.warn(`[webhook:${messageId}] 1796: ${errMsg} — not settling.`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        const expectedAmount = BigInt(vivaRow.amountMinor);
+        const actualAmount = vivaTransaction.amount;
+        if (expectedAmount !== actualAmount) {
+            await eventRepo.update({ messageId }, { error: `VIVA_AMOUNT_MISMATCH: expected=${expectedAmount} actual=${actualAmount}` });
+            throw VivaPluginError.amountMismatch(expectedAmount, Number(actualAmount));
+        }
+        // c. Load payment then order via paymentId on the viva_transaction row
+        const paymentId = vivaRow.paymentId;
+        let order = null;
+        try {
+            const payment = await this.paymentService.findOneOrThrow(ctx, paymentId, ['order']);
+            if (payment.order) {
+                order = await this.orderService.findOne(ctx, payment.order.id);
+            }
+        }
+        catch {
+            // Payment not found
+        }
+        if (!order) {
+            const errMsg = `order not found for paymentId=${String(paymentId)}`;
+            await eventRepo.update({ messageId }, { error: errMsg });
+            Logger.error(`[webhook:${messageId}] 1796: ${errMsg}`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        // d. Settle based on current order state
+        try {
+            if (order.state === 'PaymentSettled') {
+                // Idempotent no-op
+                Logger.info(`[webhook:${messageId}] 1796: order already PaymentSettled — idempotent no-op.`, VIVA_LOG_CONTEXT);
+            }
+            else if (order.state === 'AddingItems') {
+                // Stale-order re-walk
+                await this.stateMachine.recoverStaleOrderAndSettle(ctx, order.id, paymentId);
+            }
+            else if (order.state === 'ArrangingPayment' || order.state === 'PaymentAuthorized') {
+                // Normal settle path
+                await this.stateMachine.transitionPaymentToSettled(ctx, order.id, paymentId);
+            }
+            else {
+                Logger.warn(`[webhook:${messageId}] 1796: unexpected order state '${order.state}' — attempting settlePayment anyway.`, VIVA_LOG_CONTEXT);
+                await this.stateMachine.transitionPaymentToSettled(ctx, order.id, paymentId);
+            }
+        }
+        catch (err) {
+            // Fail-loud per Q4: set error, leave processed_at NULL
+            const errMsg = err instanceof Error ? err.message : String(err);
+            await eventRepo.update({ messageId }, { error: errMsg });
+            Logger.error(`[webhook:${messageId}] 1796: transition failed — ${errMsg}`, VIVA_LOG_CONTEXT);
+            throw err;
+        }
+        // e. Update viva_transaction row
+        await txnRepo.update({ id: vivaRow.id }, { status: 'captured', vivaTransactionId: transactionId });
+        // f. Mark processed
+        await this._markProcessed(eventRepo, messageId);
+        Logger.info(`[webhook:${messageId}] 1796: settled successfully.`, VIVA_LOG_CONTEXT);
+    }
+    /**
+     * 1798 — Transaction Failed (declined-non-terminal).
+     *
+     * Mark payment Declined. Leave order in ArrangingPayment (per contract §4).
+     * Do NOT auto-rollback to AddingItems — customer retry on same orderCode may succeed.
+     */
+    async _handle1798(ctx, event, eventRepo) {
+        const { messageId } = event;
+        const txnRepo = this.connection.rawConnection.getRepository(VivaTransaction);
+        // Find viva_transaction by orderCode in payload
+        const payload = event.payload;
+        const eventData = (payload['EventData'] ?? payload);
+        const orderCodeRaw = eventData['OrderCode'];
+        const orderCodeStr = orderCodeRaw?.toString();
+        if (orderCodeStr) {
+            const vivaRow = await txnRepo.findOne({ where: { vivaOrderCode: orderCodeStr } });
+            if (vivaRow) {
+                await txnRepo.update({ id: vivaRow.id }, { status: 'failed' });
+                try {
+                    await this.stateMachine.transitionPaymentToDeclined(ctx, vivaRow.paymentId);
+                }
+                catch (err) {
+                    Logger.warn(`[webhook:${messageId}] 1798: could not transition payment to Declined: ${err instanceof Error ? err.message : String(err)}`, VIVA_LOG_CONTEXT);
+                    // Non-fatal: the row status is already marked failed
+                }
+            }
+        }
+        await this._markProcessed(eventRepo, messageId);
+        Logger.info(`[webhook:${messageId}] 1798: payment marked Declined (order stays ArrangingPayment).`, VIVA_LOG_CONTEXT);
+    }
+    /**
+     * 4865 — Order Updated (optional cancel detection).
+     *
+     * If payload indicates a user-initiated cancel (status suggests cancellation),
+     * invoke the cancel flow: cancelled status + Payment Cancelled + Order → AddingItems.
+     * Otherwise log + no-op.
+     */
+    async _handle4865(ctx, event, eventRepo) {
+        const { messageId } = event;
+        const payload = event.payload;
+        const eventData = (payload['EventData'] ?? payload);
+        // Viva 4865 payload may contain StatusId or OrderStatus indicating cancellation
+        const statusId = eventData['StatusId'];
+        const orderCodeRaw = eventData['OrderCode'];
+        const orderCodeStr = orderCodeRaw?.toString();
+        // Status 'X' or 'F:cancelled' or similar indicates user cancel
+        // TODO(impl): confirm exact statusId for user-cancelled in Viva 4865 payload.
+        // Based on docs, 'X' means cancelled/expired per wh-transaction-payment-created.txt.
+        const isCancelStatus = statusId === 'X' || statusId === 'C' || statusId === 'E';
+        if (isCancelStatus && orderCodeStr) {
+            const txnRepo = this.connection.rawConnection.getRepository(VivaTransaction);
+            const vivaRow = await txnRepo.findOne({ where: { vivaOrderCode: orderCodeStr } });
+            if (vivaRow) {
+                await txnRepo.update({ id: vivaRow.id }, { status: 'cancelled' });
+                try {
+                    await this.stateMachine.transitionPaymentToCancelled(ctx, vivaRow.paymentId);
+                }
+                catch (err) {
+                    Logger.warn(`[webhook:${messageId}] 4865: could not cancel payment: ${err instanceof Error ? err.message : String(err)}`, VIVA_LOG_CONTEXT);
+                }
+                // Transition order back to AddingItems
+                try {
+                    const payment = await this.paymentService.findOneOrThrow(ctx, vivaRow.paymentId, ['order']);
+                    if (payment.order) {
+                        await this.orderService.transitionToState(ctx, payment.order.id, 'AddingItems');
+                    }
+                }
+                catch (err) {
+                    Logger.warn(`[webhook:${messageId}] 4865: could not transition order to AddingItems: ${err instanceof Error ? err.message : String(err)}`, VIVA_LOG_CONTEXT);
+                }
+            }
+        }
+        else {
+            Logger.info(`[webhook:${messageId}] 4865 Order Updated — status=${statusId ?? 'unknown'}, no cancel action needed.`, VIVA_LOG_CONTEXT);
+        }
+        await this._markProcessed(eventRepo, messageId);
+    }
+    /**
+     * 8194 — Account Verification Status Changed (THE gating signal).
+     *
+     * a. Retrieve connected account from Viva to get merchantId.
+     * b. Find channel by vivaAccountId.
+     * c. WRITE ORDER (mandatory per contract §10):
+     *    i.  Write vivaMerchantId FIRST.
+     *    ii. Write vivaPayoutsEnabled=true LAST.
+     */
+    async _handle8194(systemCtx, event, eventRepo) {
+        const { messageId } = event;
+        const accountId = event.accountId;
+        if (!accountId) {
+            await eventRepo.update({ messageId }, { error: 'missing-account-id' });
+            Logger.error(`[webhook:${messageId}] 8194: no accountId in event row.`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        // a. Retrieve connected account from Viva
+        const isvAccounts = this._getIsvAccounts();
+        let merchantId;
+        try {
+            const accountInfo = await isvAccounts.retrieveConnectedAccount(accountId);
+            // Probe-verified 2026-05-11: `merchantId` is the exact field name (null until verified).
+            merchantId = accountInfo.merchantId ?? undefined;
+        }
+        catch (err) {
+            const errMsg = `retrieve-account-failed: ${err instanceof Error ? err.message : String(err)}`;
+            await eventRepo.update({ messageId }, { error: errMsg });
+            throw err; // Let BullMQ retry
+        }
+        if (!merchantId) {
+            await eventRepo.update({ messageId }, { error: 'merchant-id-not-returned' });
+            Logger.warn(`[webhook:${messageId}] 8194: merchantId not in account response — verification may be incomplete.`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        // b. Find channel by vivaAccountId
+        const channel = await this.connectedAccounts.findChannelByAccountId(accountId);
+        if (!channel) {
+            await eventRepo.update({ messageId }, { error: `channel-not-found-for-accountId:${accountId}` });
+            Logger.error(`[webhook:${messageId}] 8194: no channel found for accountId=${accountId}.`, VIVA_LOG_CONTEXT);
+            return;
+        }
+        // c. Write order matters: merchantId FIRST, payoutsEnabled LAST
+        // Build a system ctx with write permissions (superadmin = all channels)
+        const writeCtx = await this.requestContextService.create({ apiType: 'admin' });
+        // i. Write vivaMerchantId FIRST
+        await this.connectedAccounts.writeMerchantId(writeCtx, channel, merchantId);
+        // ii. Write vivaPayoutsEnabled LAST
+        await this.connectedAccounts.flipPayoutsEnabled(writeCtx, channel, true);
+        await this._markProcessed(eventRepo, messageId);
+        Logger.info(`[webhook:${messageId}] 8194: channel ${String(channel.id)} now has merchantId=${merchantId} and payoutsEnabled=true.`, VIVA_LOG_CONTEXT);
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    async _markProcessed(eventRepo, messageId) {
+        await eventRepo.update({ messageId }, { processedAt: new Date(), error: null });
+    }
+    async _loadChannel(channelId) {
+        // Build a system-level ctx to load the channel object
+        const sysCtx = await this.requestContextService.create({ apiType: 'admin' });
+        return this.channelService.findOne(sysCtx, channelId);
+    }
+    _getIsvPayments() {
+        const client = new IsvHttpClient({
+            environment: this.options.environment,
+            authStrategy: this.oauth2,
+        });
+        return new Payments({ mode: this.options.mode, client });
+    }
+    _getIsvAccounts() {
+        const client = new IsvHttpClient({
+            environment: this.options.environment,
+            authStrategy: this.oauth2,
+        });
+        return new IsvAccounts(client);
+    }
+};
+ProcessVivaWebhookHandler = __decorate([
+    Injectable(),
+    __param(9, Inject(VIVA_PLUGIN_OPTIONS)),
+    __param(10, Inject(VIVA_OAUTH2_STRATEGY_TOKEN)),
+    __metadata("design:paramtypes", [JobQueueService,
+        TransactionalConnection,
+        StateMachineService,
+        PerMerchantSemaphore,
+        ConnectedAccountsService,
+        OrderService,
+        PaymentService,
+        ChannelService,
+        RequestContextService, Object, Object])
+], ProcessVivaWebhookHandler);
+export { ProcessVivaWebhookHandler };
+//# sourceMappingURL=process-viva-webhook.handler.js.map

package/dist/jobs/process-viva-webhook.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-viva-webhook.handler.js","sourceRoot":"","sources":["../../src/jobs/process-viva-webhook.handler.ts"],"names":[],"mappings":"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"}

package/dist/jobs/queue-names.d.ts

@@ -0,0 +1,18 @@
+/**
+ * jobs/queue-names.ts — Single source of truth for BullMQ queue + job names.
+ *
+ * Both the webhook controller (V6) and the webhook job handler (V7) import
+ * from here so the strings are never duplicated.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Build Plan — V6"
+ */
+/** BullMQ queue that receives all Viva webhook processing jobs. */
+export declare const VIVA_WEBHOOK_QUEUE = "viva-webhook";
+/** Job that processes a single Viva webhook event (V7 implements the handler). */
+export declare const VIVA_PROCESS_EVENT_JOB = "process-viva-webhook";
+/** Payload for the `process-viva-webhook` job. */
+export interface ProcessVivaWebhookJobData {
+    /** Envelope MessageId (UUID) — foreign key into `viva_webhook_event.message_id`. */
+    messageId: string;
+}
+//# sourceMappingURL=queue-names.d.ts.map

package/dist/jobs/queue-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-names.d.ts","sourceRoot":"","sources":["../../src/jobs/queue-names.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAMjD,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAM7D,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/jobs/queue-names.js

@@ -0,0 +1,19 @@
+/**
+ * jobs/queue-names.ts — Single source of truth for BullMQ queue + job names.
+ *
+ * Both the webhook controller (V6) and the webhook job handler (V7) import
+ * from here so the strings are never duplicated.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Build Plan — V6"
+ */
+// ---------------------------------------------------------------------------
+// Queue names
+// ---------------------------------------------------------------------------
+/** BullMQ queue that receives all Viva webhook processing jobs. */
+export const VIVA_WEBHOOK_QUEUE = 'viva-webhook';
+// ---------------------------------------------------------------------------
+// Job names
+// ---------------------------------------------------------------------------
+/** Job that processes a single Viva webhook event (V7 implements the handler). */
+export const VIVA_PROCESS_EVENT_JOB = 'process-viva-webhook';
+//# sourceMappingURL=queue-names.js.map

package/dist/jobs/queue-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-names.js","sourceRoot":"","sources":["../../src/jobs/queue-names.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,kFAAkF;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC"}

package/dist/jobs/retention-cleanup.handler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * jobs/retention-cleanup.handler.ts — 90-day webhook event retention cleanup.
+ *
+ * Runs once per day via setInterval (lightest-weight option — no new dep).
+ * Deletes `viva_webhook_event` rows where:
+ *   processed_at < now() - INTERVAL '90 days'
+ *
+ * Rows with processed_at = NULL are NOT deleted regardless of age.
+ *
+ * Design note: Vendure's built-in session-cache cleanup uses a similar
+ * setInterval-in-OnApplicationBootstrap pattern (see SessionCacheService).
+ * We follow the same approach rather than introducing a scheduler dep.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Webhook Design — 90-day retention cleanup"
+ */
+import type { OnApplicationBootstrap, OnApplicationShutdown } from '@nestjs/common';
+import { TransactionalConnection } from '@vendure/core';
+export declare class RetentionCleanupHandler implements OnApplicationBootstrap, OnApplicationShutdown {
+    private readonly connection;
+    private _timer;
+    constructor(connection: TransactionalConnection);
+    onApplicationBootstrap(): void;
+    onApplicationShutdown(): void;
+    /**
+     * Delete processed webhook events older than 90 days.
+     * Exposed for direct invocation from tests.
+     */
+    runCleanup(): Promise<number>;
+    private _runCleanup;
+}
+//# sourceMappingURL=retention-cleanup.handler.d.ts.map

package/dist/jobs/retention-cleanup.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-cleanup.handler.d.ts","sourceRoot":"","sources":["../../src/jobs/retention-cleanup.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAU,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAgBhE,qBACa,uBAAwB,YAAW,sBAAsB,EAAE,qBAAqB;IAG/E,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,MAAM,CAA6C;gBAE9B,UAAU,EAAE,uBAAuB;IAEhE,sBAAsB,IAAI,IAAI;IAc9B,qBAAqB,IAAI,IAAI;IAM7B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;YAIrB,WAAW;CAuB1B"}