@rytass/wms-module-core 0.9.1 → 0.10.1

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 +2462 -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,191 +0,0 @@
1
- import { __decorate, __param, __metadata } from 'tslib';
2
- import { Injectable, Inject } from '@nestjs/common';
3
- import '../models/metadata/batch.entity.mjs';
4
- import '../models/metadata/batch-group.entity.mjs';
5
- import '../models/metadata/loader.entity.mjs';
6
- import '../models/metadata/loader-type.entity.mjs';
7
- import '../models/metadata/loader-unit.entity.mjs';
8
- import '../models/metadata/location.entity.mjs';
9
- import '../models/metadata/material.entity.mjs';
10
- import '../models/metadata/material-unit.entity.mjs';
11
- import '@rytass/wms-base-nestjs-module';
12
- import '../models/metadata/sale-order.entity.mjs';
13
- import '../models/metadata/stock.entity.mjs';
14
- import '../models/metadata/unit.entity.mjs';
15
- import { WmsEntities } from '../models/wms-entities.mjs';
16
- import '../models/extensions/receive-inventory-order/receive-inventory-order-item.entity.mjs';
17
- import '../models/extensions/receive-inventory-order/receive-inventory-order.entity.mjs';
18
- import '../models/extensions/receive-inventory-order/receive-inventory-order-change.entity.mjs';
19
- import '../models/extensions/ship-inventory-order/ship-inventory-order-item.entity.mjs';
20
- import '../models/extensions/ship-inventory-order/ship-inventory-order.entity.mjs';
21
- import '../models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.mjs';
22
- import '../models/extensions/ship-inventory-order/ship-inventory-order-change.entity.mjs';
23
- import '../models/extensions/transfer-order/transfer-order.entity.mjs';
24
- import '../models/extensions/transfer-order/transfer-order-item.entity.mjs';
25
- import '../models/extensions/transfer-order/transfer-order-change.entity.mjs';
26
- import '../models/extensions/hold-inventory-order/hold-inventory-order.entity.mjs';
27
- import '../models/extensions/hold-inventory-order/hold-inventory-order-item.entity.mjs';
28
- import '../models/extensions/hold-inventory-order/hold-inventory-order-change.entity.mjs';
29
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order.entity.mjs';
30
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.mjs';
31
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.mjs';
32
- import { SplitBatchOrderEntity } from '../models/extensions/split-batch-order/split-batch-order.entity.mjs';
33
- import { SplitBatchOrderItemEntity } from '../models/extensions/split-batch-order/split-batch-order-item.entity.mjs';
34
- import { SplitBatchOrderChangeEntityClass } from '../models/extensions/split-batch-order/split-batch-order-change.entity.mjs';
35
- import '../models/extensions/merge-batch-order/merge-batch-order.entity.mjs';
36
- import '../models/extensions/merge-batch-order/merge-batch-order-item.entity.mjs';
37
- import '../models/extensions/merge-batch-order/merge-batch-order-change.entity.mjs';
38
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.mjs';
39
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.mjs';
40
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.mjs';
41
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order.entity.mjs';
42
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.mjs';
43
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.mjs';
44
- import '../models/extensions/quality-inspection-order/quality-inspection-order.entity.mjs';
45
- import '../models/extensions/quality-inspection-order/quality-inspection-order-item.entity.mjs';
46
- import '../models/extensions/quality-inspection-order/quality-inspection-order-change.entity.mjs';
47
- import '../models/extensions/transfer-customer-order/transfer-customer-order.entity.mjs';
48
- import '../models/extensions/transfer-customer-order/transfer-customer-order-item.entity.mjs';
49
- import '../models/extensions/transfer-customer-order/transfer-customer-order-change.entity.mjs';
50
- import '../models/extensions/scrape-order/scrape-order.entity.mjs';
51
- import '../models/extensions/scrape-order/scrape-order-item.entity.mjs';
52
- import '../models/extensions/scrape-order/scrape-order-change.entity.mjs';
53
- import '../models/extensions/inventory-count-order/inventory-count-order.entity.mjs';
54
- import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.mjs';
55
- import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.mjs';
56
- import '../models/extensions/consumption-order/consumption-order.entity.mjs';
57
- import '../models/extensions/consumption-order/consumption-order-item.entity.mjs';
58
- import '../models/extensions/consumption-order/consumption-order-change.entity.mjs';
59
- import '../models/extensions/order-reference/order-reference.entity.mjs';
60
- import { DataSource } from 'typeorm';
61
- import { MaterialService } from './material.service.mjs';
62
- import { BatchService } from './batch.service.mjs';
63
- import { HelperService } from './helper.service.mjs';
64
- import { StockService } from './stock.service.mjs';
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 };