@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,559 +0,0 @@
1
- import { __decorate, __param, __metadata } from 'tslib';
2
- import { Injectable, Inject } from '@nestjs/common';
3
- import { StockEntity } from '../models/metadata/stock.entity.js';
4
- import { DataSource } from 'typeorm';
5
- import { MaterialEntity } from '../models/metadata/material.entity.js';
6
- import { StockStatus, ChangeType } from '../constants/stock-status.js';
7
- import '../models/metadata/batch.entity.js';
8
- import '../models/metadata/batch-group.entity.js';
9
- import { LoadersEntityClass } from '../models/metadata/loader.entity.js';
10
- import { LoaderTypeEntityClass } from '../models/metadata/loader-type.entity.js';
11
- import '../models/metadata/loader-unit.entity.js';
12
- import '../models/metadata/location.entity.js';
13
- import '../models/metadata/material-unit.entity.js';
14
- import '@rytass/wms-base-nestjs-module';
15
- import '../models/metadata/sale-order.entity.js';
16
- import '../models/metadata/unit.entity.js';
17
- import { WmsEntities } from '../models/wms-entities.js';
18
- import '../models/extensions/receive-inventory-order/receive-inventory-order-item.entity.js';
19
- import '../models/extensions/receive-inventory-order/receive-inventory-order.entity.js';
20
- import '../models/extensions/receive-inventory-order/receive-inventory-order-change.entity.js';
21
- import '../models/extensions/ship-inventory-order/ship-inventory-order-item.entity.js';
22
- import '../models/extensions/ship-inventory-order/ship-inventory-order.entity.js';
23
- import '../models/extensions/ship-inventory-order/ship-inventory-order-reference.entity.js';
24
- import '../models/extensions/ship-inventory-order/ship-inventory-order-change.entity.js';
25
- import '../models/extensions/transfer-order/transfer-order.entity.js';
26
- import '../models/extensions/transfer-order/transfer-order-item.entity.js';
27
- import '../models/extensions/transfer-order/transfer-order-change.entity.js';
28
- import '../models/extensions/hold-inventory-order/hold-inventory-order.entity.js';
29
- import '../models/extensions/hold-inventory-order/hold-inventory-order-item.entity.js';
30
- import '../models/extensions/hold-inventory-order/hold-inventory-order-change.entity.js';
31
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order.entity.js';
32
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-item.entity.js';
33
- import '../models/extensions/allocate-inventory-order/allocate-inventory-order-change.entity.js';
34
- import '../models/extensions/split-batch-order/split-batch-order.entity.js';
35
- import '../models/extensions/split-batch-order/split-batch-order-item.entity.js';
36
- import '../models/extensions/split-batch-order/split-batch-order-change.entity.js';
37
- import '../models/extensions/merge-batch-order/merge-batch-order.entity.js';
38
- import '../models/extensions/merge-batch-order/merge-batch-order-item.entity.js';
39
- import '../models/extensions/merge-batch-order/merge-batch-order-change.entity.js';
40
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order.entity.js';
41
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-item.entity.js';
42
- import '../models/extensions/reclassify-inventory-order/reclassify-inventory-order-change.entity.js';
43
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order.entity.js';
44
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-item.entity.js';
45
- import '../models/extensions/transfer-vendor-order/transfer-vendor-order-change.entity.js';
46
- import '../models/extensions/quality-inspection-order/quality-inspection-order.entity.js';
47
- import '../models/extensions/quality-inspection-order/quality-inspection-order-item.entity.js';
48
- import '../models/extensions/quality-inspection-order/quality-inspection-order-change.entity.js';
49
- import '../models/extensions/transfer-customer-order/transfer-customer-order.entity.js';
50
- import '../models/extensions/transfer-customer-order/transfer-customer-order-item.entity.js';
51
- import '../models/extensions/transfer-customer-order/transfer-customer-order-change.entity.js';
52
- import '../models/extensions/scrape-order/scrape-order.entity.js';
53
- import '../models/extensions/scrape-order/scrape-order-item.entity.js';
54
- import '../models/extensions/scrape-order/scrape-order-change.entity.js';
55
- import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
56
- import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
57
- import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
58
- import '../models/extensions/consumption-order/consumption-order.entity.js';
59
- import '../models/extensions/consumption-order/consumption-order-item.entity.js';
60
- import '../models/extensions/consumption-order/consumption-order-change.entity.js';
61
- import '../models/extensions/order-reference/order-reference.entity.js';
62
- import { WMS_CORE_MODULE_OPTIONS } from '../typings/core-module-options.js';
63
-
64
- let StockService = class StockService {
65
- dataSource;
66
- entities;
67
- stockEntity;
68
- materialEntity;
69
- coreOptions;
70
- defaultLoaderId;
71
- defaultLocationId;
72
- stockRepository;
73
- selectQueryBuilder;
74
- aggregateKeys = ['materialId', 'batchId', 'locationId', 'loaderId', 'status'];
75
- generatedAggregateKey = (aggregated) => {
76
- return this.aggregateKeys.map((key) => aggregated[key]).join('|');
77
- };
78
- destructAggregateKey = (key) => {
79
- const [materialId, batchId, locationId, loaderId, status] = key.split('|');
80
- return {
81
- materialId,
82
- batchId,
83
- locationId,
84
- loaderId,
85
- status: status,
86
- };
87
- };
88
- constructor(dataSource, entities, stockEntity, materialEntity, coreOptions) {
89
- this.dataSource = dataSource;
90
- this.entities = entities;
91
- this.stockEntity = stockEntity;
92
- this.materialEntity = materialEntity;
93
- this.coreOptions = coreOptions;
94
- this.stockRepository = this.dataSource.getRepository(this.stockEntity);
95
- // select builder for status and quantity calculation, calculated field will override fields in stock entity.
96
- // every query should use this selectQueryBuilder to ensure status and quantity are correct
97
- // status is resolved from batch flags: inShipment → IN_SHIPMENT, held → HELD, inTransfer → IN_TRANSFER, else → FREE
98
- this.selectQueryBuilder = (alias, qb = this.dataSource
99
- .getRepository(this.stockEntity)
100
- .createQueryBuilder(alias)) => qb
101
- .leftJoin((subQuery) => subQuery
102
- .select(`CASE
103
- WHEN b."inShipment" = true THEN '${StockStatus.IN_SHIPMENT}'
104
- WHEN b."held" = true THEN '${StockStatus.HELD}'
105
- WHEN b."transferId" IS NOT NULL THEN '${StockStatus.IN_TRANSFER}'
106
- ELSE '${StockStatus.FREE}'
107
- END`, 'status')
108
- .addSelect('s.id', 'stockId')
109
- .addSelect('b."transferId"', 'transferId')
110
- .addSelect('b."held"', 'held')
111
- .addSelect('b."inShipment"', 'inShipment')
112
- .addSelect('b."inspectionResult"', 'inspectionResult')
113
- .addSelect('b."requiresInspection"', 'requiresInspection')
114
- .addSelect('b."saleId"', 'saleId')
115
- .addSelect('b."vendorId"', 'vendorId')
116
- .addSelect('b."customerId"', 'customerId')
117
- .from('stocks', 's')
118
- .innerJoin('batches', 'b', 's."batchId" = b.id'), 'stock_status', `stock_status."stockId" = ${alias}.id`)
119
- .addSelect('stock_status.status', 'status')
120
- .addSelect('stock_status."transferId"', 'transferId')
121
- .addSelect('stock_status.held', 'held')
122
- .addSelect('stock_status."inShipment"', 'inShipment')
123
- .addSelect('stock_status."inspectionResult"', 'inspectionResult')
124
- .addSelect('stock_status."requiresInspection"', 'requiresInspection')
125
- .addSelect('stock_status."saleId"', 'saleId')
126
- .addSelect('stock_status."vendorId"', 'vendorId')
127
- .addSelect('stock_status."customerId"', 'customerId')
128
- .addSelect(`${alias}.*`);
129
- }
130
- async onModuleInit() {
131
- const loaderTypeRepo = this.dataSource.getRepository(LoaderTypeEntityClass);
132
- const locationRepo = this.dataSource.getRepository(this.entities.location);
133
- const loaderRepo = this.dataSource.getRepository(LoadersEntityClass);
134
- // Ensure default loader type exists
135
- let loaderType = await loaderTypeRepo.findOneBy({
136
- key: this.coreOptions.defaultLoaderTypeKey,
137
- });
138
- if (!loaderType) {
139
- loaderType = await loaderTypeRepo.save(loaderTypeRepo.create({
140
- key: this.coreOptions.defaultLoaderTypeKey,
141
- description: this.coreOptions.defaultLoaderTypeKey,
142
- }));
143
- }
144
- // Ensure default location exists
145
- let location = await locationRepo.findOneBy({
146
- key: this.coreOptions.defaultLocationKey,
147
- });
148
- if (!location) {
149
- location = await locationRepo.save(locationRepo.create({
150
- key: this.coreOptions.defaultLocationKey,
151
- description: this.coreOptions.defaultLocationKey,
152
- }));
153
- }
154
- this.defaultLocationId = location.id;
155
- // Ensure default loader exists
156
- let loader = await loaderRepo.findOneBy({
157
- serialId: this.coreOptions.defaultLoaderSerialId,
158
- });
159
- if (!loader) {
160
- loader = await loaderRepo.save(loaderRepo.create({
161
- serialId: this.coreOptions.defaultLoaderSerialId,
162
- typeId: loaderType.id,
163
- locationId: location.id,
164
- }));
165
- }
166
- this.defaultLoaderId = loader.id;
167
- }
168
- resolveLoaderId(loaderId) {
169
- return loaderId || this.defaultLoaderId;
170
- }
171
- resolveLocationId(locationId) {
172
- return locationId || this.defaultLocationId;
173
- }
174
- pipeSelectOptionsToQueryBuilder(options, queryBuilder, aggregated = false) {
175
- if (options.materialId)
176
- queryBuilder.andWhere('stock."materialId" = :materialId', {
177
- materialId: options.materialId,
178
- });
179
- if (options.batchId)
180
- queryBuilder.andWhere('stock."batchId" = :batchId', {
181
- batchId: options.batchId,
182
- });
183
- if (options.locationId)
184
- queryBuilder.andWhere('stock."locationId" = :locationId', {
185
- locationId: options.locationId,
186
- });
187
- if (options.excludeLocationIds?.length)
188
- queryBuilder.andWhere('stock."locationId" NOT IN (:...excludeLocationIds)', { excludeLocationIds: options.excludeLocationIds });
189
- if (options.loaderId)
190
- queryBuilder.andWhere('stock."loaderId" = :loaderId', {
191
- loaderId: options.loaderId,
192
- });
193
- if (options.description)
194
- queryBuilder.andWhere('stock."description" ILIKE :description', {
195
- description: `%${options.description}%`,
196
- });
197
- if (options.wildcard) {
198
- const { key, value } = options.wildcard;
199
- queryBuilder.andWhere(`location."${String(key)}" ILIKE :value`, {
200
- value: `%${value}%`,
201
- });
202
- }
203
- if (options.status) {
204
- switch (options.status) {
205
- case StockStatus.PENDING_INSPECTION:
206
- /*
207
- * Both halves are required. `inspectionResult IS NULL` alone is the
208
- * resting state of every batch nobody ever asked to inspect, so on
209
- * its own it reported the whole warehouse as awaiting inspection --
210
- * a wrong answer that looked plausible because it was never zero.
211
- */
212
- queryBuilder.andWhere('stock_status."requiresInspection" = true AND stock_status."inspectionResult" IS NULL');
213
- break;
214
- case StockStatus.INSPECTION_FAILED:
215
- queryBuilder.andWhere('stock_status."inspectionResult" = false');
216
- break;
217
- case StockStatus.ALLOCATED:
218
- queryBuilder.andWhere('stock_status."saleId" IS NOT NULL');
219
- break;
220
- case StockStatus.VENDOR_INVENTORY:
221
- queryBuilder.andWhere('stock_status."vendorId" IS NOT NULL');
222
- break;
223
- case StockStatus.CUSTOMER_INVENTORY:
224
- queryBuilder.andWhere('stock_status."customerId" IS NOT NULL');
225
- break;
226
- default:
227
- queryBuilder.andWhere('stock_status.status = :status', {
228
- status: options.status,
229
- });
230
- break;
231
- }
232
- }
233
- if (options.negateStatus) {
234
- switch (options.negateStatus) {
235
- case StockStatus.PENDING_INSPECTION:
236
- queryBuilder.andWhere('NOT (stock_status."requiresInspection" = true AND stock_status."inspectionResult" IS NULL)');
237
- break;
238
- case StockStatus.INSPECTION_FAILED:
239
- queryBuilder.andWhere('(stock_status."inspectionResult" IS NULL OR stock_status."inspectionResult" != false)');
240
- break;
241
- case StockStatus.ALLOCATED:
242
- queryBuilder.andWhere('stock_status."saleId" IS NULL');
243
- break;
244
- case StockStatus.VENDOR_INVENTORY:
245
- queryBuilder.andWhere('stock_status."vendorId" IS NULL');
246
- break;
247
- case StockStatus.CUSTOMER_INVENTORY:
248
- queryBuilder.andWhere('stock_status."customerId" IS NULL');
249
- break;
250
- default:
251
- queryBuilder.andWhere('stock_status.status != :negateStatus', {
252
- negateStatus: options.negateStatus,
253
- });
254
- break;
255
- }
256
- }
257
- if (options.materialKey)
258
- queryBuilder.innerJoin(
259
- // The configured entity, not the built-in class: this follows whatever
260
- // table that entity is mapped to. (TypeORM resolves an entity in a
261
- // hand-written join to its table name and does not append the
262
- // single-table discriminator, so for a child of `MaterialEntityClass` the
263
- // emitted SQL is unchanged — this keeps the service from reaching past
264
- // its own configuration, it is not a behaviour fix on its own.)
265
- this.materialEntity, 'mk', 'mk.id = stock."materialId" AND mk.key ILIKE :materialKey', {
266
- materialKey: `%${options.materialKey}%`,
267
- });
268
- if (options.batchKey)
269
- queryBuilder.innerJoin(this.entities.batch, 'bk', 'bk.id = stock."batchId" AND bk.key ILIKE :batchKey', {
270
- batchKey: `%${options.batchKey}%`,
271
- });
272
- if (options.locationKey)
273
- queryBuilder.innerJoin(this.entities.location, 'lk', 'lk.id = stock."locationId" AND lk.key ILIKE :locationKey', {
274
- locationKey: `%${options.locationKey}%`,
275
- });
276
- if (options.loaderKey)
277
- queryBuilder.innerJoin(LoadersEntityClass, 'lk', 'lk.id = stock."loaderId" AND lk."serialId" ILIKE :loaderKey', {
278
- loaderKey: `%${options.loaderKey}%`,
279
- });
280
- /*
281
- * Vendor / customer / sale order live on the batch, so they need their own
282
- * join. One join for all four rather than four joins: they are conditions on
283
- * the same row, and repeating the join would multiply nothing but the plan.
284
- *
285
- * Exact match, not ILIKE: these are identifiers handed over by the host
286
- * system, and a partial match on 「SO-1」 quietly sweeping in 「SO-10」 is the
287
- * kind of wrong answer nobody notices. It also keeps this in step with the
288
- * inventory count sheet, whose four filters match the same way.
289
- */
290
- const batchAttributeFilters = [
291
- ['vendorId', options.vendorId],
292
- ['customerId', options.customerId],
293
- ['saleId', options.saleId],
294
- ['saleSerialId', options.saleSerialId],
295
- ].filter(([, value]) => Boolean(value));
296
- if (batchAttributeFilters.length) {
297
- queryBuilder.innerJoin(this.entities.batch, 'ba', 'ba.id = stock."batchId"');
298
- for (const [column, value] of batchAttributeFilters) {
299
- queryBuilder.andWhere(`ba."${column}" = :${column}`, {
300
- [column]: value,
301
- });
302
- }
303
- }
304
- if (options.offset !== undefined && options.offset >= 0)
305
- queryBuilder.skip(options.offset);
306
- if (options.limit !== undefined && options.limit > 0)
307
- queryBuilder.take(options.limit);
308
- if (aggregated) {
309
- queryBuilder.innerJoin('batches', 'b', 'stock."batchId" = b.id');
310
- queryBuilder.select('stock."materialId"', 'materialId');
311
- queryBuilder.addSelect('stock."batchId"', 'batchId');
312
- queryBuilder.addSelect('stock."locationId"', 'locationId');
313
- queryBuilder.addSelect('stock."loaderId"', 'loaderId');
314
- queryBuilder.addSelect('stock_status.status', 'status');
315
- queryBuilder.addSelect('stock_status."transferId"', 'transferId');
316
- queryBuilder.addSelect('stock_status."held"', 'held');
317
- queryBuilder.addSelect('stock_status."inShipment"', 'inShipment');
318
- queryBuilder.addSelect('b."saleId"', 'saleId');
319
- queryBuilder.addSelect('b."saleSerialId"', 'saleSerialId');
320
- queryBuilder.addSelect('b."customerId"', 'customerId');
321
- queryBuilder.addSelect('b."vendorId"', 'vendorId');
322
- queryBuilder.addSelect('b."inspectionResult"', 'inspectionResult');
323
- queryBuilder.addSelect('b."requiresInspection"', 'requiresInspection');
324
- /*
325
- * Lineage and the host's own attributes, carried along the same way the
326
- * commercial attributes above are. Both are functionally dependent on
327
- * `batchId`, which is already a grouping key, but SQL still wants them
328
- * named in GROUP BY. `attributes` is jsonb, which groups fine — jsonb has
329
- * equality and a btree opclass.
330
- */
331
- queryBuilder.addSelect('b."parentBatchId"', 'parentBatchId');
332
- queryBuilder.addSelect('b."attributes"', 'attributes');
333
- queryBuilder.addSelect('SUM(stock.quantity)', 'quantity');
334
- queryBuilder.groupBy('stock."materialId"');
335
- queryBuilder.addGroupBy('stock."batchId"');
336
- queryBuilder.addGroupBy('stock."locationId"');
337
- queryBuilder.addGroupBy('stock."loaderId"');
338
- queryBuilder.addGroupBy('stock_status.status');
339
- queryBuilder.addGroupBy('stock_status."transferId"');
340
- queryBuilder.addGroupBy('stock_status."held"');
341
- queryBuilder.addGroupBy('stock_status."inShipment"');
342
- queryBuilder.addGroupBy('b."saleId"');
343
- queryBuilder.addGroupBy('b."saleSerialId"');
344
- queryBuilder.addGroupBy('b."customerId"');
345
- queryBuilder.addGroupBy('b."vendorId"');
346
- queryBuilder.addGroupBy('b."inspectionResult"');
347
- queryBuilder.addGroupBy('b."requiresInspection"');
348
- queryBuilder.addGroupBy('b."parentBatchId"');
349
- queryBuilder.addGroupBy('b."attributes"');
350
- queryBuilder.having('SUM(stock.quantity) <> 0');
351
- if (options.aggregatedKeys?.length)
352
- queryBuilder.andHaving([
353
- 'stock."materialId"',
354
- 'stock."batchId"',
355
- 'stock."locationId"',
356
- 'stock."loaderId"',
357
- 'stock_status.status',
358
- ].join(" || '|' || ") + ' IN (:...aggregatedKeys)', {
359
- aggregatedKeys: options.aggregatedKeys,
360
- });
361
- }
362
- return queryBuilder;
363
- }
364
- findMany(options) {
365
- const queryBuilder = this.pipeSelectOptionsToQueryBuilder(options, this.selectQueryBuilder('stock'));
366
- return queryBuilder.getManyAndCount();
367
- }
368
- async findManyGroupedByMaterialId(options) {
369
- // Build aggregated subquery to get distinct materialIds where SUM(quantity) != 0
370
- const aggregateSubquery = this.pipeSelectOptionsToQueryBuilder({ ...options, offset: undefined, limit: undefined }, this.selectQueryBuilder('stock'), true);
371
- const rawMaterialIds = await this.dataSource
372
- .createQueryBuilder()
373
- .select('DISTINCT agg."materialId"', 'materialId')
374
- .from(`(${aggregateSubquery.getQuery()})`, 'agg')
375
- .setParameters(aggregateSubquery.getParameters())
376
- .getRawMany();
377
- const ids = rawMaterialIds.map((r) => r.materialId);
378
- if (ids.length === 0)
379
- return [[], 0];
380
- const queryBuilder = this.dataSource
381
- .getRepository(this.materialEntity)
382
- .createQueryBuilder('material')
383
- .where('material.id IN (:...materialIds)', { materialIds: ids });
384
- if (options.offset !== undefined && options.offset >= 0)
385
- queryBuilder.skip(options.offset);
386
- if (options.limit !== undefined && options.limit > 0)
387
- queryBuilder.take(options.limit);
388
- return queryBuilder.getManyAndCount();
389
- }
390
- async findAggregatedStock(options, manager = this.dataSource.manager) {
391
- const queryBuilder = this.pipeSelectOptionsToQueryBuilder(options, this.selectQueryBuilder('stock', manager.getRepository(this.stockEntity).createQueryBuilder('stock')), true);
392
- return queryBuilder.getRawOne();
393
- }
394
- async validateStockAvailability(params, manager = this.dataSource.manager) {
395
- const { materialId, batchId, locationId, loaderId, quantity } = params;
396
- const aggregateQuery = this.pipeSelectOptionsToQueryBuilder({ materialId, batchId, locationId, loaderId }, this.selectQueryBuilder('stock', manager.getRepository(this.stockEntity).createQueryBuilder('stock')), true);
397
- const result = await manager
398
- .createQueryBuilder()
399
- .select('COALESCE(SUM(agg.quantity), 0)', 'total')
400
- .from(`(${aggregateQuery.getQuery()})`, 'agg')
401
- .setParameters(aggregateQuery.getParameters())
402
- .getRawOne();
403
- const available = parseFloat(result?.total ?? '0');
404
- if (available < quantity) {
405
- throw new Error(`Insufficient stock: available ${available}, requested ${quantity} (materialId=${materialId}, batchId=${batchId}, loaderId=${loaderId})`);
406
- }
407
- }
408
- async findAggregatedStocks(options) {
409
- // Create the aggregated subquery without pagination
410
- const aggregateSubquery = this.pipeSelectOptionsToQueryBuilder({ ...options, offset: undefined, limit: undefined }, this.selectQueryBuilder('stock'),
411
- // Always aggregated. The outer projection below is hard-wired to the
412
- // aggregated shape (it selects agg."saleSerialId" and friends), so letting
413
- // the caller switch the inner subquery off asked the outer query for a
414
- // column the inner one never produced — a hard `column agg."saleSerialId"
415
- // does not exist`. There was never a working `false` here: this method
416
- // returns AggregatedStock[], so aggregating is its only meaning.
417
- true);
418
- // Wrap the aggregated subquery and apply pagination on top
419
- const paginatedQueryBuilder = this.dataSource
420
- .createQueryBuilder()
421
- .addSelect('agg.quantity', 'quantity')
422
- .from(`(${aggregateSubquery.getQuery()})`, 'agg')
423
- .setParameters(aggregateSubquery.getParameters());
424
- this.aggregateKeys.forEach((key) => paginatedQueryBuilder.addSelect(`agg."${key}"`, key));
425
- // Add batch-related fields
426
- paginatedQueryBuilder.addSelect('agg."transferId"', 'transferId');
427
- paginatedQueryBuilder.addSelect('agg."held"', 'held');
428
- paginatedQueryBuilder.addSelect('agg."inShipment"', 'inShipment');
429
- paginatedQueryBuilder.addSelect('agg."saleId"', 'saleId');
430
- paginatedQueryBuilder.addSelect('agg."saleSerialId"', 'saleSerialId');
431
- paginatedQueryBuilder.addSelect('agg."customerId"', 'customerId');
432
- paginatedQueryBuilder.addSelect('agg."vendorId"', 'vendorId');
433
- paginatedQueryBuilder.addSelect('agg."inspectionResult"', 'inspectionResult');
434
- paginatedQueryBuilder.addSelect('agg."requiresInspection"', 'requiresInspection');
435
- paginatedQueryBuilder.addSelect('agg."parentBatchId"', 'parentBatchId');
436
- paginatedQueryBuilder.addSelect('agg."attributes"', 'attributes');
437
- // Apply pagination to the outer query
438
- if (options.offset !== undefined && options.offset >= 0) {
439
- paginatedQueryBuilder.skip(options.offset);
440
- }
441
- if (options.limit !== undefined && options.limit > 0) {
442
- paginatedQueryBuilder.take(options.limit);
443
- }
444
- // Get total count from the aggregated subquery
445
- const countBuilder = this.pipeSelectOptionsToQueryBuilder({ ...options, offset: undefined, limit: undefined }, this.selectQueryBuilder('stock'),
446
- // Always aggregated. The outer projection below is hard-wired to the
447
- // aggregated shape (it selects agg."saleSerialId" and friends), so letting
448
- // the caller switch the inner subquery off asked the outer query for a
449
- // column the inner one never produced — a hard `column agg."saleSerialId"
450
- // does not exist`. There was never a working `false` here: this method
451
- // returns AggregatedStock[], so aggregating is its only meaning.
452
- true);
453
- const countResult = await this.dataSource
454
- .createQueryBuilder()
455
- .select('COUNT(*)', 'count')
456
- .from(`(${countBuilder.getQuery()})`, 'grouped')
457
- .setParameters(countBuilder.getParameters())
458
- .getRawOne();
459
- const count = parseInt(countResult?.count ?? '0', 10);
460
- const items = await paginatedQueryBuilder.getRawMany();
461
- return [items, count];
462
- }
463
- async findChangeLogs(options) {
464
- // Build base query with all change entity joins
465
- const changesQueryBuilder = this.pipeSelectOptionsToQueryBuilder({ ...options, offset: undefined, limit: undefined }, this.selectQueryBuilder('stock'), false)
466
- .leftJoin('receive_inventory_order_changes', 'receive_change', 'stock."orderId" = receive_change.id')
467
- .leftJoin('ship_inventory_order_changes', 'ship_change', 'stock."orderId" = ship_change.id')
468
- .leftJoin('transfer_order_changes', 'transfer_change', 'stock."orderId" = transfer_change.id')
469
- .leftJoin('transfer_vendor_order_changes', 'vendor_change', 'stock."orderId" = vendor_change.id')
470
- .leftJoin('transfer_customer_order_changes', 'customer_change', 'stock."orderId" = customer_change.id')
471
- .leftJoin('hold_inventory_order_changes', 'hold_change', 'stock."orderId" = hold_change.id')
472
- .leftJoin('split_batch_order_changes', 'split_change', 'stock."orderId" = split_change.id')
473
- .leftJoin('merge_batch_order_changes', 'merge_change', 'stock."orderId" = merge_change.id')
474
- .leftJoin('allocate_inventory_order_changes', 'allocate_change', 'stock."orderId" = allocate_change.id')
475
- .leftJoin('reclassify_inventory_order_changes', 'reclassify_change', 'stock."orderId" = reclassify_change.id')
476
- .leftJoin('scrape_order_changes', 'scrape_change', 'stock."orderId" = scrape_change.id')
477
- .andWhere(`(
478
- (receive_change.id IS NOT NULL AND receive_change."quantityChanged" * stock.quantity > 0)
479
- OR (ship_change.id IS NOT NULL AND ship_change."quantityChanged" * stock.quantity > 0)
480
- OR (transfer_change.id IS NOT NULL AND transfer_change."quantityChanged" * stock.quantity > 0)
481
- OR (vendor_change.id IS NOT NULL AND vendor_change."quantityChanged" * stock.quantity > 0)
482
- OR (customer_change.id IS NOT NULL AND customer_change."quantityChanged" * stock.quantity > 0)
483
- OR (hold_change.id IS NOT NULL AND hold_change."quantityChanged" * stock.quantity > 0)
484
- OR (split_change.id IS NOT NULL AND split_change."quantityChanged" * stock.quantity > 0)
485
- OR (merge_change.id IS NOT NULL AND merge_change."quantityChanged" * stock.quantity > 0)
486
- OR (allocate_change.id IS NOT NULL AND allocate_change."quantityChanged" * stock.quantity > 0)
487
- OR (reclassify_change.id IS NOT NULL AND reclassify_change."quantityChanged" * stock.quantity > 0)
488
- OR (scrape_change.id IS NOT NULL AND scrape_change."quantityChanged" * stock.quantity > 0)
489
- )`);
490
- // Get count from the filtered base query (before adding expensive CASE)
491
- const countQuerySimple = changesQueryBuilder
492
- .clone()
493
- .select('COUNT(DISTINCT stock.id)', 'count');
494
- const countResult = await this.dataSource
495
- .createQueryBuilder()
496
- .select('SUM(counted.count)', 'total')
497
- .from(`(${countQuerySimple.getQuery()})`, 'counted')
498
- .setParameters(countQuerySimple.getParameters())
499
- .getRawOne();
500
- const count = parseInt(countResult?.total ?? '0', 10);
501
- // Add changeType CASE only after we have the filtered result set, apply pagination
502
- const resultQueryBuilder = changesQueryBuilder.clone();
503
- if (options.offset !== undefined && options.offset >= 0) {
504
- resultQueryBuilder.skip(options.offset);
505
- }
506
- if (options.limit !== undefined && options.limit > 0) {
507
- resultQueryBuilder.take(options.limit);
508
- }
509
- // Explicitly select only the fields needed for ChangeLog
510
- resultQueryBuilder
511
- .select('stock.id', 'id')
512
- .addSelect('stock.quantity', 'quantity')
513
- .addSelect('stock_status.status', 'status')
514
- .addSelect('stock."materialId"', 'materialId')
515
- .addSelect('stock."batchId"', 'batchId')
516
- .addSelect('stock."locationId"', 'locationId')
517
- .addSelect('stock."loaderId"', 'loaderId')
518
- .addSelect(`CASE
519
- WHEN receive_change.id IS NOT NULL THEN '${ChangeType.RECEIVED}'
520
- WHEN ship_change.id IS NOT NULL THEN
521
- CASE WHEN ship_change."quantityChanged" > 0 THEN '${ChangeType.IN_SHIPMENT}'
522
- ELSE '${ChangeType.SHIPPED}' END
523
- WHEN transfer_change.id IS NOT NULL THEN
524
- CASE WHEN transfer_change."quantityChanged" > 0 THEN '${ChangeType.IN_TRANSFER}'
525
- ELSE '${ChangeType.TRANSFERRED}' END
526
- WHEN vendor_change.id IS NOT NULL THEN
527
- CASE WHEN vendor_change."quantityChanged" > 0 THEN '${ChangeType.VENDOR_TRANSFERRED}'
528
- ELSE '${ChangeType.VENDOR_RETURNED}' END
529
- WHEN customer_change.id IS NOT NULL THEN
530
- CASE WHEN customer_change."quantityChanged" > 0 THEN '${ChangeType.CUSTOMER_HELD}'
531
- ELSE '${ChangeType.CUSTOMER_RETURNED}' END
532
- WHEN hold_change.id IS NOT NULL THEN
533
- CASE WHEN hold_change."quantityChanged" > 0 THEN '${ChangeType.HELD}'
534
- ELSE '${ChangeType.RELEASED}' END
535
- WHEN split_change.id IS NOT NULL THEN '${ChangeType.SPLITTED}'
536
- WHEN merge_change.id IS NOT NULL THEN '${ChangeType.MERGED}'
537
- WHEN allocate_change.id IS NOT NULL THEN
538
- CASE WHEN allocate_change."quantityChanged" > 0 THEN '${ChangeType.ALLOCATED}'
539
- ELSE '${ChangeType.DEALLOCATED}' END
540
- WHEN reclassify_change.id IS NOT NULL THEN '${ChangeType.RECLASSIFIED}'
541
- WHEN scrape_change.id IS NOT NULL THEN '${ChangeType.SCRAPED}'
542
- ELSE NULL
543
- END`, 'changeType');
544
- const items = await resultQueryBuilder
545
- .addOrderBy('stock."createdAt"', 'DESC')
546
- .getRawMany();
547
- return [items, count];
548
- }
549
- };
550
- StockService = __decorate([
551
- Injectable(),
552
- __param(2, Inject(StockEntity)),
553
- __param(3, Inject(MaterialEntity)),
554
- __param(4, Inject(WMS_CORE_MODULE_OPTIONS)),
555
- __metadata("design:paramtypes", [DataSource,
556
- WmsEntities, Object, Function, Object])
557
- ], StockService);
558
-
559
- export { StockService };