@sakeetech/vendure-payment-viva 0.2.1

package/dist/entities/viva-transaction.entity.d.ts

@@ -0,0 +1,70 @@
+/**
+ * viva-transaction.entity.ts — TypeORM entity for Viva Wallet payment transactions.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Data Model" lines 132-146
+ *
+ * Design notes:
+ * - Extends VendureEntity for Vendure-compatible `id` / `createdAt` / `updatedAt`.
+ * - `channelId` and `paymentId` use `@EntityId()` — Vendure resolves the column
+ *   type at boot via its EntityIdStrategy (int or uuid depending on config).
+ * - `status` stored as varchar with TS literal union — avoids Postgres enum DDL
+ *   migrations on value additions (matches Medusa convention).
+ * - `amountMinor` and `isvAmountMinor` are bigint columns; TypeORM returns bigint
+ *   as string — typed as `string`, coerce in service layer.
+ * - Partial unique index on `vivaOrderCode WHERE viva_order_code IS NOT NULL` is
+ *   declared here for documentation; the actual WHERE clause requires raw SQL in
+ *   the migration (TypeORM decorator @Index doesn't support WHERE).
+ */
+import { type ID, VendureEntity } from '@vendure/core';
+export type VivaTransactionStatus = 'pending' | 'authorized' | 'captured' | 'refunded' | 'partially_refunded' | 'failed' | 'cancelled';
+/**
+ * Composite unique index on (channel_id, payment_id) — one Viva transaction row
+ * per Vendure payment per channel.
+ */
+export declare class VivaTransaction extends VendureEntity {
+    constructor(input?: Partial<VivaTransaction>);
+    /**
+     * Vendure Channel ID. Column type resolved by EntityIdStrategy at boot.
+     * Typically `int` (AutoIncrementIdStrategy) or `varchar(36)` (UuidIdStrategy).
+     */
+    channelId: ID;
+    /**
+     * Vendure Payment ID. Column type resolved by EntityIdStrategy at boot.
+     */
+    paymentId: ID;
+    /**
+     * Viva-side order code (numeric string). Nullable until `createPayment`
+     * receives the response from `POST /checkout/v2/isv/orders`.
+     */
+    vivaOrderCode: string | null;
+    /**
+     * Viva-side transaction ID. Populated after webhook 1796 + Retrieve-Transaction.
+     */
+    vivaTransactionId: string | null;
+    /**
+     * Payment lifecycle status. Stored as varchar — no Postgres enum DDL.
+     */
+    status: VivaTransactionStatus;
+    /**
+     * Order amount in minor units (e.g. pence for GBP).
+     * TypeORM returns bigint columns as strings — coerce with Number() / BigInt() in
+     * service layer.
+     */
+    amountMinor: string;
+    /**
+     * ISO 4217 currency code stored as 3-char string (e.g. 'GBP').
+     * Viva sends numeric currency codes outbound; we store the alpha code.
+     */
+    currencyCode: string;
+    /**
+     * ISV fee amount in minor units. Default 0. Must be < amountMinor (guarded in
+     * createPayment handler).
+     */
+    isvAmountMinor: string;
+    /**
+     * Free-form metadata bag (redirect URL, idempotency key, Viva error details,
+     * etc). Stored as jsonb.
+     */
+    metadata: Record<string, unknown>;
+}
+//# sourceMappingURL=viva-transaction.entity.d.ts.map

package/dist/entities/viva-transaction.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva-transaction.entity.d.ts","sourceRoot":"","sources":["../../src/entities/viva-transaction.entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAAE,KAAK,EAAE,EAAE,aAAa,EAAY,MAAM,eAAe,CAAC;AAMjE,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,YAAY,GACZ,UAAU,GACV,UAAU,GACV,oBAAoB,GACpB,QAAQ,GACR,WAAW,CAAC;AAMhB;;;GAGG;AACH,qBAQa,eAAgB,SAAQ,aAAa;gBACpC,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAI5C;;;OAGG;IAEH,SAAS,EAAG,EAAE,CAAC;IAEf;;OAEG;IAEH,SAAS,EAAG,EAAE,CAAC;IAEf;;;OAGG;IAEH,aAAa,EAAG,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IAEH,iBAAiB,EAAG,MAAM,GAAG,IAAI,CAAC;IAElC;;OAEG;IAEH,MAAM,EAAG,qBAAqB,CAAC;IAE/B;;;;OAIG;IAEH,WAAW,EAAG,MAAM,CAAC;IAErB;;;OAGG;IAEH,YAAY,EAAG,MAAM,CAAC;IAEtB;;;OAGG;IAEH,cAAc,EAAG,MAAM,CAAC;IAExB;;;OAGG;IAEH,QAAQ,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAGpC"}

package/dist/entities/viva-transaction.entity.js

@@ -0,0 +1,133 @@
+/**
+ * viva-transaction.entity.ts — TypeORM entity for Viva Wallet payment transactions.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Data Model" lines 132-146
+ *
+ * Design notes:
+ * - Extends VendureEntity for Vendure-compatible `id` / `createdAt` / `updatedAt`.
+ * - `channelId` and `paymentId` use `@EntityId()` — Vendure resolves the column
+ *   type at boot via its EntityIdStrategy (int or uuid depending on config).
+ * - `status` stored as varchar with TS literal union — avoids Postgres enum DDL
+ *   migrations on value additions (matches Medusa convention).
+ * - `amountMinor` and `isvAmountMinor` are bigint columns; TypeORM returns bigint
+ *   as string — typed as `string`, coerce in service layer.
+ * - Partial unique index on `vivaOrderCode WHERE viva_order_code IS NOT NULL` is
+ *   declared here for documentation; the actual WHERE clause requires raw SQL in
+ *   the migration (TypeORM decorator @Index doesn't support WHERE).
+ */
+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);
+};
+import { Column, Entity, Index, } from 'typeorm';
+import { VendureEntity, EntityId } from '@vendure/core';
+// ---------------------------------------------------------------------------
+// Entity
+// ---------------------------------------------------------------------------
+/**
+ * Composite unique index on (channel_id, payment_id) — one Viva transaction row
+ * per Vendure payment per channel.
+ */
+let VivaTransaction = class VivaTransaction extends VendureEntity {
+    constructor(input) {
+        super(input);
+    }
+    /**
+     * Vendure Channel ID. Column type resolved by EntityIdStrategy at boot.
+     * Typically `int` (AutoIncrementIdStrategy) or `varchar(36)` (UuidIdStrategy).
+     */
+    channelId;
+    /**
+     * Vendure Payment ID. Column type resolved by EntityIdStrategy at boot.
+     */
+    paymentId;
+    /**
+     * Viva-side order code (numeric string). Nullable until `createPayment`
+     * receives the response from `POST /checkout/v2/isv/orders`.
+     */
+    vivaOrderCode;
+    /**
+     * Viva-side transaction ID. Populated after webhook 1796 + Retrieve-Transaction.
+     */
+    vivaTransactionId;
+    /**
+     * Payment lifecycle status. Stored as varchar — no Postgres enum DDL.
+     */
+    status;
+    /**
+     * Order amount in minor units (e.g. pence for GBP).
+     * TypeORM returns bigint columns as strings — coerce with Number() / BigInt() in
+     * service layer.
+     */
+    amountMinor;
+    /**
+     * ISO 4217 currency code stored as 3-char string (e.g. 'GBP').
+     * Viva sends numeric currency codes outbound; we store the alpha code.
+     */
+    currencyCode;
+    /**
+     * ISV fee amount in minor units. Default 0. Must be < amountMinor (guarded in
+     * createPayment handler).
+     */
+    isvAmountMinor;
+    /**
+     * Free-form metadata bag (redirect URL, idempotency key, Viva error details,
+     * etc). Stored as jsonb.
+     */
+    metadata;
+};
+__decorate([
+    EntityId(),
+    __metadata("design:type", Object)
+], VivaTransaction.prototype, "channelId", void 0);
+__decorate([
+    EntityId(),
+    __metadata("design:type", Object)
+], VivaTransaction.prototype, "paymentId", void 0);
+__decorate([
+    Column({ type: 'varchar', nullable: true, name: 'viva_order_code' }),
+    __metadata("design:type", Object)
+], VivaTransaction.prototype, "vivaOrderCode", void 0);
+__decorate([
+    Column({ type: 'varchar', nullable: true, name: 'viva_transaction_id' }),
+    __metadata("design:type", Object)
+], VivaTransaction.prototype, "vivaTransactionId", void 0);
+__decorate([
+    Column({ type: 'varchar', name: 'status' }),
+    __metadata("design:type", String)
+], VivaTransaction.prototype, "status", void 0);
+__decorate([
+    Column({ type: 'bigint', name: 'amount_minor' }),
+    __metadata("design:type", String)
+], VivaTransaction.prototype, "amountMinor", void 0);
+__decorate([
+    Column({ type: 'varchar', length: 3, name: 'currency_code' }),
+    __metadata("design:type", String)
+], VivaTransaction.prototype, "currencyCode", void 0);
+__decorate([
+    Column({ type: 'bigint', default: '0', name: 'isv_amount_minor' }),
+    __metadata("design:type", String)
+], VivaTransaction.prototype, "isvAmountMinor", void 0);
+__decorate([
+    Column({ type: 'jsonb', default: '{}', name: 'metadata' }),
+    __metadata("design:type", Object)
+], VivaTransaction.prototype, "metadata", void 0);
+VivaTransaction = __decorate([
+    Index('idx_viva_transaction_channel_payment', ['channelId', 'paymentId'], { unique: true })
+    /**
+     * Partial unique on viva_order_code WHERE viva_order_code IS NOT NULL.
+     * TypeORM decorator doesn't support WHERE; index created in raw SQL in migration.
+     * Declared here for discoverability; has no runtime effect on index creation.
+     */
+    ,
+    Index('idx_viva_transaction_order_code', ['vivaOrderCode'], { unique: true }),
+    Entity('viva_transaction'),
+    __metadata("design:paramtypes", [Object])
+], VivaTransaction);
+export { VivaTransaction };
+//# sourceMappingURL=viva-transaction.entity.js.map

package/dist/entities/viva-transaction.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva-transaction.entity.js","sourceRoot":"","sources":["../../src/entities/viva-transaction.entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;AAEH,OAAO,EACL,MAAM,EACN,MAAM,EACN,KAAK,GACN,MAAM,SAAS,CAAC;AACjB,OAAO,EAAW,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAejE,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AASI,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,aAAa;IAChD,YAAY,KAAgC;QAC1C,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAED;;;OAGG;IAEH,SAAS,CAAM;IAEf;;OAEG;IAEH,SAAS,CAAM;IAEf;;;OAGG;IAEH,aAAa,CAAiB;IAE9B;;OAEG;IAEH,iBAAiB,CAAiB;IAElC;;OAEG;IAEH,MAAM,CAAyB;IAE/B;;;;OAIG;IAEH,WAAW,CAAU;IAErB;;;OAGG;IAEH,YAAY,CAAU;IAEtB;;;OAGG;IAEH,cAAc,CAAU;IAExB;;;OAGG;IAEH,QAAQ,CAA2B;CAGpC,CAAA;AAzDC;IADC,QAAQ,EAAE;;kDACI;AAMf;IADC,QAAQ,EAAE;;kDACI;AAOf;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;;sDACvC;AAM9B;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;;0DACvC;AAMlC;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;+CACb;AAQ/B;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;;oDAC5B;AAOrB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;;qDACxC;AAOtB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;;uDAC3C;AAOxB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;;iDACxB;AAhExB,eAAe;IAR3B,KAAK,CAAC,sCAAsC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC5F;;;;OAIG;;IACF,KAAK,CAAC,iCAAiC,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7E,MAAM,CAAC,kBAAkB,CAAC;;GACd,eAAe,CAmE3B"}

package/dist/entities/viva-webhook-event.entity.d.ts

@@ -0,0 +1,71 @@
+/**
+ * viva-webhook-event.entity.ts — TypeORM entity for incoming Viva Wallet webhook events.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Data Model" lines 148-161
+ *
+ * Design notes:
+ * - `messageId` is the primary key (envelope UUID). NOT auto-generated — Viva
+ *   supplies it; we use it as the dedupe key (INSERT-OR-IGNORE on conflict).
+ * - Does NOT extend VendureEntity — Vendure's base entity adds a generated
+ *   auto-increment/uuid `id` which conflicts with our natural PK design. We use
+ *   plain TypeORM `@PrimaryColumn` instead.
+ * - Partial index on `(received_at) WHERE processed_at IS NULL` is declared as a
+ *   standard @Index here for documentation; the WHERE clause requires raw SQL in
+ *   the migration.
+ * - Composite non-unique index on `(merchant_id, event_type_id)` supports
+ *   efficient A6 NULL-merchant re-walk queries.
+ */
+/** Non-unique composite index for merchant-scoped event type queries. */
+export declare class VivaWebhookEvent {
+    constructor(input?: Partial<VivaWebhookEvent>);
+    /**
+     * Envelope MessageId from Viva. UUIDv4. Natural primary key + dedupe key.
+     * INSERT-OR-IGNORE on conflict prevents double-processing.
+     */
+    messageId: string;
+    /**
+     * Viva event type code (1796, 1797, 1798, 4865, 8193, 8194, …).
+     */
+    eventTypeId: number;
+    /**
+     * Viva merchantId UUID from EventData.MerchantId. Nullable — absent for some
+     * event types and set to NULL on A6 unresolvable-channel fallback.
+     */
+    merchantId: string | null;
+    /**
+     * Viva TransactionId from EventData.TransactionId. Applicable to payment events.
+     */
+    transactionId: string | null;
+    /**
+     * Viva AccountId from EventData.AccountId. Applicable to onboarding events
+     * (8193, 8194).
+     */
+    accountId: string | null;
+    /**
+     * Correlation ID for distributed tracing (if present in event envelope).
+     */
+    correlationId: string | null;
+    /**
+     * Number of processing attempts. Incremented on each BullMQ retry.
+     */
+    retryCount: number;
+    /**
+     * Raw event payload. Stored as jsonb for querying EventData fields without
+     * schema migration.
+     */
+    payload: Record<string, unknown>;
+    /**
+     * Wall-clock time the POST /viva/webhook request was received.
+     * Partial index on this column WHERE processed_at IS NULL — see migration.
+     */
+    receivedAt: Date;
+    /**
+     * Set when the BullMQ job completes successfully. NULL = pending/failed.
+     */
+    processedAt: Date | null;
+    /**
+     * Last processing failure reason. Populated on job error; cleared on success.
+     */
+    error: string | null;
+}
+//# sourceMappingURL=viva-webhook-event.entity.d.ts.map

package/dist/entities/viva-webhook-event.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva-webhook-event.entity.d.ts","sourceRoot":"","sources":["../../src/entities/viva-webhook-event.entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,yEAAyE;AACzE,qBAEa,gBAAgB;gBACf,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAM7C;;;OAGG;IAEH,SAAS,EAAG,MAAM,CAAC;IAEnB;;OAEG;IAEH,WAAW,EAAG,MAAM,CAAC;IAErB;;;OAGG;IAEH,UAAU,EAAG,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IAEH,aAAa,EAAG,MAAM,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IAEH,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IAEH,aAAa,EAAG,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IAEH,UAAU,EAAG,MAAM,CAAC;IAEpB;;;OAGG;IAEH,OAAO,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;;OAGG;IAEH,UAAU,EAAG,IAAI,CAAC;IAElB;;OAEG;IAEH,WAAW,EAAG,IAAI,GAAG,IAAI,CAAC;IAE1B;;OAEG;IAEH,KAAK,EAAG,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/dist/entities/viva-webhook-event.entity.js

@@ -0,0 +1,138 @@
+/**
+ * viva-webhook-event.entity.ts — TypeORM entity for incoming Viva Wallet webhook events.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Data Model" lines 148-161
+ *
+ * Design notes:
+ * - `messageId` is the primary key (envelope UUID). NOT auto-generated — Viva
+ *   supplies it; we use it as the dedupe key (INSERT-OR-IGNORE on conflict).
+ * - Does NOT extend VendureEntity — Vendure's base entity adds a generated
+ *   auto-increment/uuid `id` which conflicts with our natural PK design. We use
+ *   plain TypeORM `@PrimaryColumn` instead.
+ * - Partial index on `(received_at) WHERE processed_at IS NULL` is declared as a
+ *   standard @Index here for documentation; the WHERE clause requires raw SQL in
+ *   the migration.
+ * - Composite non-unique index on `(merchant_id, event_type_id)` supports
+ *   efficient A6 NULL-merchant re-walk queries.
+ */
+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);
+};
+import { Column, CreateDateColumn, Entity, Index, PrimaryColumn, } from 'typeorm';
+// ---------------------------------------------------------------------------
+// Entity
+// ---------------------------------------------------------------------------
+/** Non-unique composite index for merchant-scoped event type queries. */
+let VivaWebhookEvent = class VivaWebhookEvent {
+    constructor(input) {
+        if (input) {
+            Object.assign(this, input);
+        }
+    }
+    /**
+     * Envelope MessageId from Viva. UUIDv4. Natural primary key + dedupe key.
+     * INSERT-OR-IGNORE on conflict prevents double-processing.
+     */
+    messageId;
+    /**
+     * Viva event type code (1796, 1797, 1798, 4865, 8193, 8194, …).
+     */
+    eventTypeId;
+    /**
+     * Viva merchantId UUID from EventData.MerchantId. Nullable — absent for some
+     * event types and set to NULL on A6 unresolvable-channel fallback.
+     */
+    merchantId;
+    /**
+     * Viva TransactionId from EventData.TransactionId. Applicable to payment events.
+     */
+    transactionId;
+    /**
+     * Viva AccountId from EventData.AccountId. Applicable to onboarding events
+     * (8193, 8194).
+     */
+    accountId;
+    /**
+     * Correlation ID for distributed tracing (if present in event envelope).
+     */
+    correlationId;
+    /**
+     * Number of processing attempts. Incremented on each BullMQ retry.
+     */
+    retryCount;
+    /**
+     * Raw event payload. Stored as jsonb for querying EventData fields without
+     * schema migration.
+     */
+    payload;
+    /**
+     * Wall-clock time the POST /viva/webhook request was received.
+     * Partial index on this column WHERE processed_at IS NULL — see migration.
+     */
+    receivedAt;
+    /**
+     * Set when the BullMQ job completes successfully. NULL = pending/failed.
+     */
+    processedAt;
+    /**
+     * Last processing failure reason. Populated on job error; cleared on success.
+     */
+    error;
+};
+__decorate([
+    PrimaryColumn({ type: 'uuid', name: 'message_id' }),
+    __metadata("design:type", String)
+], VivaWebhookEvent.prototype, "messageId", void 0);
+__decorate([
+    Column({ type: 'int', name: 'event_type_id' }),
+    __metadata("design:type", Number)
+], VivaWebhookEvent.prototype, "eventTypeId", void 0);
+__decorate([
+    Column({ type: 'uuid', nullable: true, name: 'merchant_id' }),
+    __metadata("design:type", Object)
+], VivaWebhookEvent.prototype, "merchantId", void 0);
+__decorate([
+    Column({ type: 'varchar', nullable: true, name: 'transaction_id' }),
+    __metadata("design:type", Object)
+], VivaWebhookEvent.prototype, "transactionId", void 0);
+__decorate([
+    Column({ type: 'varchar', nullable: true, name: 'account_id' }),
+    __metadata("design:type", Object)
+], VivaWebhookEvent.prototype, "accountId", void 0);
+__decorate([
+    Column({ type: 'varchar', nullable: true, name: 'correlation_id' }),
+    __metadata("design:type", Object)
+], VivaWebhookEvent.prototype, "correlationId", void 0);
+__decorate([
+    Column({ type: 'int', default: 0, name: 'retry_count' }),
+    __metadata("design:type", Number)
+], VivaWebhookEvent.prototype, "retryCount", void 0);
+__decorate([
+    Column({ type: 'jsonb', name: 'payload' }),
+    __metadata("design:type", Object)
+], VivaWebhookEvent.prototype, "payload", void 0);
+__decorate([
+    CreateDateColumn({ name: 'received_at', type: 'timestamp with time zone' }),
+    __metadata("design:type", Date)
+], VivaWebhookEvent.prototype, "receivedAt", void 0);
+__decorate([
+    Column({ type: 'timestamp with time zone', nullable: true, name: 'processed_at' }),
+    __metadata("design:type", Object)
+], VivaWebhookEvent.prototype, "processedAt", void 0);
+__decorate([
+    Column({ type: 'text', nullable: true, name: 'error' }),
+    __metadata("design:type", Object)
+], VivaWebhookEvent.prototype, "error", void 0);
+VivaWebhookEvent = __decorate([
+    Index('idx_viva_webhook_event_merchant_type', ['merchantId', 'eventTypeId']),
+    Entity('viva_webhook_event'),
+    __metadata("design:paramtypes", [Object])
+], VivaWebhookEvent);
+export { VivaWebhookEvent };
+//# sourceMappingURL=viva-webhook-event.entity.js.map

package/dist/entities/viva-webhook-event.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viva-webhook-event.entity.js","sourceRoot":"","sources":["../../src/entities/viva-webhook-event.entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;AAEH,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,MAAM,EACN,KAAK,EACL,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,yEAAyE;AAGlE,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YAAY,KAAiC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;OAGG;IAEH,SAAS,CAAU;IAEnB;;OAEG;IAEH,WAAW,CAAU;IAErB;;;OAGG;IAEH,UAAU,CAAiB;IAE3B;;OAEG;IAEH,aAAa,CAAiB;IAE9B;;;OAGG;IAEH,SAAS,CAAiB;IAE1B;;OAEG;IAEH,aAAa,CAAiB;IAE9B;;OAEG;IAEH,UAAU,CAAU;IAEpB;;;OAGG;IAEH,OAAO,CAA2B;IAElC;;;OAGG;IAEH,UAAU,CAAQ;IAElB;;OAEG;IAEH,WAAW,CAAe;IAE1B;;OAEG;IAEH,KAAK,CAAiB;CACvB,CAAA;AAjEC;IADC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;;mDACjC;AAMnB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;;qDAC1B;AAOrB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;;oDACnC;AAM3B;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;;uDACtC;AAO9B;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;;mDACtC;AAM1B;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;;uDACtC;AAM9B;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;;oDACrC;AAOpB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;iDACT;AAOlC;IADC,gBAAgB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;8BAC/D,IAAI;oDAAC;AAMlB;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;;qDACzD;AAM1B;IADC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;;+CAClC;AA5EX,gBAAgB;IAF5B,KAAK,CAAC,sCAAsC,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC5E,MAAM,CAAC,oBAAoB,CAAC;;GAChB,gBAAgB,CA6E5B"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @sakeetech/vendure-payment-viva
+ *
+ * Vendure plugin for Viva Wallet (ISV multi-tenant).
+ *
+ * v0 skeleton — implementation begins in V3 (entities + migrations)
+ * through V11 (README + sandbox tests) per docs/plans/vendure-plugin-v0.md.
+ *
+ * @see docs/plans/vendure-plugin-v0.md
+ */
+export { VivaPaymentPlugin } from './plugin.js';
+export { VIVA_PLUGIN_OPTIONS, VIVA_PLUGIN_NAME, DEFAULT_SOURCE_CODE, DEFAULT_ISV_AMOUNT, } from './constants.js';
+export type { VivaPaymentPluginOptions, VendureRequestContext, VendureOrder, RedlockClient, } from './types.js';
+export { VivaTransaction, VivaWebhookEvent } from './entities/index.js';
+export type { VivaTransactionStatus } from './entities/index.js';
+export { VivaOAuth2StrategyProvider, InjectVivaOAuth2Strategy, VIVA_OAUTH2_STRATEGY_TOKEN } from './providers/viva-oauth2-strategy.provider.js';
+export type { VivaOAuth2Strategy } from './providers/viva-oauth2-strategy.provider.js';
+export { VivaBootstrap } from './loaders/bootstrap.js';
+export { vivaPaymentMethodHandler } from './payment-method-handler.js';
+export { StateMachineService } from './services/state-machine.service.js';
+export { VivaPluginError } from './util/error-envelope.js';
+export type { VivaErrorCode } from './util/error-envelope.js';
+export { alphaToNumeric, numericToAlpha, coerceCurrencyCode } from './util/currency.js';
+export { substitute } from './util/url-template.js';
+export { MetricsStateService, ISV_API_DURATION_BUCKETS } from './observability/metrics-state.service.js';
+export { AdminInternalController } from './api/admin-internal.controller.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAChJ,YAAY,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzG,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @sakeetech/vendure-payment-viva
+ *
+ * Vendure plugin for Viva Wallet (ISV multi-tenant).
+ *
+ * v0 skeleton — implementation begins in V3 (entities + migrations)
+ * through V11 (README + sandbox tests) per docs/plans/vendure-plugin-v0.md.
+ *
+ * @see docs/plans/vendure-plugin-v0.md
+ */
+export { VivaPaymentPlugin } from './plugin.js';
+export { VIVA_PLUGIN_OPTIONS, VIVA_PLUGIN_NAME, DEFAULT_SOURCE_CODE, DEFAULT_ISV_AMOUNT, } from './constants.js';
+export { VivaTransaction, VivaWebhookEvent } from './entities/index.js';
+export { VivaOAuth2StrategyProvider, InjectVivaOAuth2Strategy, VIVA_OAUTH2_STRATEGY_TOKEN } from './providers/viva-oauth2-strategy.provider.js';
+export { VivaBootstrap } from './loaders/bootstrap.js';
+export { vivaPaymentMethodHandler } from './payment-method-handler.js';
+export { StateMachineService } from './services/state-machine.service.js';
+export { VivaPluginError } from './util/error-envelope.js';
+export { alphaToNumeric, numericToAlpha, coerceCurrencyCode } from './util/currency.js';
+export { substitute } from './util/url-template.js';
+export { MetricsStateService, ISV_API_DURATION_BUCKETS } from './observability/metrics-state.service.js';
+export { AdminInternalController } from './api/admin-internal.controller.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAEhJ,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzG,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/jobs/process-viva-webhook.handler.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 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
+ */
+import type { OnApplicationBootstrap } from '@nestjs/common';
+import { JobQueueService, TransactionalConnection, RequestContextService, OrderService, ChannelService, PaymentService } from '@vendure/core';
+import type { VivaPaymentPluginOptions } from '../types.js';
+import type { VivaOAuth2Strategy } 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 type { ProcessVivaWebhookJobData } from './queue-names.js';
+export declare class ProcessVivaWebhookHandler implements OnApplicationBootstrap {
+    private readonly jobQueueService;
+    private readonly connection;
+    private readonly stateMachine;
+    private readonly semaphore;
+    private readonly connectedAccounts;
+    private readonly orderService;
+    private readonly paymentService;
+    private readonly channelService;
+    private readonly requestContextService;
+    private readonly options;
+    private readonly oauth2;
+    private queue;
+    constructor(jobQueueService: JobQueueService, connection: TransactionalConnection, stateMachine: StateMachineService, semaphore: PerMerchantSemaphore, connectedAccounts: ConnectedAccountsService, orderService: OrderService, paymentService: PaymentService, channelService: ChannelService, requestContextService: RequestContextService, options: VivaPaymentPluginOptions, oauth2: VivaOAuth2Strategy);
+    onApplicationBootstrap(): Promise<void>;
+    /**
+     * Enqueue a new webhook processing job.
+     * Called by the webhook controller (V6) after INSERT-OR-NOTHING succeeds.
+     */
+    enqueue(data: ProcessVivaWebhookJobData, delayMs?: number): Promise<void>;
+    private _processJob;
+    /**
+     * 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.
+     */
+    private _handle1796;
+    /**
+     * 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.
+     */
+    private _handle1798;
+    /**
+     * 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.
+     */
+    private _handle4865;
+    /**
+     * 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.
+     */
+    private _handle8194;
+    private _markProcessed;
+    private _loadChannel;
+    private _getIsvPayments;
+    private _getIsvAccounts;
+}
+//# sourceMappingURL=process-viva-webhook.handler.d.ts.map

package/dist/jobs/process-viva-webhook.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-viva-webhook.handler.d.ts","sourceRoot":"","sources":["../../src/jobs/process-viva-webhook.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,eAAe,EAGf,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,eAAe,CAAC;AAIvB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAWrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AA2ClE,qBACa,yBAA0B,YAAW,sBAAsB;IAIpE,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAb7D,OAAO,CAAC,KAAK,CAAuC;gBAGjC,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,uBAAuB,EACnC,YAAY,EAAE,mBAAmB,EACjC,SAAS,EAAE,oBAAoB,EAC/B,iBAAiB,EAAE,wBAAwB,EAC3C,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,cAAc,EAC9B,qBAAqB,EAAE,qBAAqB,EACf,OAAO,EAAE,wBAAwB,EAC1B,MAAM,EAAE,kBAAkB;IAG3E,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7C;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ5D,WAAW;IAkKzB;;;;;;;;;OASG;YACW,WAAW;IAyHzB;;;;;OAKG;YACW,WAAW;IA+BzB;;;;;;OAMG;YACW,WAAW;IA+CzB;;;;;;;;OAQG;YACW,WAAW;YA8DX,cAAc;YAOd,YAAY;IAM1B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;CAOxB"}