@rytass/wms-module-core 0.9.0 → 0.10.0

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 (143) hide show
  1. package/README.md +15 -2
  2. package/docs/README.md +2 -2
  3. package/docs/api-reference.md +129 -10
  4. package/docs/host-integration.md +172 -0
  5. package/docs/integration-guide.md +84 -43
  6. package/index.cjs.js +2454 -1658
  7. package/index.d.ts +2 -0
  8. package/lib/events/inventory-count-lock.subscriber.d.ts +17 -5
  9. package/lib/models/metadata/index.d.ts +1 -0
  10. package/lib/models/metadata/sequence.entity.d.ts +9 -0
  11. package/lib/models/models.module.d.ts +7 -0
  12. package/lib/services/allocate-inventory-order.service.d.ts +3 -3
  13. package/lib/services/batch.service.d.ts +13 -1
  14. package/lib/services/consumption-order.service.d.ts +6 -6
  15. package/lib/services/helper.service.d.ts +10 -4
  16. package/lib/services/hold-inventory-order.service.d.ts +3 -3
  17. package/lib/services/index.d.ts +1 -0
  18. package/lib/services/inventory-count-order.service.d.ts +28 -9
  19. package/lib/services/loader.service.d.ts +11 -3
  20. package/lib/services/material.service.d.ts +1 -1
  21. package/lib/services/merge-batch-order.service.d.ts +2 -2
  22. package/lib/services/quality-inspection-order.service.d.ts +1 -1
  23. package/lib/services/receive-inventory-order.service.d.ts +4 -4
  24. package/lib/services/reclassify-inventory-order.service.d.ts +2 -2
  25. package/lib/services/scrape.service.d.ts +1 -1
  26. package/lib/services/sequence.service.d.ts +58 -0
  27. package/lib/services/ship-inventory-order.service.d.ts +6 -6
  28. package/lib/services/split-batch-order.service.d.ts +2 -2
  29. package/lib/services/stock.service.d.ts +48 -2
  30. package/lib/services/transfer-customer-order.service.d.ts +3 -3
  31. package/lib/services/transfer-order.service.d.ts +7 -5
  32. package/lib/services/transfer-vendor-order.service.d.ts +3 -3
  33. package/lib/table-prefix/logical-table-name.d.ts +21 -0
  34. package/lib/table-prefix/table-prefix.d.ts +30 -0
  35. package/lib/typings/core-module-options.d.ts +31 -0
  36. package/lib/typings/create-transfer-order.input.d.ts +2 -0
  37. package/lib/typings/index.d.ts +20 -0
  38. package/lib/utils/run-in-transaction.d.ts +23 -0
  39. package/lib/utils/table-path.d.ts +13 -0
  40. package/package.json +9 -6
  41. package/index.js +0 -98
  42. package/lib/constants/consumption-change-kind.js +0 -20
  43. package/lib/constants/inventory-count-status.js +0 -22
  44. package/lib/constants/operations.js +0 -76
  45. package/lib/constants/order-type.js +0 -33
  46. package/lib/constants/stock-status.js +0 -61
  47. package/lib/core.module.js +0 -287
  48. package/lib/events/dispatch-scope.js +0 -29
  49. package/lib/events/inventory-count-lock.subscriber.js +0 -98
  50. package/lib/events/stock-change.subscriber.js +0 -252
  51. package/lib/events/wms-event.collector.js +0 -22
  52. package/lib/events/wms-event.dispatcher.js +0 -63
  53. package/lib/events/wms-event.tokens.js +0 -12
  54. package/lib/events/wms-operation-runner.js +0 -101
  55. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.js +0 -40
  56. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.js +0 -104
  57. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order.entity.js +0 -33
  58. package/lib/models/extensions/consumption-order/consumption-order-change.entity.js +0 -59
  59. package/lib/models/extensions/consumption-order/consumption-order-item.entity.js +0 -114
  60. package/lib/models/extensions/consumption-order/consumption-order.entity.js +0 -69
  61. package/lib/models/extensions/hold-inventory-order/hold-inventory-order-change.entity.js +0 -40
  62. package/lib/models/extensions/hold-inventory-order/hold-inventory-order-item.entity.js +0 -98
  63. package/lib/models/extensions/hold-inventory-order/hold-inventory-order.entity.js +0 -43
  64. package/lib/models/extensions/inventory-count-order/inventory-count-order-change.entity.js +0 -50
  65. package/lib/models/extensions/inventory-count-order/inventory-count-order-item.entity.js +0 -191
  66. package/lib/models/extensions/inventory-count-order/inventory-count-order.entity.js +0 -155
  67. package/lib/models/extensions/merge-batch-order/merge-batch-order-change.entity.js +0 -40
  68. package/lib/models/extensions/merge-batch-order/merge-batch-order-item.entity.js +0 -75
  69. package/lib/models/extensions/merge-batch-order/merge-batch-order.entity.js +0 -33
  70. package/lib/models/extensions/order-reference/order-reference.entity.js +0 -95
  71. package/lib/models/extensions/quality-inspection-order/quality-inspection-order-change.entity.js +0 -45
  72. package/lib/models/extensions/quality-inspection-order/quality-inspection-order-item.entity.js +0 -94
  73. package/lib/models/extensions/quality-inspection-order/quality-inspection-order.entity.js +0 -38
  74. package/lib/models/extensions/receive-inventory-order/receive-inventory-order-change.entity.js +0 -46
  75. package/lib/models/extensions/receive-inventory-order/receive-inventory-order-item.entity.js +0 -89
  76. package/lib/models/extensions/receive-inventory-order/receive-inventory-order.entity.js +0 -57
  77. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.js +0 -40
  78. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.js +0 -75
  79. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.js +0 -33
  80. package/lib/models/extensions/scrape-order/scrape-order-change.entity.js +0 -40
  81. package/lib/models/extensions/scrape-order/scrape-order-item.entity.js +0 -94
  82. package/lib/models/extensions/scrape-order/scrape-order.entity.js +0 -33
  83. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-change.entity.js +0 -46
  84. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-item.entity.js +0 -90
  85. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.js +0 -65
  86. package/lib/models/extensions/ship-inventory-order/ship-inventory-order.entity.js +0 -56
  87. package/lib/models/extensions/split-batch-order/split-batch-order-change.entity.js +0 -40
  88. package/lib/models/extensions/split-batch-order/split-batch-order-item.entity.js +0 -75
  89. package/lib/models/extensions/split-batch-order/split-batch-order.entity.js +0 -33
  90. package/lib/models/extensions/transfer-customer-order/transfer-customer-order-change.entity.js +0 -40
  91. package/lib/models/extensions/transfer-customer-order/transfer-customer-order-item.entity.js +0 -99
  92. package/lib/models/extensions/transfer-customer-order/transfer-customer-order.entity.js +0 -33
  93. package/lib/models/extensions/transfer-order/transfer-order-change.entity.js +0 -40
  94. package/lib/models/extensions/transfer-order/transfer-order-item.entity.js +0 -109
  95. package/lib/models/extensions/transfer-order/transfer-order.entity.js +0 -53
  96. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.js +0 -40
  97. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.js +0 -99
  98. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order.entity.js +0 -33
  99. package/lib/models/metadata/batch-group.entity.js +0 -31
  100. package/lib/models/metadata/batch.entity.js +0 -131
  101. package/lib/models/metadata/loader-type.entity.js +0 -43
  102. package/lib/models/metadata/loader-unit.entity.js +0 -21
  103. package/lib/models/metadata/loader.entity.js +0 -98
  104. package/lib/models/metadata/location.entity.js +0 -28
  105. package/lib/models/metadata/material-unit.entity.js +0 -51
  106. package/lib/models/metadata/material.entity.js +0 -28
  107. package/lib/models/metadata/order.entity.js +0 -5
  108. package/lib/models/metadata/sale-order.entity.js +0 -21
  109. package/lib/models/metadata/stock.entity.js +0 -29
  110. package/lib/models/metadata/unit.entity.js +0 -21
  111. package/lib/models/models.module.js +0 -158
  112. package/lib/models/wms-entities.js +0 -82
  113. package/lib/services/allocate-inventory-order.service.js +0 -310
  114. package/lib/services/base-order.service.js +0 -76
  115. package/lib/services/batch.service.js +0 -272
  116. package/lib/services/consumption-order.service.js +0 -504
  117. package/lib/services/helper.service.js +0 -28
  118. package/lib/services/hold-inventory-order.service.js +0 -296
  119. package/lib/services/inventory-count-order.service.js +0 -648
  120. package/lib/services/loader.service.js +0 -291
  121. package/lib/services/location.service.js +0 -139
  122. package/lib/services/material.service.js +0 -181
  123. package/lib/services/merge-batch-order.service.js +0 -206
  124. package/lib/services/order-reference.service.js +0 -136
  125. package/lib/services/quality-inspection-order.service.js +0 -146
  126. package/lib/services/receive-inventory-order.service.js +0 -468
  127. package/lib/services/reclassify-inventory-order.service.js +0 -192
  128. package/lib/services/sale-order.service.js +0 -20
  129. package/lib/services/scrape.service.js +0 -150
  130. package/lib/services/ship-inventory-order.service.js +0 -610
  131. package/lib/services/split-batch-order.service.js +0 -191
  132. package/lib/services/stock.service.js +0 -559
  133. package/lib/services/transfer-customer-order.service.js +0 -290
  134. package/lib/services/transfer-order.service.js +0 -641
  135. package/lib/services/transfer-vendor-order.service.js +0 -290
  136. package/lib/services/unit.service.js +0 -76
  137. package/lib/services/warehouse-map.service.js +0 -50
  138. package/lib/typings/core-module-options.js +0 -3
  139. package/lib/typings/entity-overrides.d.ts +0 -34
  140. package/lib/typings/entity-overrides.js +0 -7
  141. package/lib/typings/find-receive-inventory-order.input.js +0 -9
  142. package/lib/typings/find-ship-inventory-order.input.js +0 -9
  143. package/src/lib/models/extensions/README.md +0 -219
@@ -1,191 +0,0 @@
1
- import { __decorate, __param, __metadata } from 'tslib';
2
- import { Injectable, Inject } from '@nestjs/common';
3
- import '../models/metadata/batch.entity.js';
4
- import '../models/metadata/batch-group.entity.js';
5
- import '../models/metadata/loader.entity.js';
6
- import '../models/metadata/loader-type.entity.js';
7
- import '../models/metadata/loader-unit.entity.js';
8
- import '../models/metadata/location.entity.js';
9
- import '../models/metadata/material.entity.js';
10
- import '../models/metadata/material-unit.entity.js';
11
- import '@rytass/wms-base-nestjs-module';
12
- import '../models/metadata/sale-order.entity.js';
13
- import '../models/metadata/stock.entity.js';
14
- import '../models/metadata/unit.entity.js';
15
- import { WmsEntities } from '../models/wms-entities.js';
16
- import '../models/extensions/receive-inventory-order/receive-inventory-order-item.entity.js';
17
- import '../models/extensions/receive-inventory-order/receive-inventory-order.entity.js';
18
- import '../models/extensions/receive-inventory-order/receive-inventory-order-change.entity.js';
19
- import '../models/extensions/ship-inventory-order/ship-inventory-order-item.entity.js';
20
- import '../models/extensions/ship-inventory-order/ship-inventory-order.entity.js';
21
- import '../models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.js';
22
- import '../models/extensions/ship-inventory-order/ship-inventory-order-change.entity.js';
23
- import '../models/extensions/transfer-order/transfer-order.entity.js';
24
- import '../models/extensions/transfer-order/transfer-order-item.entity.js';
25
- import '../models/extensions/transfer-order/transfer-order-change.entity.js';
26
- import '../models/extensions/hold-inventory-order/hold-inventory-order.entity.js';
27
- import '../models/extensions/hold-inventory-order/hold-inventory-order-item.entity.js';
28
- import '../models/extensions/hold-inventory-order/hold-inventory-order-change.entity.js';
29
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order.entity.js';
30
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.js';
31
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.js';
32
- import { SplitBatchOrderEntity } from '../models/extensions/split-batch-order/split-batch-order.entity.js';
33
- import { SplitBatchOrderItemEntity } from '../models/extensions/split-batch-order/split-batch-order-item.entity.js';
34
- import { SplitBatchOrderChangeEntityClass } from '../models/extensions/split-batch-order/split-batch-order-change.entity.js';
35
- import '../models/extensions/merge-batch-order/merge-batch-order.entity.js';
36
- import '../models/extensions/merge-batch-order/merge-batch-order-item.entity.js';
37
- import '../models/extensions/merge-batch-order/merge-batch-order-change.entity.js';
38
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.js';
39
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.js';
40
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.js';
41
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order.entity.js';
42
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.js';
43
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.js';
44
- import '../models/extensions/quality-inspection-order/quality-inspection-order.entity.js';
45
- import '../models/extensions/quality-inspection-order/quality-inspection-order-item.entity.js';
46
- import '../models/extensions/quality-inspection-order/quality-inspection-order-change.entity.js';
47
- import '../models/extensions/transfer-customer-order/transfer-customer-order.entity.js';
48
- import '../models/extensions/transfer-customer-order/transfer-customer-order-item.entity.js';
49
- import '../models/extensions/transfer-customer-order/transfer-customer-order-change.entity.js';
50
- import '../models/extensions/scrape-order/scrape-order.entity.js';
51
- import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
- import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
- import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
- import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
- import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
56
- import '../models/extensions/consumption-order/consumption-order.entity.js';
57
- import '../models/extensions/consumption-order/consumption-order-item.entity.js';
58
- import '../models/extensions/consumption-order/consumption-order-change.entity.js';
59
- import '../models/extensions/order-reference/order-reference.entity.js';
60
- import { DataSource } from 'typeorm';
61
- import { MaterialService } from './material.service.js';
62
- import { BatchService } from './batch.service.js';
63
- import { HelperService } from './helper.service.js';
64
- import { StockService } from './stock.service.js';
65
-
66
- let SplitBatchOrderService = class SplitBatchOrderService {
67
- dataSource;
68
- entities;
69
- materialService;
70
- batchService;
71
- helperService;
72
- stockService;
73
- splitBatchOrderEntity;
74
- splitBatchOrderItemEntity;
75
- seqPrefix = 'SBO';
76
- constructor(dataSource, entities, materialService, batchService, helperService, stockService, splitBatchOrderEntity, splitBatchOrderItemEntity) {
77
- this.dataSource = dataSource;
78
- this.entities = entities;
79
- this.materialService = materialService;
80
- this.batchService = batchService;
81
- this.helperService = helperService;
82
- this.stockService = stockService;
83
- this.splitBatchOrderEntity = splitBatchOrderEntity;
84
- this.splitBatchOrderItemEntity = splitBatchOrderItemEntity;
85
- }
86
- split(options) {
87
- return this.dataSource.transaction(async (manager) => {
88
- const splitBatchOrderRepository = manager.getRepository(this.splitBatchOrderEntity);
89
- const splitBatchOrderItemRepository = manager.getRepository(this.splitBatchOrderItemEntity);
90
- const splitBatchOrderChangeRepository = manager.getRepository(SplitBatchOrderChangeEntityClass);
91
- const orderRepository = manager.getRepository(this.entities.order);
92
- const stockRepository = manager.getRepository(this.entities.stock);
93
- const batchRepository = manager.getRepository(this.entities.batch);
94
- // Get original batch information
95
- const originalBatch = await batchRepository.findOneOrFail({
96
- where: { id: options.batchId },
97
- });
98
- /*
99
- * `batches` carries `UNIQUE (key, materialId)`, so two items aiming at the
100
- * same target key cannot both create one. Left alone they race
101
- * `getBatch`'s read-then-create and the second insert aborts the whole
102
- * split with a constraint violation that names neither item.
103
- */
104
- const duplicateKey = options.items
105
- .map(({ batchKey }) => batchKey)
106
- .find((batchKey, index, keys) => keys.indexOf(batchKey) !== index);
107
- if (duplicateKey) {
108
- throw new Error(`Split order names batch key "${duplicateKey}" more than once; each child needs its own key.`);
109
- }
110
- const key = await this.helperService.getSeq(this.seqPrefix, manager);
111
- const order = await splitBatchOrderRepository.save(splitBatchOrderRepository.create({
112
- key,
113
- }));
114
- // Get conversion factor for unit conversion
115
- const conversionFactor = await this.materialService.getConversionFactor(originalBatch.materialId, options.unitId || undefined);
116
- // Sequential: two items can reference the same *source* batch, and the
117
- // availability check below reads the ledger the earlier item just wrote.
118
- for (const item of options.items) {
119
- await (async () => {
120
- // Get or create target batch. The genealogy link and the host's
121
- // attributes only land when this call creates the batch — reusing an
122
- // existing key keeps whatever it already carries.
123
- const targetBatch = await this.batchService.getBatch({
124
- key: item.batchKey,
125
- materialId: originalBatch.materialId,
126
- parentBatchId: options.batchId,
127
- attributes: item.attributes ?? null,
128
- manager,
129
- });
130
- // Create base order record
131
- const baseOrder = await orderRepository.save({});
132
- // Create split batch order item
133
- const splitItem = await splitBatchOrderItemRepository.save(splitBatchOrderItemRepository.create({
134
- targetSplitQuantity: item.quantity,
135
- locationId: this.stockService.resolveLocationId(item.locationId),
136
- loaderId: item.loaderId,
137
- orderId: order.id,
138
- }));
139
- // Record the change
140
- await splitBatchOrderChangeRepository.save(splitBatchOrderChangeRepository.create({
141
- itemId: splitItem.id,
142
- id: baseOrder.id,
143
- quantityChanged: item.quantity * conversionFactor,
144
- }));
145
- // Update stock: deduct from original batch and add to target batch
146
- await this.stockService.validateStockAvailability({
147
- materialId: originalBatch.materialId,
148
- batchId: options.batchId,
149
- locationId: this.stockService.resolveLocationId(item.locationId),
150
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
151
- quantity: item.quantity * conversionFactor,
152
- }, manager);
153
- await stockRepository.save(stockRepository.create([
154
- // Deduct from original batch
155
- {
156
- orderId: baseOrder.id,
157
- materialId: originalBatch.materialId,
158
- batchId: options.batchId,
159
- locationId: this.stockService.resolveLocationId(item.locationId),
160
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
161
- quantity: -1 * item.quantity * conversionFactor,
162
- },
163
- // Add to target batch
164
- {
165
- orderId: baseOrder.id,
166
- materialId: originalBatch.materialId,
167
- batchId: targetBatch.id,
168
- locationId: this.stockService.resolveLocationId(item.locationId),
169
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
170
- quantity: item.quantity * conversionFactor,
171
- },
172
- ]));
173
- })();
174
- }
175
- return order;
176
- });
177
- }
178
- };
179
- SplitBatchOrderService = __decorate([
180
- Injectable(),
181
- __param(6, Inject(SplitBatchOrderEntity)),
182
- __param(7, Inject(SplitBatchOrderItemEntity)),
183
- __metadata("design:paramtypes", [DataSource,
184
- WmsEntities,
185
- MaterialService,
186
- BatchService,
187
- HelperService,
188
- StockService, Object, Object])
189
- ], SplitBatchOrderService);
190
-
191
- export { SplitBatchOrderService };