cabloy 5.1.124 → 5.1.126

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/.cabloy-version +1 -1
  2. package/.claude/skills/cabloy-backend-scaffold/SKILL.md +1 -1
  3. package/.claude/skills/cabloy-backend-scaffold/evals/evals.json +6 -0
  4. package/.claude/skills/cabloy-backend-scaffold/references/follow-up-checklist.md +13 -4
  5. package/.claude/skills/cabloy-workflow/SKILL.md +4 -2
  6. package/.claude/skills/cabloy-workflow/evals/evals.json +14 -2
  7. package/.claude/skills/cabloy-worktree-environment/SKILL.md +206 -0
  8. package/.claude/skills/cabloy-worktree-environment/evals/evals.json +77 -0
  9. package/.github/workflows/vona-test-pg.yml +3 -0
  10. package/.github/workflows/vona-test-sqlite3.yml +3 -0
  11. package/CHANGELOG.md +21 -0
  12. package/CLAUDE.md +1 -1
  13. package/cabloy-docs/.vitepress/config.mjs +2 -0
  14. package/cabloy-docs/ai/playbook-technical-blog-authoring.md +158 -0
  15. package/cabloy-docs/backend/backend-contract-emission-specimen.md +2 -2
  16. package/cabloy-docs/backend/dto-guide.md +10 -7
  17. package/cabloy-docs/backend/dto-infer-generation.md +127 -7
  18. package/cabloy-docs/backend/foundation.md +1 -1
  19. package/cabloy-docs/backend/introduction.md +1 -0
  20. package/cabloy-docs/backend/module-dependencies.md +104 -0
  21. package/cabloy-docs/backend/serialization-guide.md +6 -0
  22. package/cabloy-docs/fullstack/parallel-worktree-environment.md +72 -34
  23. package/cabloy-docs/fullstack/suites-and-modules.md +1 -0
  24. package/cabloy-docs/reference/package-map.md +1 -0
  25. package/e2e/specs/a-commerce/commerce.spec.ts +89 -0
  26. package/package.json +2 -1
  27. package/scripts/init.ts +7 -12
  28. package/scripts/initAppName.test.ts +72 -0
  29. package/scripts/initAppName.ts +50 -0
  30. package/vona/packages-vona/vona/package.json +1 -1
  31. package/vona/pnpm-lock.yaml +48 -146
  32. package/vona/src/suite/a-commerce/modules/commerce-member/src/dto/addressMineCreate.tsx +6 -27
  33. package/vona/src/suite/a-commerce/modules/commerce-member/src/dto/addressMineItem.tsx +6 -31
  34. package/vona/src/suite/a-commerce/modules/commerce-member/src/dto/addressMineUpdate.tsx +6 -2
  35. package/vona/src/suite/a-commerce/modules/commerce-member/src/lib/addressMine.ts +16 -0
  36. package/vona/src/suite/a-commerce/modules/commerce-member/src/service/address.ts +4 -17
  37. package/vona/src/suite/a-commerce/modules/commerce-member/test/addressOwnership.test.ts +63 -19
  38. package/vona/src/suite/a-commerce/modules/commerce-payment/package.json +2 -1
  39. package/vona/src/suite/a-commerce/modules/commerce-payment/src/bean/payScene.commerceOrder.ts +11 -2
  40. package/vona/src/suite/a-commerce/modules/commerce-payment/src/service/commercePayScene.ts +26 -0
  41. package/vona/src/suite/a-commerce/modules/commerce-payment/test/paymentAttempt.test.ts +19 -2
  42. package/vona/src/suite/a-commerce/modules/commerce-promotion/src/config/locale/en-us.ts +5 -2
  43. package/vona/src/suite/a-commerce/modules/commerce-promotion/src/config/locale/zh-cn.ts +5 -2
  44. package/vona/src/suite/a-commerce/modules/commerce-promotion/src/dto/couponTemplateCreate.tsx +26 -35
  45. package/vona/src/suite/a-commerce/modules/commerce-promotion/src/dto/couponTemplateUpdate.tsx +6 -1
  46. package/vona/src/suite/a-commerce/modules/commerce-promotion/src/entity/couponTemplate.tsx +40 -4
  47. package/vona/src/suite/a-commerce/modules/commerce-promotion/test/couponTemplateFormLayout.test.ts +85 -0
  48. package/vona/src/suite/a-commerce/modules/commerce-trade/src/.metadata/index.ts +1 -1
  49. package/vona/src/suite/a-commerce/modules/commerce-trade/src/controller/order.ts +3 -5
  50. package/vona/src/suite/a-commerce/modules/commerce-trade/src/dto/orderSummary.tsx +7 -40
  51. package/vona/src/suite/a-commerce/modules/commerce-trade/src/dto/shipmentView.tsx +6 -15
  52. package/vona/src/suite/a-commerce/modules/commerce-trade/src/lib/order.ts +9 -0
  53. package/vona/src/suite/a-commerce/modules/commerce-trade/src/service/order.ts +121 -11
  54. package/vona/src/suite/a-commerce/modules/commerce-trade/test/order.test.ts +25 -0
  55. package/vona/src/suite/a-commerce/modules/commerce-trade/test/paymentOutcome.test.ts +19 -2
  56. package/vona/src/suite/a-training/modules/training-record/src/dto/detailRecordSubjectResItem.tsx +6 -1
  57. package/vona/src/suite/a-training/modules/training-record/src/dto/recordSelectResItem.tsx +3 -1
  58. package/vona/src/suite/a-training/modules/training-record/src/dto/recordView.tsx +4 -1
  59. package/vona/src/suite/a-training/modules/training-record/test/record.test.ts +45 -0
  60. package/vona/src/suite/a-training/modules/training-student/src/dto/detailRecordResItem.tsx +6 -1
  61. package/vona/src/suite/a-training/modules/training-student/src/dto/studentSummary.tsx +5 -23
  62. package/vona/src/suite/a-training/modules/training-student/test/student.test.ts +37 -5
  63. package/vona/src/suite-vendor/a-pay/modules/a-pay/package.json +1 -1
  64. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/.metadata/index.ts +29 -0
  65. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/bean/meta.index.ts +3 -0
  66. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/bean/meta.redlock.ts +3 -1
  67. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/bean/meta.version.ts +7 -0
  68. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/bean/queue.outboxDispatch.ts +9 -4
  69. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/bean/schedule.providerOperationDispatch.ts +11 -0
  70. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/entity/outboxEvent.tsx +11 -4
  71. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/entity/providerOperation.tsx +12 -0
  72. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/entity/webhookInbox.tsx +6 -0
  73. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/service/outbox.ts +12 -5
  74. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/service/paymentSession.ts +1 -37
  75. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/service/providerOperation.ts +355 -1
  76. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/service/refundOperation.ts +226 -0
  77. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/service/webhook.ts +148 -50
  78. package/vona/src/suite-vendor/a-pay/modules/a-pay/src/types/payScene.ts +2 -1
  79. package/vona/src/suite-vendor/a-pay/modules/pay-mock/package.json +1 -1
  80. package/vona/src/suite-vendor/a-pay/modules/pay-mock/src/.metadata/index.ts +39 -22
  81. package/vona/src/suite-vendor/a-pay/modules/pay-mock/src/bean/payProvider.mock.ts +42 -13
  82. package/vona/src/suite-vendor/a-pay/modules/pay-mock/src/controller/mockPayment.ts +11 -0
  83. package/vona/src/suite-vendor/a-pay/modules/pay-mock/src/dto/mockRefundComplete.tsx +13 -0
  84. package/vona/src/suite-vendor/a-pay/modules/pay-mock/src/dto/mockRefundReceipt.tsx +16 -0
  85. package/vona/src/suite-vendor/a-pay/modules/pay-mock/src/service/payMock.ts +56 -0
  86. package/vona/src/suite-vendor/a-pay/modules/pay-paypal/package.json +2 -1
  87. package/vona/src/suite-vendor/a-pay/modules/pay-paypal/src/bean/payProvider.paypal.ts +117 -8
  88. package/vona/src/suite-vendor/a-pay/modules/pay-stripe/package.json +1 -1
  89. package/vona/src/suite-vendor/a-pay/package.json +5 -5
  90. package/vona/src/suite-vendor/a-vona/modules/a-orm/package.json +1 -1
  91. package/vona/src/suite-vendor/a-vona/modules/a-orm/src/lib/dto/dtoGet.ts +5 -5
  92. package/vona/src/suite-vendor/a-vona/package.json +1 -1
  93. package/zova/src/suite/a-commerce/modules/commerce-member/src/api/openapi/schemas.ts +54 -12
  94. package/zova/src/suite/a-commerce/modules/commerce-member/src/api/openapi/types.ts +625 -64
  95. package/zova/src/suite/a-commerce/modules/commerce-promotion/src/api/openapi/types.ts +55 -15
  96. package/zova/src/suite/a-commerce/modules/commerce-trade/cli/openapi.config.ts +1 -1
  97. package/zova/src/suite/a-commerce/modules/commerce-trade/src/api/commerceTradeOrder.ts +15 -17
  98. package/zova/src/suite/a-commerce/modules/commerce-trade/src/api/openapi/schemas.ts +12 -8
  99. package/zova/src/suite/a-commerce/modules/commerce-trade/src/api/openapi/types.ts +111 -26
  100. package/zova/src/suite/a-commerce/modules/commerce-trade/src/apiSchema/commerceTradeOrder.ts +3 -3
  101. package/zova/src/suite/a-commerce/modules/commerce-trade/src/component/tableCellActionRefund/controller.tsx +1 -8
  102. package/zova/src/suite/a-commerce/modules/commerce-trade/src/model/order.ts +5 -9
  103. package/zova/src/suite/a-training/modules/training-student/src/.metadata/index.ts +1 -1
  104. package/zova/src/suite/a-training/modules/training-student/src/api/openapi/schemas.ts +301 -17
  105. package/zova/src/suite/a-training/modules/training-student/src/api/openapi/types.ts +5461 -1788
  106. package/vona/src/suite-vendor/a-pay/modules/a-pay/test/outbox.test.ts +0 -209
  107. package/vona/src/suite-vendor/a-pay/modules/a-pay/test/paymentSession.test.ts +0 -153
  108. package/vona/src/suite-vendor/a-pay/modules/a-pay/test/webhook.test.ts +0 -278
  109. package/vona/src/suite-vendor/a-pay/modules/pay-mock/test/payMock.test.ts +0 -141
@@ -1,141 +0,0 @@
1
- import assert from 'node:assert';
2
- import { randomUUID } from 'node:crypto';
3
- import { describe, it } from 'node:test';
4
- import { app } from 'vona-mock';
5
-
6
- interface IFixture {
7
- userId?: number;
8
- paymentSessionId?: number;
9
- }
10
-
11
- async function createFixture(suffix: string): Promise<IFixture> {
12
- const user = await app.bean.user.register({ name: `pay-mock-${suffix}` }, true);
13
- await app.bean.passport.signinMock(`pay-mock-${suffix}` as any);
14
- const session = await app.scope('a-pay').service.paymentSession.create({
15
- userId: user.id,
16
- payScene: 'commerce-payment:commerceOrder',
17
- businessReference: `business-${suffix}`,
18
- amountMinor: 1299,
19
- currency: 'USD',
20
- correlationId: `payment-${suffix}`,
21
- });
22
- await app.scope('a-pay').service.paymentSession.start(session.id);
23
- return { userId: user.id as number, paymentSessionId: session.id as number };
24
- }
25
-
26
- async function cleanup(fixture: IFixture) {
27
- const pay = app.scope('a-pay');
28
- if (fixture.paymentSessionId !== undefined) {
29
- await pay.model.outboxEvent.delete({ paymentSessionId: fixture.paymentSessionId });
30
- await pay.model.paymentAudit.delete({ paymentSessionId: fixture.paymentSessionId });
31
- await pay.model.webhookInbox.delete({ paymentSessionId: fixture.paymentSessionId });
32
- await pay.model.paymentSession.delete({ id: fixture.paymentSessionId });
33
- }
34
- if (fixture.userId !== undefined) {
35
- await app.scope('home-user').model.roleUser.delete({ userId: fixture.userId });
36
- await app.bean.user.removeById(fixture.userId);
37
- }
38
- await app.bean.passport.signout();
39
- }
40
-
41
- describe('payMock.test.ts', { concurrency: false }, () => {
42
- it('captures Vona env secrets in the mock Provider options', () => {
43
- const options = app.bean.payProvider.getOptions('pay-mock:mock', 'default');
44
- assert.equal(options.secretCredential, app.meta.env.PAY_MOCK_DEFAULT_CREDENTIAL);
45
- assert.equal(options.secretWebhook, app.meta.env.PAY_MOCK_DEFAULT_WEBHOOK);
46
- assert.equal(String(options.secretCredential).startsWith('env:' + '//'), false);
47
- assert.equal(String(options.secretWebhook).startsWith('env:' + '//'), false);
48
- assert.deepEqual(options.capabilities, {
49
- redirectCheckout: false,
50
- embeddedCheckout: true,
51
- automaticCapture: true,
52
- manualCapture: false,
53
- refunds: true,
54
- partialRefunds: true,
55
- webhooks: true,
56
- });
57
- assert.deepEqual(
58
- app.bean.payProvider.resolveByName('pay-mock:mock', 'secondary').clientOptions.capabilities,
59
- options.capabilities,
60
- );
61
- });
62
-
63
- it('submits server-derived mock payment facts through the signed webhook', async () => {
64
- await app.bean.executor.mockCtx(async () => {
65
- const fixture: IFixture = {};
66
- try {
67
- Object.assign(fixture, await createFixture('success'));
68
- const receipt = await app
69
- .scope('pay-mock')
70
- .service.payMock.completePaymentSession(fixture.paymentSessionId!, 'succeeded');
71
- assert.deepEqual(receipt, { paymentSessionId: fixture.paymentSessionId, accepted: true });
72
- const pay = app.scope('a-pay');
73
- const [session, inboxes, audits, outbox] = await Promise.all([
74
- pay.model.paymentSession.getById(fixture.paymentSessionId!),
75
- pay.model.webhookInbox.select({ where: { paymentSessionId: fixture.paymentSessionId } }),
76
- pay.model.paymentAudit.select({ where: { paymentSessionId: fixture.paymentSessionId } }),
77
- pay.model.outboxEvent.select({ where: { paymentSessionId: fixture.paymentSessionId } }),
78
- ]);
79
- assert.equal(session?.state, 'succeeded');
80
- assert.equal(inboxes.length, 1);
81
- assert.equal(audits.filter(item => item.source === 'webhook').length, 1);
82
- assert.equal(outbox.length, 1);
83
- } finally {
84
- await cleanup(fixture);
85
- }
86
- });
87
- });
88
-
89
- it('completes a payment session in the active named instance', async () => {
90
- await app.bean.executor.mockCtx(
91
- async () => {
92
- const fixture: IFixture = {};
93
- try {
94
- Object.assign(fixture, await createFixture(`named-${randomUUID().slice(0, 12)}`));
95
- const receipt = await app
96
- .scope('pay-mock')
97
- .service.payMock.completePaymentSession(fixture.paymentSessionId!, 'succeeded');
98
- assert.deepEqual(receipt, { paymentSessionId: fixture.paymentSessionId, accepted: true });
99
- const pay = app.scope('a-pay');
100
- const [session, inboxes, audits, outbox] = await Promise.all([
101
- pay.model.paymentSession.getById(fixture.paymentSessionId!),
102
- pay.model.webhookInbox.select({
103
- where: { paymentSessionId: fixture.paymentSessionId },
104
- }),
105
- pay.model.paymentAudit.select({
106
- where: { paymentSessionId: fixture.paymentSessionId },
107
- }),
108
- pay.model.outboxEvent.select({ where: { paymentSessionId: fixture.paymentSessionId } }),
109
- ]);
110
- assert.equal(session?.state, 'succeeded');
111
- assert.equal(inboxes.length, 1);
112
- assert.equal(audits.filter(item => item.source === 'webhook').length, 1);
113
- assert.equal(outbox.length, 1);
114
- } finally {
115
- await cleanup(fixture);
116
- }
117
- },
118
- { instanceName: 'shareTest' as any },
119
- );
120
- });
121
-
122
- it('does not simulate a session that is no longer actionable', async () => {
123
- await app.bean.executor.mockCtx(async () => {
124
- const fixture: IFixture = {};
125
- try {
126
- Object.assign(fixture, await createFixture('terminal'));
127
- await app
128
- .scope('pay-mock')
129
- .service.payMock.completePaymentSession(fixture.paymentSessionId!, 'cancelled');
130
- await assert.rejects(
131
- app
132
- .scope('pay-mock')
133
- .service.payMock.completePaymentSession(fixture.paymentSessionId!, 'cancelled'),
134
- { status: 409 },
135
- );
136
- } finally {
137
- await cleanup(fixture);
138
- }
139
- });
140
- });
141
- });