cabloy 5.1.124 → 5.1.126

package/vona/src/suite/a-commerce/modules/commerce-trade/src/dto/orderSummary.tsx

@@ -1,47 +1,14 @@
-import type { TableIdentity } from 'table-identity';
 import type { IDecoratorDtoOptions } from 'vona-module-a-web';
 
-import { Api, v } from 'vona-module-a-openapiutils';
+import { $Dto } from 'vona-module-a-orm';
 import { Dto } from 'vona-module-a-web';
-import { z } from 'zod';
+
+import { orderSummaryColumns } from '../lib/order.ts';
+import { ModelOrder } from '../model/order.ts';
 
 export interface IDtoOptionsOrderSummary extends IDecoratorDtoOptions {}
 
 @Dto<IDtoOptionsOrderSummary>()
-export class DtoOrderSummary {
-  @Api.field(v.tableIdentity())
-  id: TableIdentity;
-
-  @Api.field(
-    z.enum([
-      'awaiting_payment',
-      'paid',
-      'refund_requested',
-      'refund_approved',
-      'refund_rejected',
-      'shipped',
-      'refunded',
-      'cancelled',
-      'expired',
-    ]),
-  )
-  state:
-    | 'awaiting_payment'
-    | 'paid'
-    | 'refund_requested'
-    | 'refund_approved'
-    | 'refund_rejected'
-    | 'shipped'
-    | 'refunded'
-    | 'cancelled'
-    | 'expired';
-
-  @Api.field(z.literal('USD'))
-  currency: 'USD';
-
-  @Api.field(z.number().int().nonnegative())
-  payableTotalCents: number;
-
-  @Api.field(v.required())
-  createdAt: Date;
-}
+export class DtoOrderSummary extends $Dto.get(() => ModelOrder, {
+  columns: orderSummaryColumns,
+}) {}

package/vona/src/suite/a-commerce/modules/commerce-trade/src/dto/shipmentView.tsx

@@ -1,22 +1,13 @@
-import type { TableIdentity } from 'table-identity';
 import type { IDecoratorDtoOptions } from 'vona-module-a-web';
 
-import { Api, v } from 'vona-module-a-openapiutils';
+import { $Dto } from 'vona-module-a-orm';
 import { Dto } from 'vona-module-a-web';
 
+import { ModelShipment } from '../model/shipment.ts';
+
 export interface IDtoOptionsShipmentView extends IDecoratorDtoOptions {}
 
 @Dto<IDtoOptionsShipmentView>()
-export class DtoShipmentView {
-  @Api.field(v.tableIdentity())
-  id: TableIdentity;
-
-  @Api.field(v.required())
-  carrier: string;
-
-  @Api.field(v.required())
-  trackingNumber: string;
-
-  @Api.field(v.required())
-  shippedAt: Date;
-}
+export class DtoShipmentView extends $Dto.get(() => ModelShipment, {
+  columns: ['id', 'carrier', 'trackingNumber', 'shippedAt'],
+}) {}

package/vona/src/suite/a-commerce/modules/commerce-trade/src/lib/order.ts

@@ -0,0 +1,9 @@
+import type { EntityOrder } from '../entity/order.tsx';
+
+export const orderSummaryColumns = [
+  'id',
+  'state',
+  'currency',
+  'payableTotalCents',
+  'createdAt',
+] satisfies Array<keyof EntityOrder>;

package/vona/src/suite/a-commerce/modules/commerce-trade/src/service/order.ts

@@ -1,6 +1,6 @@
 import type { TableIdentity } from 'table-identity';
 import type { IQueryParams } from 'vona-module-a-orm';
-import type { IPaymentOutcomeEvent } from 'vona-module-a-pay';
+import type { IPaymentOutcomeEvent, IRefundOutcomeEvent } from 'vona-module-a-pay';
 import type { EntityPaymentAttempt } from 'vona-module-commerce-payment';
 import type {
   EntityRefundAttempt,
@@ -21,7 +21,6 @@ import type { DtoOrderLineSkuAttributeSnapshot } from '../dto/orderLineSkuAttrib
 import type { DtoOrderMineRes } from '../dto/orderMineRes.tsx';
 import type { DtoOrderSelectRes } from '../dto/orderSelectRes.tsx';
 import type { DtoOrderShip } from '../dto/orderShip.tsx';
-import type { DtoOrderSummary } from '../dto/orderSummary.tsx';
 import type { DtoOrderView } from '../dto/orderView.tsx';
 import type { DtoPaymentOutcomeCreate } from '../dto/paymentOutcomeCreate.tsx';
 import type { DtoPaymentOutcomeResult } from '../dto/paymentOutcomeResult.tsx';
@@ -35,6 +34,8 @@ import type { EntityOrderLine } from '../entity/orderLine.tsx';
 import type { EntityShipment } from '../entity/shipment.tsx';
 import type { ModelOrder } from '../model/order.ts';
 
+import { orderSummaryColumns } from '../lib/order.ts';
+
 const maxOrderCents = 2_147_483_647;
 const customerVisibleOrderStates: EntityOrder['state'][] = [
   'awaiting_payment',
@@ -421,6 +422,87 @@ export class ServiceOrder extends BeanBase {
     return this._paymentOutcomeResult({ ...order, state: orderState }, finalizedAttempt);
   }
 
+  @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
+  @Core.retryable(serializationRetryOptions)
+  async settleRefundFromProvider(event: IRefundOutcomeEvent): Promise<DtoRefundResult> {
+    const refundAttempt = await this.$scope.commercePayment.model.refundAttempt.get({
+      refundOperationId: event.refundOperationId,
+    });
+    if (!refundAttempt || String(refundAttempt.id) !== event.businessReference) {
+      this.app.throw(404, 'commerce refund attempt not found');
+    }
+    const order = await this.scope.model.order.getByIdForUpdate(refundAttempt.orderId);
+    if (!order) this.app.throw(404, 'order not found');
+    const request = await this.$scope.commercePayment.model.refundRequest.getByIdForUpdate(
+      refundAttempt.refundRequestId,
+    );
+    const lockedAttempt = await this.$scope.commercePayment.model.refundAttempt.getByIdForUpdate(
+      refundAttempt.id,
+    );
+    if (!request || !lockedAttempt) this.app.throw(404, 'commerce refund request not found');
+    if (
+      lockedAttempt.amountCents !== event.amountMinor ||
+      lockedAttempt.currency !== event.currency ||
+      String(lockedAttempt.refundOperationId) !== String(event.refundOperationId)
+    ) {
+      this.app.throw(409, 'provider event conflicts with the commerce refund attempt');
+    }
+    const existingAudit = await this.$scope.commercePayment.model.refundAudit.get({
+      refundAttemptId: lockedAttempt.id,
+      idempotencyKey: event.eventId.slice(0, 100),
+    });
+    if (existingAudit) return this._refundResult(order, request, lockedAttempt);
+    if (
+      order.state !== 'refund_approved' ||
+      request.state !== 'approved' ||
+      lockedAttempt.state !== 'created'
+    ) {
+      this.app.throw(409, 'refund attempt is no longer available');
+    }
+
+    const now = new Date();
+    const isSucceeded = event.state === 'succeeded';
+    const attemptState = isSucceeded ? 'succeeded' : 'failed';
+    const refundState = isSucceeded ? 'refunded' : 'failed';
+    const orderState = isSucceeded ? 'refunded' : 'paid';
+    const correlationId = `${order.correlationId}:provider-refund:${event.eventId}`;
+    const reason = `provider refund ${event.state}`;
+    await this.$scope.commercePayment.model.refundAttempt.updateById(lockedAttempt.id, {
+      state: attemptState,
+      providerRefundId: event.providerRefundId,
+      finalizedAt: now,
+    });
+    await this.$scope.commercePayment.model.refundRequest.updateById(request.id, {
+      state: refundState,
+      finalizedAt: now,
+    });
+    await this.scope.model.order.updateById(order.id, { state: orderState });
+    if (isSucceeded) await this._restoreConsumedOrderStock(order, reason);
+    await this._appendAudit({
+      orderId: order.id,
+      operation: isSucceeded ? 'refunded' : 'refund_failed',
+      fromState: 'refund_approved',
+      toState: orderState,
+      correlationId,
+      reason,
+    });
+    await this._appendRefundAudit({
+      refundRequest: request,
+      refundAttempt: lockedAttempt,
+      order,
+      toRefundState: refundState,
+      attemptState,
+      idempotencyKey: event.eventId.slice(0, 100),
+      correlationId,
+      reason,
+    });
+    return this._refundResult(
+      { ...order, state: orderState },
+      { ...request, state: refundState },
+      { ...lockedAttempt, state: attemptState },
+    );
+  }
+
   @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
   @Core.retryable(serializationRetryOptions)
   async applyPaymentOutcome(
@@ -636,6 +718,41 @@ export class ServiceOrder extends BeanBase {
     return await this._reviewRefund(orderId, command, decision, onStage);
   }
 
+  async executeRefund(orderId: TableIdentity): Promise<DtoRefundResult> {
+    const prepared = await this._prepareRefundExecution(orderId);
+    await this.$scope.commercePayment.service.commercePayScene.createRefundOperation(prepared.id);
+    const linked = await this.$scope.commercePayment.model.refundAttempt.getById(prepared.id);
+    if (!linked?.refundOperationId) this.app.throw(500, 'commerce refund operation was not linked');
+    await this.$scope.pay.service.refundOperation.submit(linked.refundOperationId);
+    const order = await this.scope.model.order.getById(orderId);
+    const request = await this.$scope.commercePayment.model.refundRequest.getById(
+      prepared.refundRequestId,
+    );
+    const attempt = await this.$scope.commercePayment.model.refundAttempt.getById(prepared.id);
+    if (!order || !request || !attempt) this.app.throw(404, 'commerce refund attempt not found');
+    return this._refundResult(order, request, attempt);
+  }
+
+  @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
+  @Core.retryable(serializationRetryOptions)
+  private async _prepareRefundExecution(orderId: TableIdentity) {
+    const order = await this.scope.model.order.getByIdForUpdate(orderId);
+    if (!order) this.app.throw(404, 'order not found');
+    const request = await this.$scope.commercePayment.model.refundRequest.getForUpdate({
+      orderId: order.id,
+      state: 'approved',
+    });
+    if (!request) this.app.throw(404, 'approved refund request not found');
+    const attempt = await this.$scope.commercePayment.model.refundAttempt.getForUpdate({
+      refundRequestId: request.id,
+    });
+    if (!attempt) this.app.throw(404, 'refund attempt not found');
+    if (order.state !== 'refund_approved' || attempt.state !== 'created') {
+      this.app.throw(409, 'refund is not available for execution');
+    }
+    return attempt;
+  }
+
   @Core.transaction({ isolationLevel: 'SERIALIZABLE' })
   @Core.retryable(serializationRetryOptions)
   async applyRefundOutcome(
@@ -825,9 +942,9 @@ export class ServiceOrder extends BeanBase {
   }
 
   async mine(params?: IQueryParams<ModelOrder>): Promise<DtoOrderMineRes> {
-    const result = await this.scope.model.order.selectAndCount({
+    return await this.scope.model.order.selectAndCount({
       ...params,
-      columns: ['id', 'state', 'currency', 'payableTotalCents', 'createdAt'],
+      columns: orderSummaryColumns,
       where: {
         ...params?.where,
         userId: this.bean.passport.currentUser!.id,
@@ -835,13 +952,6 @@ export class ServiceOrder extends BeanBase {
       },
       orders: params?.orders ?? [['id', 'desc']],
     });
-    return {
-      ...result,
-      list: result.list.map(order => ({
-        ...order,
-        state: order.state as DtoOrderSummary['state'],
-      })),
-    };
   }
 
   async viewMine(id: TableIdentity): Promise<DtoOrderDetail | undefined> {

package/vona/src/suite/a-commerce/modules/commerce-trade/test/order.test.ts

@@ -1,8 +1,33 @@
 import assert from 'node:assert';
 import { describe, it } from 'node:test';
 import { app } from 'vona-mock';
+import { DtoOrderSummary, DtoShipmentView } from 'vona-module-commerce-trade';
 
 describe('order.test.ts', () => {
+  it('action:order:emittedDtoSchemas', async () => {
+    await app.bean.executor.mockCtx(async () => {
+      const summaryJson = await app.bean.openapi.generateJsonOfClass(DtoOrderSummary);
+      const summaryComponent = Object.values(summaryJson.components!.schemas as any).find(item => {
+        return (item as any).properties?.payableTotalCents && (item as any).properties?.createdAt;
+      }) as any;
+      assert.deepEqual(
+        Object.keys(summaryComponent.properties).sort(),
+        ['id', 'state', 'currency', 'payableTotalCents', 'createdAt'].sort(),
+      );
+
+      const shipmentJson = await app.bean.openapi.generateJsonOfClass(DtoShipmentView);
+      const shipmentComponent = Object.values(shipmentJson.components!.schemas as any).find(
+        item => {
+          return (item as any).properties?.carrier && (item as any).properties?.trackingNumber;
+        },
+      ) as any;
+      assert.deepEqual(
+        Object.keys(shipmentComponent.properties).sort(),
+        ['id', 'carrier', 'trackingNumber', 'shippedAt'].sort(),
+      );
+    });
+  });
+
   it('action:order permits system-admin read and shipment actions only', async () => {
     await app.bean.executor.mockCtx(async () => {
       await app.bean.passport.signinMock();

package/vona/src/suite/a-commerce/modules/commerce-trade/test/paymentOutcome.test.ts

@@ -1,7 +1,7 @@
 import assert from 'node:assert';
 import { createHmac, randomUUID } from 'node:crypto';
-import { describe, it } from 'node:test';
-import { app } from 'vona-mock';
+import { after, before, describe, it } from 'node:test';
+import { acquireTestLock, app } from 'vona-mock';
 
 interface IFixture {
   categoryId?: number;
@@ -166,6 +166,23 @@ async function createCheckoutFixture(suffix: string, withCoupon = true): Promise
 }
 
 describe('paymentOutcome.test.ts', { concurrency: false, sequential: true }, () => {
+  const releaseTestLocks: Array<() => void> = [];
+
+  before(async () => {
+    try {
+      for (const scene of ['a-commerce', 'a-pay']) {
+        releaseTestLocks.push(await acquireTestLock(scene));
+      }
+    } catch (error) {
+      for (const release of releaseTestLocks.reverse()) release();
+      throw error;
+    }
+  });
+
+  after(() => {
+    for (const release of releaseTestLocks.reverse()) release();
+  });
+
   it('delivers a signed webhook through the durable outbox to Commerce exactly once', async () => {
     await app.bean.executor.mockCtx(async () => {
       const fixture: IFixture = {};

package/vona/src/suite/a-training/modules/training-record/src/dto/detailRecordSubjectResItem.tsx

@@ -38,7 +38,12 @@ export interface IDtoOptionsDetailRecordSubjectResItem extends IDecoratorDtoOpti
 export class DtoDetailRecordSubjectResItem extends $Dto.get(() => ModelSubject, {
   dtoClass: DtoDetailRecordSubjectBase,
 }) {
-  @Api.field(v.title('#'), ZovaRender.order(1, 'core'), ZovaRender.cell('basic-details:lineNumber'))
+  @Api.field(
+    v.title('#'),
+    ZovaRender.order(1, 'core'),
+    ZovaRender.cell('basic-details:lineNumber'),
+    v.optional(),
+  )
   _lineNumber?: number;
 
   @Api.field(

package/vona/src/suite/a-training/modules/training-record/src/dto/recordSelectResItem.tsx

@@ -49,7 +49,9 @@ export interface IDtoOptionsRecordSelectResItem extends IDecoratorDtoOptions {}
     }),
   ],
 })
-export class DtoRecordSelectResItem extends $Dto.get(() => ModelRecord) {
+export class DtoRecordSelectResItem extends $Dto.get(() => ModelRecord, {
+  include: { student: true },
+}) {
   @Api.field(
     ZovaRender.visible(false),
     v.optional(),

package/vona/src/suite/a-training/modules/training-record/src/dto/recordView.tsx

@@ -37,7 +37,10 @@ export interface IDtoOptionsRecordView extends IDecoratorDtoOptions {}
   },
 })
 export class DtoRecordView extends $Dto.get(() => ModelRecord, {
-  include: { trainingRecordSubjects: { dtoClass: DtoDetailRecordSubjectView } },
+  include: {
+    student: true,
+    trainingRecordSubjects: { dtoClass: DtoDetailRecordSubjectView },
+  },
 }) {
   @Api.field(
     ZovaRender.visible(false),

package/vona/src/suite/a-training/modules/training-record/test/record.test.ts

@@ -8,10 +8,51 @@ import path from 'node:path';
 import { describe, it } from 'node:test';
 import { app } from 'vona-mock';
 
+import { DtoDetailRecordSubjectResItem } from '../src/dto/detailRecordSubjectResItem.tsx';
+import { DtoRecordSelectResItem } from '../src/dto/recordSelectResItem.tsx';
+import { DtoRecordView } from '../src/dto/recordView.tsx';
+
 const dossierTextAttendance = Buffer.from('attendance dossier file');
 const dossierTextAssessment = Buffer.from('assessment dossier file');
 
 describe('record.test.ts', () => {
+  it('action:record:emittedDtoSchemas', async () => {
+    await app.bean.executor.mockCtx(async () => {
+      const subjectApiJson = await app.bean.openapi.generateJsonOfClass(
+        DtoDetailRecordSubjectResItem,
+      );
+      const subjectComponent = Object.values(subjectApiJson.components!.schemas as any).find(
+        item => (item as any).properties?._lineNumber,
+      ) as any;
+      assert.ok(subjectComponent?.properties?._lineNumber);
+      assert.equal(subjectComponent.required?.includes('_lineNumber'), false);
+
+      for (const [DtoClass, hasTrainingRecordSubjects] of [
+        [DtoRecordSelectResItem, false],
+        [DtoRecordView, true],
+      ] as const) {
+        const apiJson = await app.bean.openapi.generateJsonOfClass(DtoClass);
+        const component = Object.values(apiJson.components!.schemas as any).find(item => {
+          const properties = (item as any).properties;
+          return (
+            properties?.student &&
+            Boolean(properties?.trainingRecordSubjects) === hasTrainingRecordSubjects
+          );
+        }) as any;
+        assert.ok(component);
+        assert.ok(component.properties.student);
+        assert.equal(
+          Boolean(component.properties.trainingRecordSubjects),
+          hasTrainingRecordSubjects,
+        );
+        assert.deepEqual(Object.keys(component.properties.student.properties).sort(), [
+          'id',
+          'name',
+        ]);
+      }
+    });
+  });
+
   it('action:record', async () => {
     await app.bean.executor.mockCtx(async () => {
       const studentData: DtoStudentCreate = {
@@ -80,6 +121,8 @@ describe('record.test.ts', () => {
         assert.equal(!!recordItem, true);
         assert.equal(recordItem!.name, recordData.name);
         assert.equal(String(recordItem!.studentId), String(studentId));
+        assert.equal(String(recordItem!.student?.id), String(studentId));
+        assert.equal(recordItem!.student?.name, studentData.name);
         assert.equal(recordItem!.dossierFiles?.length, 1);
         assert.equal(recordItem!.dossierFiles?.[0]?.filename, 'attendance.txt');
 
@@ -90,6 +133,8 @@ describe('record.test.ts', () => {
         const recordDossierFile = record.dossierFiles?.[0];
         assert.equal(record.name, recordData.name);
         assert.equal(String(record.studentId), String(studentId));
+        assert.equal(String(record.student?.id), String(studentId));
+        assert.equal(record.student?.name, studentData.name);
         assert.equal(record.subjectCount, recordData.subjectCount);
         assert.equal(record.totalScore, recordData.totalScore);
         assert.equal(Number(record.averageScore), recordData.averageScore);

package/vona/src/suite/a-training/modules/training-student/src/dto/detailRecordResItem.tsx

@@ -39,7 +39,12 @@ export class DtoDetailRecordResItem extends $Dto.get(() => ModelRecord, {
   dtoClass: DtoDetailRecordBase,
   include: { trainingRecordSubjects: false },
 }) {
-  @Api.field(v.title('#'), ZovaRender.order(1, 'core'), ZovaRender.cell('basic-details:lineNumber'))
+  @Api.field(
+    v.title('#'),
+    ZovaRender.order(1, 'core'),
+    ZovaRender.cell('basic-details:lineNumber'),
+    v.optional(),
+  )
   _lineNumber?: number;
 
   @Api.field(

package/vona/src/suite/a-training/modules/training-student/src/dto/studentSummary.tsx

@@ -1,39 +1,21 @@
-import type { TableIdentity } from 'table-identity';
 import type { IDecoratorDtoOptions } from 'vona-module-a-web';
 
 import { Api, v } from 'vona-module-a-openapiutils';
+import { $Dto } from 'vona-module-a-orm';
 import { Dto } from 'vona-module-a-web';
 
 import { $locale } from '../.metadata/locales.ts';
+import { ModelStudent } from '../model/student.ts';
 
 export interface IDtoOptionsStudentSummary extends IDecoratorDtoOptions {}
 
 @Dto<IDtoOptionsStudentSummary>()
-export class DtoStudentSummary {
-  @Api.field(v.tableIdentity())
-  id: TableIdentity;
-
-  @Api.field(v.title($locale('StudentName')))
-  name: string;
-
-  @Api.field(
-    v.title($locale('Mobile')),
-    v.serializerReplace({
-      patternFrom: /^(\d{3})\d{4}(\d+)$/,
-      patternTo: '$1****$2',
-    }),
-  )
-  mobile: string;
-
-  @Api.field(v.title($locale('Level')))
-  level: number;
-
+export class DtoStudentSummary extends $Dto.get(() => ModelStudent, {
+  columns: ['id', 'name', 'mobile', 'level', 'description'],
+}) {
   @Api.field(v.title($locale('LevelTitle')))
   levelTitle: string;
 
-  @Api.field(v.title($locale('Description')), v.optional())
-  description?: string;
-
   @Api.field(v.title($locale('DescriptionLength')))
   descriptionLength: number;
 

package/vona/src/suite/a-training/modules/training-student/test/student.test.ts

@@ -1,8 +1,4 @@
-import type {
-  DtoStudentSelectRes,
-  DtoStudentSummary,
-  EntityStudent,
-} from 'vona-module-training-student';
+import type { DtoStudentSelectRes, EntityStudent } from 'vona-module-training-student';
 
 import assert from 'node:assert';
 import { describe, it } from 'node:test';
@@ -14,6 +10,9 @@ import {
   DtoStudentView,
 } from 'vona-module-training-student';
 
+import { DtoDetailRecordResItem } from '../src/dto/detailRecordResItem.tsx';
+import { DtoStudentSummary } from '../src/dto/studentSummary.tsx';
+
 describe('student.test.ts', () => {
   it('action:student:formLayoutMetadata', async () => {
     await app.bean.executor.mockCtx(async () => {
@@ -77,6 +76,39 @@ describe('student.test.ts', () => {
     });
   });
 
+  it('action:student:emittedDtoSchemas', async () => {
+    await app.bean.executor.mockCtx(async () => {
+      const summaryApiJson = await app.bean.openapi.generateJsonOfClass(DtoStudentSummary);
+      const summaryComponent = Object.values(summaryApiJson.components!.schemas as any).find(
+        item => {
+          return (item as any).properties?.summaryText;
+        },
+      ) as any;
+      assert.ok(summaryComponent);
+      assert.deepEqual(
+        Object.keys(summaryComponent.properties).sort(),
+        [
+          'id',
+          'name',
+          'mobile',
+          'level',
+          'description',
+          'levelTitle',
+          'descriptionLength',
+          'summaryText',
+        ].sort(),
+      );
+
+      const detailRecordApiJson =
+        await app.bean.openapi.generateJsonOfClass(DtoDetailRecordResItem);
+      const detailRecordComponent = Object.values(
+        detailRecordApiJson.components!.schemas as any,
+      ).find(item => (item as any).properties?._lineNumber) as any;
+      assert.ok(detailRecordComponent?.properties?._lineNumber);
+      assert.equal(detailRecordComponent.required?.includes('_lineNumber'), false);
+    });
+  });
+
   it('action:student', async () => {
     await app.bean.executor.mockCtx(async () => {
       // data

package/vona/src/suite-vendor/a-pay/modules/a-pay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-pay",
-  "version": "5.0.1",
+  "version": "5.0.3",
   "description": "",
   "keywords": [
     "Vona Module"

package/vona/src/suite-vendor/a-pay/modules/a-pay/src/.metadata/index.ts

@@ -501,6 +501,7 @@ declare module 'vona' {
 export * from '../service/outbox.ts';
 export * from '../service/paymentSession.ts';
 export * from '../service/providerOperation.ts';
+export * from '../service/refundOperation.ts';
 export * from '../service/webhook.ts';
 
 import 'vona-module-a-bean';
@@ -510,6 +511,7 @@ declare module 'vona-module-a-bean' {
       'a-pay:outbox': never;
 'a-pay:paymentSession': never;
 'a-pay:providerOperation': never;
+'a-pay:refundOperation': never;
 'a-pay:webhook': never;
     }
 
@@ -550,6 +552,17 @@ declare module 'vona-module-a-pay' {
             
           }
 
+        export interface ServiceRefundOperation {
+          /** @internal */
+          get scope(): ScopeModuleAPay;
+        }
+
+          export interface ServiceRefundOperation {
+            get $beanFullName(): 'a-pay.service.refundOperation';
+            get $onionName(): 'a-pay:refundOperation';
+            
+          }
+
         export interface ServiceWebhook {
           /** @internal */
           get scope(): ScopeModuleAPay;
@@ -566,11 +579,13 @@ declare module 'vona-module-a-pay' {
 import type { ServiceOutbox } from '../service/outbox.ts';
 import type { ServicePaymentSession } from '../service/paymentSession.ts';
 import type { ServiceProviderOperation } from '../service/providerOperation.ts';
+import type { ServiceRefundOperation } from '../service/refundOperation.ts';
 import type { ServiceWebhook } from '../service/webhook.ts';
 export interface IModuleService {
   'outbox': ServiceOutbox;
 'paymentSession': ServicePaymentSession;
 'providerOperation': ServiceProviderOperation;
+'refundOperation': ServiceRefundOperation;
 'webhook': ServiceWebhook;
 }
 /** service: end */
@@ -582,6 +597,7 @@ declare module 'vona' {
     'a-pay.service.outbox': ServiceOutbox;
 'a-pay.service.paymentSession': ServicePaymentSession;
 'a-pay.service.providerOperation': ServiceProviderOperation;
+'a-pay.service.refundOperation': ServiceRefundOperation;
 'a-pay.service.webhook': ServiceWebhook;
   }
 }
@@ -675,12 +691,14 @@ export interface IModuleQueue {
 /** queue: end */
 /** schedule: begin */
 export * from '../bean/schedule.outboxDispatch.ts';
+export * from '../bean/schedule.providerOperationDispatch.ts';
 
 import { type IDecoratorScheduleOptions } from 'vona-module-a-schedule';
 declare module 'vona-module-a-schedule' {
   
     export interface IScheduleRecord {
       'a-pay:outboxDispatch': IDecoratorScheduleOptions;
+'a-pay:providerOperationDispatch': IDecoratorScheduleOptions;
     }
 
   
@@ -696,6 +714,17 @@ declare module 'vona-module-a-pay' {
             get $beanFullName(): 'a-pay.schedule.outboxDispatch';
             get $onionName(): 'a-pay:outboxDispatch';
             get $onionOptions(): IDecoratorScheduleOptions;
+          }
+
+        export interface ScheduleProviderOperationDispatch {
+          /** @internal */
+          get scope(): ScopeModuleAPay;
+        }
+
+          export interface ScheduleProviderOperationDispatch {
+            get $beanFullName(): 'a-pay.schedule.providerOperationDispatch';
+            get $onionName(): 'a-pay:providerOperationDispatch';
+            get $onionOptions(): IDecoratorScheduleOptions;
           } 
 }
 /** schedule: end */