@rytass/wms-module-core 0.5.0 → 0.7.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 (51) hide show
  1. package/README.md +44 -2
  2. package/docs/api-reference.md +37 -1
  3. package/docs/integration-guide.md +18 -17
  4. package/index.cjs.js +1160 -5
  5. package/index.js +7 -0
  6. package/lib/constants/index.d.ts +2 -0
  7. package/lib/constants/inventory-count-status.d.ts +19 -0
  8. package/lib/constants/inventory-count-status.js +22 -0
  9. package/lib/constants/operations.d.ts +34 -0
  10. package/lib/constants/operations.js +67 -0
  11. package/lib/constants/stock-status.d.ts +2 -0
  12. package/lib/constants/stock-status.js +4 -0
  13. package/lib/core.module.js +9 -1
  14. package/lib/events/index.d.ts +1 -0
  15. package/lib/events/inventory-count-lock.subscriber.d.ts +38 -0
  16. package/lib/events/inventory-count-lock.subscriber.js +98 -0
  17. package/lib/events/stock-change.subscriber.js +6 -0
  18. package/lib/events/wms-event.types.d.ts +2 -2
  19. package/lib/models/extensions/index.d.ts +3 -0
  20. package/lib/models/extensions/inventory-count-order/inventory-count-order-change.entity.d.ts +20 -0
  21. package/lib/models/extensions/inventory-count-order/inventory-count-order-change.entity.js +50 -0
  22. package/lib/models/extensions/inventory-count-order/inventory-count-order-item.entity.d.ts +48 -0
  23. package/lib/models/extensions/inventory-count-order/inventory-count-order-item.entity.js +175 -0
  24. package/lib/models/extensions/inventory-count-order/inventory-count-order.entity.d.ts +50 -0
  25. package/lib/models/extensions/inventory-count-order/inventory-count-order.entity.js +155 -0
  26. package/lib/models/models.module.js +7 -0
  27. package/lib/services/allocate-inventory-order.service.js +3 -0
  28. package/lib/services/batch.service.js +3 -0
  29. package/lib/services/hold-inventory-order.service.js +3 -0
  30. package/lib/services/index.d.ts +1 -0
  31. package/lib/services/inventory-count-order.service.d.ts +174 -0
  32. package/lib/services/inventory-count-order.service.js +641 -0
  33. package/lib/services/loader.service.js +3 -0
  34. package/lib/services/location.service.js +3 -0
  35. package/lib/services/material.service.js +3 -0
  36. package/lib/services/merge-batch-order.service.js +3 -0
  37. package/lib/services/quality-inspection-order.service.js +3 -0
  38. package/lib/services/receive-inventory-order.service.js +3 -0
  39. package/lib/services/reclassify-inventory-order.service.js +3 -0
  40. package/lib/services/scrape.service.js +3 -0
  41. package/lib/services/ship-inventory-order.service.js +3 -0
  42. package/lib/services/split-batch-order.service.js +3 -0
  43. package/lib/services/stock.service.js +27 -0
  44. package/lib/services/transfer-customer-order.service.js +3 -0
  45. package/lib/services/transfer-order.service.js +3 -0
  46. package/lib/services/transfer-vendor-order.service.js +3 -0
  47. package/lib/services/unit.service.js +3 -0
  48. package/lib/services/warehouse-map.service.d.ts +11 -1
  49. package/lib/services/warehouse-map.service.js +13 -4
  50. package/lib/typings/find-stock.input.d.ts +16 -0
  51. package/package.json +5 -5
@@ -50,6 +50,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
50
50
  import '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource, In } from 'typeorm';
54
57
  import { MaterialService } from './material.service.js';
55
58
  import { BatchService } from './batch.service.js';
@@ -50,6 +50,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
50
50
  import '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource } from 'typeorm';
54
57
  import { BatchService } from './batch.service.js';
55
58
  import { MaterialService } from './material.service.js';
@@ -52,6 +52,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
52
52
  import '../models/extensions/scrape-order/scrape-order.entity.js';
53
53
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
54
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';
55
58
  import { MaterialService } from './material.service.js';
56
59
  import { BatchService } from './batch.service.js';
57
60
  import { HelperService } from './helper.service.js';
@@ -50,6 +50,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
50
50
  import '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource } from 'typeorm';
54
57
  import { MaterialService } from './material.service.js';
55
58
  import { BatchService } from './batch.service.js';
@@ -50,6 +50,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
50
50
  import { ScrapeOrderEntity } from '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import { ScrapeOrderItemEntityClass } from '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import { ScrapeOrderChangeEntityClass } from '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource } from 'typeorm';
54
57
  import { HelperService } from './helper.service.js';
55
58
  import { MaterialService } from './material.service.js';
@@ -52,6 +52,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
52
52
  import '../models/extensions/scrape-order/scrape-order.entity.js';
53
53
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
54
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';
55
58
  import { MaterialService } from './material.service.js';
56
59
  import { BatchService } from './batch.service.js';
57
60
  import { StockService } from './stock.service.js';
@@ -50,6 +50,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
50
50
  import '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource } from 'typeorm';
54
57
  import { MaterialService } from './material.service.js';
55
58
  import { BatchService } from './batch.service.js';
@@ -52,6 +52,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
52
52
  import '../models/extensions/scrape-order/scrape-order.entity.js';
53
53
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
54
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';
55
58
  import { WMS_CORE_MODULE_OPTIONS } from '../typings/core-module-options.js';
56
59
 
57
60
  let StockService = class StockService {
@@ -260,6 +263,30 @@ let StockService = class StockService {
260
263
  queryBuilder.innerJoin(LoadersEntityClass, 'lk', 'lk.id = stock."loaderId" AND lk."serialId" ILIKE :loaderKey', {
261
264
  loaderKey: `%${options.loaderKey}%`,
262
265
  });
266
+ /*
267
+ * Vendor / customer / sale order live on the batch, so they need their own
268
+ * join. One join for all four rather than four joins: they are conditions on
269
+ * the same row, and repeating the join would multiply nothing but the plan.
270
+ *
271
+ * Exact match, not ILIKE: these are identifiers handed over by the host
272
+ * system, and a partial match on 「SO-1」 quietly sweeping in 「SO-10」 is the
273
+ * kind of wrong answer nobody notices. It also keeps this in step with the
274
+ * inventory count sheet, whose four filters match the same way.
275
+ */
276
+ const batchAttributeFilters = [
277
+ ['vendorId', options.vendorId],
278
+ ['customerId', options.customerId],
279
+ ['saleId', options.saleId],
280
+ ['saleSerialId', options.saleSerialId],
281
+ ].filter(([, value]) => Boolean(value));
282
+ if (batchAttributeFilters.length) {
283
+ queryBuilder.innerJoin(this.entities.batch, 'ba', 'ba.id = stock."batchId"');
284
+ for (const [column, value] of batchAttributeFilters) {
285
+ queryBuilder.andWhere(`ba."${column}" = :${column}`, {
286
+ [column]: value,
287
+ });
288
+ }
289
+ }
263
290
  if (options.offset !== undefined && options.offset >= 0)
264
291
  queryBuilder.skip(options.offset);
265
292
  if (options.limit !== undefined && options.limit > 0)
@@ -50,6 +50,9 @@ import { TransferCustomerOrderChangeEntityClass } from '../models/extensions/tra
50
50
  import '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource, Not, IsNull } from 'typeorm';
54
57
  import { HelperService } from './helper.service.js';
55
58
  import { MaterialService } from './material.service.js';
@@ -50,6 +50,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
50
50
  import '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource, In } from 'typeorm';
54
57
  import { StockStatus } from '../constants/stock-status.js';
55
58
  import { HelperService } from './helper.service.js';
@@ -50,6 +50,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
50
50
  import '../models/extensions/scrape-order/scrape-order.entity.js';
51
51
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
53
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
53
56
  import { DataSource, Not, IsNull } from 'typeorm';
54
57
  import { HelperService } from './helper.service.js';
55
58
  import { MaterialService } from './material.service.js';
@@ -51,6 +51,9 @@ import '../models/extensions/transfer-customer-order/transfer-customer-order-cha
51
51
  import '../models/extensions/scrape-order/scrape-order.entity.js';
52
52
  import '../models/extensions/scrape-order/scrape-order-item.entity.js';
53
53
  import '../models/extensions/scrape-order/scrape-order-change.entity.js';
54
+ import '../models/extensions/inventory-count-order/inventory-count-order.entity.js';
55
+ import '../models/extensions/inventory-count-order/inventory-count-order-item.entity.js';
56
+ import '../models/extensions/inventory-count-order/inventory-count-order-change.entity.js';
54
57
 
55
58
  let UnitService = class UnitService {
56
59
  dataSource;
@@ -8,5 +8,15 @@ export declare class WarehouseMapDataService implements OnApplicationBootstrap {
8
8
  readonly defaultMapDataKey = "DEFAULT_MAP_DATA_KEY";
9
9
  readonly warehouseMapDataRepository: Repository<WarehouseMapEntity>;
10
10
  constructor(dataSource: DataSource, entities: WmsEntities);
11
- onApplicationBootstrap(): void;
11
+ /**
12
+ * Seed the default map row.
13
+ *
14
+ * `async` on purpose: Nest awaits a returned promise, so bootstrap does not
15
+ * complete until the seed transaction has committed. Firing it off without
16
+ * awaiting used to leave a transaction in flight after `app.init()` resolved
17
+ * — an app that shut down promptly (a test, a short-lived worker) destroyed
18
+ * the pool underneath it and the rejection surfaced as an unhandled
19
+ * `QueryFailedError: Connection terminated` that killed the process.
20
+ */
21
+ onApplicationBootstrap(): Promise<void>;
12
22
  }
@@ -11,11 +11,20 @@ let WarehouseMapDataService = class WarehouseMapDataService {
11
11
  constructor(dataSource, entities) {
12
12
  this.dataSource = dataSource;
13
13
  this.entities = entities;
14
- this.warehouseMapDataRepository =
15
- this.dataSource.getRepository(this.entities.warehouseMap);
14
+ this.warehouseMapDataRepository = this.dataSource.getRepository(this.entities.warehouseMap);
16
15
  }
17
- onApplicationBootstrap() {
18
- this.dataSource.transaction(async (manager) => {
16
+ /**
17
+ * Seed the default map row.
18
+ *
19
+ * `async` on purpose: Nest awaits a returned promise, so bootstrap does not
20
+ * complete until the seed transaction has committed. Firing it off without
21
+ * awaiting used to leave a transaction in flight after `app.init()` resolved
22
+ * — an app that shut down promptly (a test, a short-lived worker) destroyed
23
+ * the pool underneath it and the rejection surfaced as an unhandled
24
+ * `QueryFailedError: Connection terminated` that killed the process.
25
+ */
26
+ async onApplicationBootstrap() {
27
+ await this.dataSource.transaction(async (manager) => {
19
28
  const defaultMapData = await manager
20
29
  .getRepository(this.entities.warehouseMap)
21
30
  .findOneBy({ id: this.defaultMapDataKey });
@@ -18,4 +18,20 @@ export type FindStockInput<U extends object> = PaginationInput & {
18
18
  batchKey?: string;
19
19
  locationKey?: string;
20
20
  loaderKey?: string;
21
+ /**
22
+ * Commercial attributes of the stock's batch.
23
+ *
24
+ * They live on the batch table, not on stock, which is why they need their own
25
+ * join rather than a plain `andWhere` — the same four columns the aggregated
26
+ * projection already selects (`vendorId` / `customerId` / `saleId` /
27
+ * `saleSerialId`), so filtering and displaying stay in step.
28
+ *
29
+ * `null` is accepted and treated as "not filtering": the aggregated-stock
30
+ * lookups pass a whole `AggregatedStock` through here, and those columns are
31
+ * nullable on the batch.
32
+ */
33
+ vendorId?: string | null;
34
+ customerId?: string | null;
35
+ saleId?: string | null;
36
+ saleSerialId?: string | null;
21
37
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rytass/wms-module-core",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "Rytass WMS Module — NestJS services and TypeORM entities for warehouse management",
5
5
  "keywords": [
6
6
  "rytass",
@@ -41,13 +41,13 @@
41
41
  "access": "public"
42
42
  },
43
43
  "dependencies": {
44
- "@rytass/wms-base-nestjs-module": "0.4.0"
44
+ "luxon": "^3.0.0"
45
45
  },
46
46
  "peerDependencies": {
47
- "@nestjs/common": "^11.0.0",
48
- "@nestjs/typeorm": "^11.0.0",
47
+ "@nestjs/common": "^10.0.0 || ^11.0.0",
48
+ "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
49
+ "@rytass/wms-base-nestjs-module": "^0.4.0",
49
50
  "reflect-metadata": "^0.1.13 || ^0.2.0",
50
- "rxjs": "^7.8.0",
51
51
  "typeorm": "^0.3.0"
52
52
  }
53
53
  }