@rytass/wms-module-core 0.9.1 → 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 (141) 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 +3 -12
  41. package/index.d.mts +0 -6
  42. package/index.mjs +0 -98
  43. package/lib/constants/consumption-change-kind.mjs +0 -20
  44. package/lib/constants/inventory-count-status.mjs +0 -22
  45. package/lib/constants/operations.mjs +0 -76
  46. package/lib/constants/order-type.mjs +0 -33
  47. package/lib/constants/stock-status.mjs +0 -61
  48. package/lib/core.module.mjs +0 -287
  49. package/lib/events/dispatch-scope.mjs +0 -29
  50. package/lib/events/inventory-count-lock.subscriber.mjs +0 -98
  51. package/lib/events/stock-change.subscriber.mjs +0 -252
  52. package/lib/events/wms-event.collector.mjs +0 -22
  53. package/lib/events/wms-event.dispatcher.mjs +0 -63
  54. package/lib/events/wms-event.tokens.mjs +0 -12
  55. package/lib/events/wms-operation-runner.mjs +0 -101
  56. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.mjs +0 -40
  57. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.mjs +0 -104
  58. package/lib/models/extensions/allocate-inventory-order/allocate-inventory-order.entity.mjs +0 -33
  59. package/lib/models/extensions/consumption-order/consumption-order-change.entity.mjs +0 -59
  60. package/lib/models/extensions/consumption-order/consumption-order-item.entity.mjs +0 -114
  61. package/lib/models/extensions/consumption-order/consumption-order.entity.mjs +0 -69
  62. package/lib/models/extensions/hold-inventory-order/hold-inventory-order-change.entity.mjs +0 -40
  63. package/lib/models/extensions/hold-inventory-order/hold-inventory-order-item.entity.mjs +0 -98
  64. package/lib/models/extensions/hold-inventory-order/hold-inventory-order.entity.mjs +0 -43
  65. package/lib/models/extensions/inventory-count-order/inventory-count-order-change.entity.mjs +0 -50
  66. package/lib/models/extensions/inventory-count-order/inventory-count-order-item.entity.mjs +0 -191
  67. package/lib/models/extensions/inventory-count-order/inventory-count-order.entity.mjs +0 -155
  68. package/lib/models/extensions/merge-batch-order/merge-batch-order-change.entity.mjs +0 -40
  69. package/lib/models/extensions/merge-batch-order/merge-batch-order-item.entity.mjs +0 -75
  70. package/lib/models/extensions/merge-batch-order/merge-batch-order.entity.mjs +0 -33
  71. package/lib/models/extensions/order-reference/order-reference.entity.mjs +0 -95
  72. package/lib/models/extensions/quality-inspection-order/quality-inspection-order-change.entity.mjs +0 -45
  73. package/lib/models/extensions/quality-inspection-order/quality-inspection-order-item.entity.mjs +0 -94
  74. package/lib/models/extensions/quality-inspection-order/quality-inspection-order.entity.mjs +0 -38
  75. package/lib/models/extensions/receive-inventory-order/receive-inventory-order-change.entity.mjs +0 -46
  76. package/lib/models/extensions/receive-inventory-order/receive-inventory-order-item.entity.mjs +0 -89
  77. package/lib/models/extensions/receive-inventory-order/receive-inventory-order.entity.mjs +0 -57
  78. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.mjs +0 -40
  79. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.mjs +0 -75
  80. package/lib/models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.mjs +0 -33
  81. package/lib/models/extensions/scrape-order/scrape-order-change.entity.mjs +0 -40
  82. package/lib/models/extensions/scrape-order/scrape-order-item.entity.mjs +0 -94
  83. package/lib/models/extensions/scrape-order/scrape-order.entity.mjs +0 -33
  84. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-change.entity.mjs +0 -46
  85. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-item.entity.mjs +0 -90
  86. package/lib/models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.mjs +0 -65
  87. package/lib/models/extensions/ship-inventory-order/ship-inventory-order.entity.mjs +0 -56
  88. package/lib/models/extensions/split-batch-order/split-batch-order-change.entity.mjs +0 -40
  89. package/lib/models/extensions/split-batch-order/split-batch-order-item.entity.mjs +0 -75
  90. package/lib/models/extensions/split-batch-order/split-batch-order.entity.mjs +0 -33
  91. package/lib/models/extensions/transfer-customer-order/transfer-customer-order-change.entity.mjs +0 -40
  92. package/lib/models/extensions/transfer-customer-order/transfer-customer-order-item.entity.mjs +0 -99
  93. package/lib/models/extensions/transfer-customer-order/transfer-customer-order.entity.mjs +0 -33
  94. package/lib/models/extensions/transfer-order/transfer-order-change.entity.mjs +0 -40
  95. package/lib/models/extensions/transfer-order/transfer-order-item.entity.mjs +0 -109
  96. package/lib/models/extensions/transfer-order/transfer-order.entity.mjs +0 -53
  97. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.mjs +0 -40
  98. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.mjs +0 -99
  99. package/lib/models/extensions/transfer-vendor-order/transfer-vendor-order.entity.mjs +0 -33
  100. package/lib/models/metadata/batch-group.entity.mjs +0 -31
  101. package/lib/models/metadata/batch.entity.mjs +0 -131
  102. package/lib/models/metadata/loader-type.entity.mjs +0 -43
  103. package/lib/models/metadata/loader-unit.entity.mjs +0 -21
  104. package/lib/models/metadata/loader.entity.mjs +0 -98
  105. package/lib/models/metadata/location.entity.mjs +0 -28
  106. package/lib/models/metadata/material-unit.entity.mjs +0 -51
  107. package/lib/models/metadata/material.entity.mjs +0 -28
  108. package/lib/models/metadata/order.entity.mjs +0 -5
  109. package/lib/models/metadata/sale-order.entity.mjs +0 -21
  110. package/lib/models/metadata/stock.entity.mjs +0 -29
  111. package/lib/models/metadata/unit.entity.mjs +0 -21
  112. package/lib/models/models.module.mjs +0 -158
  113. package/lib/models/wms-entities.mjs +0 -82
  114. package/lib/services/allocate-inventory-order.service.mjs +0 -310
  115. package/lib/services/base-order.service.mjs +0 -76
  116. package/lib/services/batch.service.mjs +0 -272
  117. package/lib/services/consumption-order.service.mjs +0 -504
  118. package/lib/services/helper.service.mjs +0 -28
  119. package/lib/services/hold-inventory-order.service.mjs +0 -296
  120. package/lib/services/inventory-count-order.service.mjs +0 -648
  121. package/lib/services/loader.service.mjs +0 -291
  122. package/lib/services/location.service.mjs +0 -139
  123. package/lib/services/material.service.mjs +0 -181
  124. package/lib/services/merge-batch-order.service.mjs +0 -206
  125. package/lib/services/order-reference.service.mjs +0 -136
  126. package/lib/services/quality-inspection-order.service.mjs +0 -146
  127. package/lib/services/receive-inventory-order.service.mjs +0 -468
  128. package/lib/services/reclassify-inventory-order.service.mjs +0 -192
  129. package/lib/services/sale-order.service.mjs +0 -20
  130. package/lib/services/scrape.service.mjs +0 -150
  131. package/lib/services/ship-inventory-order.service.mjs +0 -610
  132. package/lib/services/split-batch-order.service.mjs +0 -191
  133. package/lib/services/stock.service.mjs +0 -559
  134. package/lib/services/transfer-customer-order.service.mjs +0 -290
  135. package/lib/services/transfer-order.service.mjs +0 -641
  136. package/lib/services/transfer-vendor-order.service.mjs +0 -290
  137. package/lib/services/unit.service.mjs +0 -76
  138. package/lib/services/warehouse-map.service.mjs +0 -50
  139. package/lib/typings/core-module-options.mjs +0 -3
  140. package/lib/typings/find-receive-inventory-order.input.mjs +0 -9
  141. package/lib/typings/find-ship-inventory-order.input.mjs +0 -9
@@ -1,610 +0,0 @@
1
- import { __decorate, __param, __metadata } from 'tslib';
2
- import { Injectable, Inject } from '@nestjs/common';
3
- import { ShipInventoryOrderEntity } from '../models/extensions/ship-inventory-order/ship-inventory-order.entity.mjs';
4
- import { ShipInventoryOrderItemEntity } from '../models/extensions/ship-inventory-order/ship-inventory-order-item.entity.mjs';
5
- import { DataSource, IsNull, In } from 'typeorm';
6
- import { ShipInventoryOrderStatus } from '../typings/find-ship-inventory-order.input.mjs';
7
- import '../models/metadata/batch.entity.mjs';
8
- import '../models/metadata/batch-group.entity.mjs';
9
- import '../models/metadata/loader.entity.mjs';
10
- import '../models/metadata/loader-type.entity.mjs';
11
- import '../models/metadata/loader-unit.entity.mjs';
12
- import '../models/metadata/location.entity.mjs';
13
- import '../models/metadata/material.entity.mjs';
14
- import '../models/metadata/material-unit.entity.mjs';
15
- import '@rytass/wms-base-nestjs-module';
16
- import { SaleOrderEntity } from '../models/metadata/sale-order.entity.mjs';
17
- import '../models/metadata/stock.entity.mjs';
18
- import '../models/metadata/unit.entity.mjs';
19
- import { WmsEntities } from '../models/wms-entities.mjs';
20
- import '../models/extensions/receive-inventory-order/receive-inventory-order-item.entity.mjs';
21
- import '../models/extensions/receive-inventory-order/receive-inventory-order.entity.mjs';
22
- import '../models/extensions/receive-inventory-order/receive-inventory-order-change.entity.mjs';
23
- import { ShipInventoryOrderReferenceEntity } from '../models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.mjs';
24
- import { ShipInventoryOrderChangeEntityClass } from '../models/extensions/ship-inventory-order/ship-inventory-order-change.entity.mjs';
25
- import '../models/extensions/transfer-order/transfer-order.entity.mjs';
26
- import '../models/extensions/transfer-order/transfer-order-item.entity.mjs';
27
- import '../models/extensions/transfer-order/transfer-order-change.entity.mjs';
28
- import '../models/extensions/hold-inventory-order/hold-inventory-order.entity.mjs';
29
- import '../models/extensions/hold-inventory-order/hold-inventory-order-item.entity.mjs';
30
- import '../models/extensions/hold-inventory-order/hold-inventory-order-change.entity.mjs';
31
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order.entity.mjs';
32
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.mjs';
33
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.mjs';
34
- import '../models/extensions/split-batch-order/split-batch-order.entity.mjs';
35
- import '../models/extensions/split-batch-order/split-batch-order-item.entity.mjs';
36
- import '../models/extensions/split-batch-order/split-batch-order-change.entity.mjs';
37
- import '../models/extensions/merge-batch-order/merge-batch-order.entity.mjs';
38
- import '../models/extensions/merge-batch-order/merge-batch-order-item.entity.mjs';
39
- import '../models/extensions/merge-batch-order/merge-batch-order-change.entity.mjs';
40
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.mjs';
41
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.mjs';
42
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.mjs';
43
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order.entity.mjs';
44
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.mjs';
45
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.mjs';
46
- import '../models/extensions/quality-inspection-order/quality-inspection-order.entity.mjs';
47
- import '../models/extensions/quality-inspection-order/quality-inspection-order-item.entity.mjs';
48
- import '../models/extensions/quality-inspection-order/quality-inspection-order-change.entity.mjs';
49
- import '../models/extensions/transfer-customer-order/transfer-customer-order.entity.mjs';
50
- import '../models/extensions/transfer-customer-order/transfer-customer-order-item.entity.mjs';
51
- import '../models/extensions/transfer-customer-order/transfer-customer-order-change.entity.mjs';
52
- import '../models/extensions/scrape-order/scrape-order.entity.mjs';
53
- import '../models/extensions/scrape-order/scrape-order-item.entity.mjs';
54
- import '../models/extensions/scrape-order/scrape-order-change.entity.mjs';
55
- import '../models/extensions/inventory-count-order/inventory-count-order.entity.mjs';
56
- import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.mjs';
57
- import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.mjs';
58
- import '../models/extensions/consumption-order/consumption-order.entity.mjs';
59
- import '../models/extensions/consumption-order/consumption-order-item.entity.mjs';
60
- import '../models/extensions/consumption-order/consumption-order-change.entity.mjs';
61
- import '../models/extensions/order-reference/order-reference.entity.mjs';
62
- import { MaterialService } from './material.service.mjs';
63
- import { BatchService } from './batch.service.mjs';
64
- import { StockService } from './stock.service.mjs';
65
-
66
- /**
67
- * Service for managing ship inventory orders and their items
68
- * Supports dynamic entity injection for customization
69
- * T - Ship Inventory Order entity type
70
- * K - Ship Inventory Order Item entity type
71
- */
72
- let ShipInventoryOrderService = class ShipInventoryOrderService {
73
- dataSource;
74
- entities;
75
- materialService;
76
- batchService;
77
- stockService;
78
- shipInventoryOrderEntity;
79
- shipInventoryOrderItemEntity;
80
- shipInventoryOrderReferenceEntity;
81
- saleOrderEntity;
82
- selectQueryBuilder;
83
- constructor(dataSource, entities, materialService, batchService, stockService, shipInventoryOrderEntity, shipInventoryOrderItemEntity, shipInventoryOrderReferenceEntity, saleOrderEntity) {
84
- this.dataSource = dataSource;
85
- this.entities = entities;
86
- this.materialService = materialService;
87
- this.batchService = batchService;
88
- this.stockService = stockService;
89
- this.shipInventoryOrderEntity = shipInventoryOrderEntity;
90
- this.shipInventoryOrderItemEntity = shipInventoryOrderItemEntity;
91
- this.shipInventoryOrderReferenceEntity = shipInventoryOrderReferenceEntity;
92
- this.saleOrderEntity = saleOrderEntity;
93
- this.selectQueryBuilder = (alias) => {
94
- return this.dataSource
95
- .getRepository(this.shipInventoryOrderEntity)
96
- .createQueryBuilder(alias)
97
- .leftJoin((subQuery) => subQuery
98
- .select(`CASE
99
- WHEN o."removedAt" IS NOT NULL THEN '${ShipInventoryOrderStatus.REMOVED}'
100
- WHEN COALESCE(change_sums.shippedsum, 0) >= COALESCE(target_sum.targetsum, 0) AND COALESCE(target_sum.targetsum, 0) > 0 THEN '${ShipInventoryOrderStatus.SHIPPED}'
101
- WHEN COALESCE(change_sums.shippedsum, 0) > 0 AND COALESCE(change_sums.shippedsum, 0) < COALESCE(target_sum.targetsum, 0) THEN '${ShipInventoryOrderStatus.PARTIAL_SHIPPED}'
102
- ELSE '${ShipInventoryOrderStatus.PENDING}'
103
- END`, 'status')
104
- .addSelect('o.id', 'orderid')
105
- .from('ship_inventory_orders', 'o')
106
- .leftJoin((sumQuery) => sumQuery
107
- .select('i."orderId"', 'orderid')
108
- .addSelect(`SUM(CAST(i."targetShippedQuantity" AS NUMERIC))`, 'targetsum')
109
- .from('ship_inventory_order_items', 'i')
110
- .groupBy('i."orderId"'), 'target_sum', 'target_sum.orderid = o.id')
111
- .leftJoin((sumQuery) => sumQuery
112
- .select('i."orderId"', 'orderid')
113
- .addSelect(`SUM(CASE WHEN CAST(c."quantityChanged" AS NUMERIC) < 0 THEN ABS(CAST(c."quantityChanged" AS NUMERIC)) ELSE 0 END)`, 'shippedsum')
114
- .from('ship_inventory_order_changes', 'c')
115
- .innerJoin('ship_inventory_order_items', 'i', 'c."itemId" = i.id')
116
- .groupBy('i."orderId"'), 'change_sums', 'change_sums.orderid = o.id'), 'order_status', `${alias}.id = order_status.orderid`)
117
- .select('orders.id', 'id')
118
- .addSelect('orders.key', 'key')
119
- .addSelect('orders.description', 'description')
120
- .addSelect('orders."createdBy"', 'createdBy')
121
- .addSelect('orders."createdAt"', 'createdAt')
122
- .addSelect('orders."removedAt"', 'removedAt')
123
- .addSelect('order_status.status', `status`);
124
- };
125
- }
126
- processShipInventoryOrderReferences(references, manager) {
127
- const materialRepository = manager.getRepository(this.materialService.materialEntity);
128
- const saleOrderRepository = manager.getRepository(this.saleOrderEntity);
129
- return references.reduce(async (accPromise, reference) => {
130
- const acc = await accPromise;
131
- try {
132
- const material = await materialRepository.findOneBy({
133
- key: reference.materialKey,
134
- });
135
- if (!material)
136
- return acc;
137
- if (reference.saleId && reference.saleSerialId)
138
- await saleOrderRepository.save(saleOrderRepository.create({
139
- id: reference.saleId,
140
- serialId: reference.saleSerialId,
141
- }));
142
- return [
143
- ...acc,
144
- {
145
- ...reference,
146
- materialId: material.id,
147
- },
148
- ];
149
- }
150
- catch {
151
- return acc;
152
- }
153
- }, Promise.resolve([]));
154
- }
155
- async processShipInventoryOrderItems(items, manager) {
156
- const shipInventoryOrderItemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
157
- const shipInventoryOrderChangeRepository = manager.getRepository(ShipInventoryOrderChangeEntityClass);
158
- const orderRepository = manager.getRepository(this.entities.order);
159
- const stockRepository = manager.getRepository(this.entities.stock);
160
- await Promise.all(items.map(async (data) => {
161
- // Ensure required fields are present
162
- if (!data.batchId || !data.materialId)
163
- return;
164
- // Split batch first with inShipment flag to track shipment state
165
- const splittedBatch = await this.batchService.splitBatch({
166
- id: data.batchId,
167
- inShipment: true,
168
- manager,
169
- });
170
- // Save item with ORIGINAL batch id to maintain source state
171
- const item = await shipInventoryOrderItemRepository.save(shipInventoryOrderItemRepository.create(data));
172
- const base = await orderRepository.save(orderRepository.create());
173
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
174
- await shipInventoryOrderChangeRepository.save(shipInventoryOrderChangeRepository.create({
175
- itemId: item.id,
176
- id: base.id,
177
- quantityChanged: item.targetShippedQuantity * conversionFactor,
178
- }));
179
- // Stock movements track the shipment through splitted batch
180
- await this.stockService.validateStockAvailability({
181
- materialId: item.materialId,
182
- batchId: item.batchId,
183
- locationId: this.stockService.resolveLocationId(item.locationId),
184
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
185
- quantity: item.targetShippedQuantity * conversionFactor,
186
- }, manager);
187
- await stockRepository.save(stockRepository.create([
188
- // deduct from original batch available stock
189
- {
190
- orderId: base.id,
191
- materialId: item.materialId,
192
- batchId: item.batchId, // original batch
193
- locationId: this.stockService.resolveLocationId(item.locationId),
194
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
195
- quantity: -1 * item.targetShippedQuantity * conversionFactor,
196
- },
197
- // add to splitted batch in shipment state
198
- {
199
- orderId: base.id,
200
- materialId: item.materialId,
201
- batchId: splittedBatch.id, // splitted batch marked inShipment
202
- locationId: this.stockService.resolveLocationId(item.locationId),
203
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
204
- quantity: item.targetShippedQuantity * conversionFactor,
205
- },
206
- ]));
207
- }));
208
- }
209
- async createShipInventoryOrder({ manager = this.dataSource.manager, ...options }) {
210
- const orderRepository = manager.getRepository(this.entities.order);
211
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
212
- const shipInventoryOrderReferenceRepository = manager.getRepository(this.shipInventoryOrderReferenceEntity);
213
- // create base order
214
- const { id } = await orderRepository.save(orderRepository.create());
215
- // create ship inventory order
216
- const order = await shipInventoryOrderRepository.save(shipInventoryOrderRepository.create({ id, ...options }));
217
- // create ship inventory order references
218
- if (options.references && options.references.length > 0) {
219
- const processedReferences = await this.processShipInventoryOrderReferences(options.references, manager);
220
- if (processedReferences.length > 0) {
221
- const references = shipInventoryOrderReferenceRepository.create(processedReferences.map((reference) => ({
222
- ...reference,
223
- orderId: order.id,
224
- })));
225
- await shipInventoryOrderReferenceRepository.save(references);
226
- }
227
- }
228
- return order;
229
- }
230
- /**
231
- * Update a ship inventory order and its items
232
- * update existing item when id is provided, otherwise create new item, remove behaviour controlled by removedAt field
233
- */
234
- async updateShipInventoryOrder({ id, manager = this.dataSource.manager, ...options }) {
235
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
236
- const shipInventoryOrderReferenceRepository = manager.getRepository(this.shipInventoryOrderReferenceEntity);
237
- const shipInventoryOrderItemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
238
- const materialRepository = manager.getRepository(this.materialService.materialEntity);
239
- const order = await shipInventoryOrderRepository.findOneByOrFail({
240
- id,
241
- removedAt: IsNull(),
242
- });
243
- const { references, items, ...orderOptions } = options;
244
- const updated = await shipInventoryOrderRepository.save(shipInventoryOrderRepository.create({
245
- ...order,
246
- ...orderOptions,
247
- }));
248
- if (references?.length) {
249
- const newItems = [];
250
- const existingItems = [];
251
- const items = await shipInventoryOrderReferenceRepository.find({
252
- where: { orderId: id, removedAt: IsNull() },
253
- });
254
- const itemSet = new Set(items.map((i) => i.id));
255
- const results = await Promise.all((references || []).map(async (item) => {
256
- let batch = null;
257
- if (item.batchKey) {
258
- const material = await materialRepository.findOneByOrFail({
259
- key: item.materialKey,
260
- });
261
- batch = await this.batchService.getBatch({
262
- manager,
263
- materialId: material.id,
264
- key: item.batchKey,
265
- });
266
- }
267
- return { item, batch };
268
- }));
269
- // Now process results after all async operations are complete
270
- results.forEach((result) => {
271
- if (!result)
272
- return;
273
- const { item, batch } = result;
274
- if (!item.id)
275
- newItems.push({ ...item, batchId: batch?.id || null });
276
- else if (itemSet.has(item.id))
277
- existingItems.push({ ...item, batchId: batch?.id || null });
278
- });
279
- if (newItems.length) {
280
- const processedNewItems = await this.processShipInventoryOrderReferences(newItems, manager);
281
- if (processedNewItems.length > 0) {
282
- await shipInventoryOrderReferenceRepository.save(shipInventoryOrderReferenceRepository.create(processedNewItems.map((item) => ({ ...item, orderId: id }))));
283
- }
284
- }
285
- if (existingItems.length)
286
- await shipInventoryOrderReferenceRepository.save(existingItems.map((item) => shipInventoryOrderReferenceRepository.create({
287
- ...item,
288
- id: item.id,
289
- })));
290
- }
291
- if (items?.length) {
292
- const newItems = [];
293
- const existingItems = [];
294
- await shipInventoryOrderItemRepository
295
- .find({ where: { orderId: id, removedAt: IsNull() } })
296
- .then((dbItems) => {
297
- const itemSet = new Set(dbItems.map((i) => i.id));
298
- items?.forEach((item) => {
299
- if (!item.id)
300
- newItems.push({ ...item, orderId: id });
301
- else if (itemSet.has(item.id))
302
- existingItems.push(item);
303
- });
304
- });
305
- if (newItems.length)
306
- await this.processShipInventoryOrderItems(newItems, manager);
307
- if (existingItems.length)
308
- await shipInventoryOrderItemRepository.save(existingItems.map((item) => shipInventoryOrderItemRepository.create({
309
- ...item,
310
- id: item.id,
311
- })));
312
- }
313
- return updated;
314
- }
315
- /**
316
- * Remove a ship inventory order
317
- * Automatically cancels all remaining prepared (but not shipped) items to release stock
318
- */
319
- async removeShipInventoryOrder(id) {
320
- return this.dataSource.transaction(async (manager) => {
321
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
322
- const itemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
323
- // Find order
324
- const order = await shipInventoryOrderRepository.findOne({
325
- where: { id },
326
- });
327
- if (!order || order.removedAt)
328
- return false;
329
- // Find all items with changes to calculate cancellable quantities
330
- const items = await itemRepository.find({
331
- where: { orderId: id },
332
- relations: { changes: true },
333
- });
334
- // Build cancel inputs for items with remaining prepared quantity
335
- const cancelInputs = [];
336
- for (const item of items) {
337
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
338
- const preparedQuantity = item.changes.reduce((sum, change) => {
339
- const qty = Number(change.quantityChanged);
340
- return qty > 0 ? sum + qty : sum;
341
- }, 0);
342
- const shippedQuantity = item.changes.reduce((sum, change) => {
343
- const qty = Number(change.quantityChanged);
344
- return qty < 0 ? sum + Math.abs(qty) : sum;
345
- }, 0);
346
- const cancellableQuantity = preparedQuantity - shippedQuantity;
347
- if (cancellableQuantity > 0) {
348
- // Use base quantity (without conversion) since cancelShip will apply conversion
349
- cancelInputs.push({
350
- itemId: item.id,
351
- quantity: cancellableQuantity / conversionFactor,
352
- });
353
- }
354
- }
355
- // Cancel all remaining prepared items
356
- if (cancelInputs.length > 0) {
357
- await this.cancelShipInternal(cancelInputs, manager);
358
- }
359
- // Mark order as removed
360
- await shipInventoryOrderRepository.update({ id }, { removedAt: new Date() });
361
- return true;
362
- });
363
- }
364
- /**
365
- * Internal cancel method that accepts a manager for transaction support
366
- */
367
- async cancelShipInternal(options, manager) {
368
- const changeRepository = manager.getRepository(ShipInventoryOrderChangeEntityClass);
369
- const itemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
370
- const orderRepository = manager.getRepository(this.entities.order);
371
- const stockRepository = manager.getRepository(this.entities.stock);
372
- const items = await itemRepository.find({
373
- where: { id: In(options.map((o) => o.itemId)) },
374
- relations: { changes: true },
375
- });
376
- const itemMap = new Map(items.map((item) => [item.id, item]));
377
- await Promise.all(options.map(async (option) => {
378
- const item = itemMap.get(option.itemId);
379
- if (!item)
380
- return;
381
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
382
- const preparedQuantity = item.changes.reduce((sum, change) => {
383
- const qty = Number(change.quantityChanged);
384
- return qty > 0 ? sum + qty : sum;
385
- }, 0);
386
- const shippedQuantity = item.changes.reduce((sum, change) => {
387
- const qty = Number(change.quantityChanged);
388
- return qty < 0 ? sum + Math.abs(qty) : sum;
389
- }, 0);
390
- const cancellableQuantity = preparedQuantity - shippedQuantity;
391
- const cancelQuantity = option.quantity != null
392
- ? option.quantity * conversionFactor
393
- : cancellableQuantity;
394
- if (cancellableQuantity - cancelQuantity < 0) {
395
- throw new Error(`Cancel quantity exceeds prepared quantity for item ${option.itemId}`);
396
- }
397
- if (cancelQuantity <= 0)
398
- return;
399
- const inShipmentBatch = await this.batchService.splitBatch({
400
- id: item.batchId,
401
- inShipment: true,
402
- manager,
403
- });
404
- const reverseOrder = await orderRepository.save(orderRepository.create());
405
- await this.stockService.validateStockAvailability({
406
- materialId: item.materialId,
407
- batchId: inShipmentBatch.id,
408
- locationId: this.stockService.resolveLocationId(item.locationId),
409
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
410
- quantity: cancelQuantity,
411
- }, manager);
412
- await Promise.all([
413
- changeRepository.save(changeRepository.create({
414
- itemId: option.itemId,
415
- id: reverseOrder.id,
416
- quantityChanged: -1 * cancelQuantity,
417
- })),
418
- stockRepository.save(stockRepository.create([
419
- {
420
- orderId: reverseOrder.id,
421
- materialId: item.materialId,
422
- batchId: item.batchId,
423
- locationId: this.stockService.resolveLocationId(item.locationId),
424
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
425
- quantity: cancelQuantity,
426
- },
427
- {
428
- orderId: reverseOrder.id,
429
- materialId: item.materialId,
430
- batchId: inShipmentBatch.id,
431
- locationId: this.stockService.resolveLocationId(item.locationId),
432
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
433
- quantity: -1 * cancelQuantity,
434
- },
435
- ])),
436
- ]);
437
- }));
438
- }
439
- async findMany(options) {
440
- const queryBuilder = this.selectQueryBuilder('orders');
441
- if (options.id)
442
- queryBuilder.andWhere('orders.id = :id', { id: options.id });
443
- if (options.createdBy)
444
- queryBuilder.andWhere('orders."createdBy" ILIKE :createdBy', {
445
- createdBy: `%${options.createdBy}%`,
446
- });
447
- if (options.description)
448
- queryBuilder.andWhere('orders.description ILIKE :description', {
449
- description: `%${options.description}%`,
450
- });
451
- if (options.dateRange)
452
- queryBuilder.andWhere('orders."createdAt" BETWEEN :from AND :to', {
453
- from: options.dateRange.from,
454
- to: options.dateRange.to,
455
- });
456
- if (options.status)
457
- queryBuilder.andWhere(`status = :status`, {
458
- status: options.status,
459
- });
460
- if (options.statuses && options.statuses.length > 0)
461
- queryBuilder.andWhere(`status IN (:...statuses)`, {
462
- statuses: options.statuses,
463
- });
464
- if (options.materialKey)
465
- queryBuilder.andWhere(`EXISTS (
466
- SELECT 1 FROM ship_inventory_order_items si_items
467
- INNER JOIN materials si_mat ON si_mat.id = si_items."materialId"
468
- WHERE si_items."orderId" = orders.id
469
- AND si_mat.key ILIKE :materialKey
470
- )`, { materialKey: `%${options.materialKey}%` });
471
- if (options.batchKey)
472
- queryBuilder.andWhere(`EXISTS (
473
- SELECT 1 FROM ship_inventory_order_items si_items
474
- INNER JOIN batches si_batch ON si_batch.id = si_items."batchId"
475
- WHERE si_items."orderId" = orders.id
476
- AND si_batch.key ILIKE :batchKey
477
- )`, { batchKey: `%${options.batchKey}%` });
478
- if (options.locationKey)
479
- queryBuilder.andWhere(`EXISTS (
480
- SELECT 1 FROM ship_inventory_order_items si_items
481
- INNER JOIN locations si_loc ON si_loc.id = si_items."locationId"
482
- WHERE si_items."orderId" = orders.id
483
- AND si_loc.key ILIKE :locationKey
484
- )`, { locationKey: `%${options.locationKey}%` });
485
- if (options.loaderKey)
486
- queryBuilder.andWhere(`EXISTS (
487
- SELECT 1 FROM ship_inventory_order_items si_items
488
- INNER JOIN loaders si_ldr ON si_ldr.id = si_items."loaderId"
489
- WHERE si_items."orderId" = orders.id
490
- AND si_ldr."serialId" ILIKE :loaderKey
491
- )`, { loaderKey: `%${options.loaderKey}%` });
492
- if (options.wildcard) {
493
- const { key, value } = options.wildcard;
494
- queryBuilder.andWhere(`orders."${String(key)}" ILIKE :value`, {
495
- value: `%${value}%`,
496
- });
497
- }
498
- const total = await queryBuilder.getCount();
499
- if (options.offset !== undefined && options.offset >= 0)
500
- queryBuilder.skip(options.offset);
501
- if (options.limit !== undefined && options.limit > 0)
502
- queryBuilder.take(options.limit);
503
- const items = await queryBuilder.getRawMany();
504
- return [items, total];
505
- }
506
- async addShipInventoryOrderItems(options, manager = this.dataSource.manager) {
507
- const shipInventoryOrderRepository = manager.getRepository(this.shipInventoryOrderEntity);
508
- const order = await shipInventoryOrderRepository.findOneByOrFail({
509
- id: options.orderId,
510
- removedAt: IsNull(),
511
- });
512
- if (options.items.length) {
513
- const items = options.items.map((item) => ({
514
- ...item,
515
- orderId: options.orderId,
516
- }));
517
- await this.processShipInventoryOrderItems(items, manager);
518
- }
519
- return order;
520
- }
521
- ship(options) {
522
- if (!Array.isArray(options))
523
- options = [options];
524
- return this.dataSource.transaction(async (manager) => {
525
- const changeRepository = manager.getRepository(ShipInventoryOrderChangeEntityClass);
526
- const itemRepository = manager.getRepository(this.shipInventoryOrderItemEntity);
527
- const orderRepository = manager.getRepository(this.entities.order);
528
- const stockRepository = manager.getRepository(this.entities.stock);
529
- const items = await itemRepository.find({
530
- where: { id: In(options.map((option) => option.itemId)) },
531
- relations: { changes: true },
532
- });
533
- const itemMap = new Map(items.map((item) => [item.id, item]));
534
- await Promise.all(options.map(async (option) => {
535
- const item = itemMap.get(option.itemId);
536
- if (!item)
537
- return;
538
- const conversionFactor = await this.materialService.getConversionFactor(item.materialId, item.unitId || undefined);
539
- const totalShipped = item.changes.reduce((sum, change) => {
540
- const qty = Number(change.quantityChanged);
541
- return qty < 0 ? sum + Math.abs(qty) : sum;
542
- }, 0);
543
- const remainingQuantity = conversionFactor * item.targetShippedQuantity - totalShipped;
544
- if (remainingQuantity - option.quantity * conversionFactor < 0) {
545
- throw new Error(`Shipping quantity exceeds target for item ${option.itemId}`);
546
- }
547
- // Create splitted batch for ship completion
548
- const shippedBatch = await this.batchService.splitBatch({
549
- id: item.batchId,
550
- inShipment: true,
551
- manager,
552
- });
553
- const newOrder = await orderRepository.save(orderRepository.create());
554
- await this.stockService.validateStockAvailability({
555
- materialId: item.materialId,
556
- batchId: item.batchId,
557
- locationId: this.stockService.resolveLocationId(item.locationId),
558
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
559
- quantity: option.quantity * conversionFactor,
560
- }, manager);
561
- await Promise.all([
562
- changeRepository.save(changeRepository.create({
563
- itemId: option.itemId,
564
- quantityChanged: -1 * option.quantity * conversionFactor,
565
- id: newOrder.id,
566
- })),
567
- stockRepository.save(stockRepository.create([
568
- {
569
- batchId: shippedBatch.id,
570
- materialId: item.materialId,
571
- locationId: this.stockService.resolveLocationId(item.locationId),
572
- loaderId: this.stockService.resolveLoaderId(item.loaderId),
573
- quantity: -1 * option.quantity * conversionFactor,
574
- orderId: newOrder.id,
575
- },
576
- ])),
577
- ]);
578
- }));
579
- return true;
580
- });
581
- }
582
- /**
583
- * Cancel prepared ship inventory order items
584
- * Reverses the prepare step by moving stock from IN_SHIPMENT back to FREE
585
- * Can only cancel prepared quantity that hasn't been shipped yet
586
- * If quantity is not provided, cancels all remaining cancellable quantity
587
- */
588
- cancelShip(options) {
589
- if (!Array.isArray(options))
590
- options = [options];
591
- return this.dataSource.transaction(async (manager) => {
592
- await this.cancelShipInternal(options, manager);
593
- return true;
594
- });
595
- }
596
- };
597
- ShipInventoryOrderService = __decorate([
598
- Injectable(),
599
- __param(5, Inject(ShipInventoryOrderEntity)),
600
- __param(6, Inject(ShipInventoryOrderItemEntity)),
601
- __param(7, Inject(ShipInventoryOrderReferenceEntity)),
602
- __param(8, Inject(SaleOrderEntity)),
603
- __metadata("design:paramtypes", [DataSource,
604
- WmsEntities,
605
- MaterialService,
606
- BatchService,
607
- StockService, Object, Object, Object, Object])
608
- ], ShipInventoryOrderService);
609
-
610
- export { ShipInventoryOrderService };