@rytass/wms-module-graphql 0.9.0 → 0.10.1

package/README.md

@@ -9,7 +9,7 @@ Pair with [`@rytass/wms-module-core`](https://www.npmjs.com/package/@rytass/wms-
 ```bash
 yarn add @rytass/wms-module-graphql @rytass/wms-module-core
 # peer deps
-yarn add @nestjs/common @nestjs/graphql @nestjs/apollo @apollo/server graphql dataloader reflect-metadata rxjs
+yarn add @nestjs/common @nestjs/graphql @nestjs/apollo @apollo/server @as-integrations/express5 graphql reflect-metadata rxjs @rytass/wms-base-nestjs-module
 ```
 
 ## Quick start
@@ -151,7 +151,8 @@ Because the switches mutate process-global registration state, a process may reg
 ## Inventory counting
 
 Compare the ledger against what is physically on the shelf, then adjust the ledger to
-match. Eleven operations (`inventory-count-order:{read,create,update,start,count,add-item,remove-item,reset,cancel,settle}`)
+match. Twelve operations
+(`inventory-count-order:{read,read-items,create,update,start,count,add-item,remove-item,reset,cancel,settle}`)
 back the flow:
 
 ```
@@ -173,6 +174,13 @@ back the flow:
 - **`countDate` is the business date.** The variance is reported under the date the count
   was created for, not the day settlement happened to run. `createdAt` keeps the real
   wall-clock time.
+- **The sheet has its own query.** `inventoryCountOrderItems` paginates and filters the
+  lines (料號 / 物料說明 / 批號 / 儲位 / 載具 as ILIKE; 供應商 / 客戶 / 銷售訂單號碼 / 銷售訂單項次
+  exactly; plus `onlyVariance`). A field resolver cannot take a page or a filter, and a
+  count covering an aisle runs to thousands of lines.
+- **`startInventoryCount` snapshots eight attributes per line** — `held`, `inShipment`,
+  `inspectionResult`, `transferId`, `vendorId`, `customerId`, `saleId`, `saleSerialId` —
+  so the sheet keeps showing the world the variance is measured against, not today's.
 
 ### ⚠️ Starting a count locks its locations
 

package/adapters/event-emitter.cjs.js

@@ -0,0 +1,43 @@
+'use strict';
+
+var eventEmitter = require('@nestjs/event-emitter');
+var wmsModuleCore = require('@rytass/wms-module-core');
+
+/**
+ * Bridges WMS domain events onto `@nestjs/event-emitter`'s `EventEmitter2`, so
+ * consumers can subscribe with `@OnEvent('wms.<event-name>')` instead of (or in
+ * addition to) the typed `afterListeners`.
+ *
+ * Pass this into `WmsModuleGraphqlModule.forRootAsync({ eventEmitterBridge })`.
+ * Importing this module is the only place `@nestjs/event-emitter` is referenced,
+ * keeping it an entirely optional peer dependency — the core graphql module
+ * never imports it.
+ *
+ * Prerequisite: register `EventEmitterModule.forRoot()` in your app so an
+ * `EventEmitter2` instance is available for injection.
+ *
+ * @example
+ * ```ts
+ * import { wmsEventEmitterBridgeProvider } from '@rytass/wms-module-graphql/adapters/event-emitter';
+ *
+ * WmsModuleGraphqlModule.forRootAsync({
+ *   ...coreOptions,
+ *   eventEmitterBridge: wmsEventEmitterBridgeProvider,
+ * });
+ *
+ * // elsewhere
+ * @OnEvent('wms.stock.allocated')
+ * handle(payload: WmsStockEventPayload) { ... }
+ * ```
+ */
+const wmsEventEmitterBridgeProvider = {
+    provide: wmsModuleCore.WMS_EVENT_EMITTER_BRIDGE,
+    useFactory: (emitter) => ({
+        forward: (event) => {
+            emitter.emit(`wms.${event.name}`, event.payload);
+        },
+    }),
+    inject: [eventEmitter.EventEmitter2],
+};
+
+exports.wmsEventEmitterBridgeProvider = wmsEventEmitterBridgeProvider;

package/adapters/member-base.cjs.js

@@ -0,0 +1,66 @@
+'use strict';
+
+var graphql = require('@nestjs/graphql');
+
+const extractRequest = (context) => {
+    const gqlContext = graphql.GqlExecutionContext.create(context).getContext();
+    return gqlContext?.req;
+};
+/**
+ * Builds a {@link WmsAuthChecker} that authorizes WMS operations against
+ * `@rytass/member-base-nestjs-module`'s Casbin setup.
+ *
+ * It reuses everything the host's global `CasbinGuard` already prepared on the
+ * request — the verified `payload`, the `enforcer`, and even the consumer's
+ * (possibly customized) `casbinPermissionChecker`. WMS therefore enforces with
+ * the *exact same* policy engine and rules as the host's own resolvers, with no
+ * member-base import on the WMS side.
+ *
+ * Prerequisite: register `MemberBaseModule` with its global guard enabled
+ * (the default), and expose the request on the GraphQL context as `req`
+ * (Apollo's default).
+ */
+const createMemberBaseWmsAuthChecker = (options) => {
+    return async (context, requirement) => {
+        const request = extractRequest(context);
+        // No verified member → unauthenticated. CasbinGuard sets `payload` to
+        // undefined when the token is missing or invalid.
+        if (!request?.payload) {
+            return false;
+        }
+        // The enforcer / checker are injected by CasbinGuard. Their absence means
+        // the host did not enable the global guard — fail closed rather than
+        // silently allowing everything.
+        if (!request.enforcer || !request.casbinPermissionChecker) {
+            return false;
+        }
+        const actions = options.map(requirement);
+        if (actions.length === 0) {
+            return false;
+        }
+        return request.casbinPermissionChecker({
+            enforcer: request.enforcer,
+            payload: request.payload,
+            actions,
+        });
+    };
+};
+/**
+ * A {@link WmsActorExtractor} for `@rytass/member-base-nestjs-module`. Reads the
+ * verified JWT payload that `CasbinGuard` attaches to the request and surfaces it
+ * as the event/hook `actor`. Returns `null` for unauthenticated requests.
+ *
+ * Pass to `WmsModuleGraphqlModule.forRootAsync({ actorExtractor })` so every
+ * operation event and before-hook carries `{ id, domain }`. Imports nothing from
+ * member-base — it only reads the runtime request fields.
+ */
+const memberBaseActorExtractor = (context) => {
+    const payload = extractRequest(context)?.payload;
+    if (!payload?.id) {
+        return null;
+    }
+    return { id: payload.id, domain: payload.domain, raw: payload };
+};
+
+exports.createMemberBaseWmsAuthChecker = createMemberBaseWmsAuthChecker;
+exports.memberBaseActorExtractor = memberBaseActorExtractor;

package/docs/api-reference.md

@@ -74,7 +74,8 @@ static forRootAsync(
 **盤點單 (Inventory Count Order)**
 - `InventoryCountOrderEntity` / `InventoryCountOrderEntityClass` — 盤點單主檔（`countDate` 為盤差記帳基準日）
 - `InventoryCountOrderLocationEntity` / `InventoryCountOrderLocationEntityClass` — 盤點範圍，已展開至所有下層儲位（`isRoot` 標示使用者實際選的節點）
-- `InventoryCountOrderItemEntity` / `InventoryCountOrderItemEntityClass` — 盤點單身（`isAddition` 標示盤盈新增列）
+- `InventoryCountOrderItemEntity` / `InventoryCountOrderItemEntityClass` — 盤點單身（`isAddition` 標示盤盈新增列）。
+  開始盤點時另外快照 8 個當下屬性：`held`、`inShipment`、`inspectionResult`、`transferId`、`vendorId`、`customerId`、`saleId`、`saleSerialId`
 - `InventoryCountOrderChangeEntity` / `InventoryCountOrderChangeEntityClass` — 盤差異動（正=盤盈、負=盤虧）
 - 來源: `lib/models/extensions/inventory-count-order/`
 
@@ -178,7 +179,7 @@ static forRootAsync(
 | `MergeBatchOrderService<T>` | `merge` | 批號合併 | `lib/services/merge-batch-order.service.ts` |
 | `ReclassifyInventoryOrderService<T>` | `reclassify` | 庫存轉料號 | `lib/services/reclassify-inventory-order.service.ts` |
 | `ScrapeService<T>` | `scrape` | 庫存報廢 | `lib/services/scrape.service.ts` |
-| `InventoryCountOrderService<T>` | `findMany`, `findOne`, `create`, `update`, `start`, `count`, `addItem`, `removeItem`, `reset`, `cancel`, `settle` | 盤點單管理。`start` 會鎖定盤點範圍內的儲位，`settle` 是唯一會改動庫存的方法 | `lib/services/inventory-count-order.service.ts` |
+| `InventoryCountOrderService<T>` | `findMany`, `findOne`, `findItems`, `create`, `update`, `start`, `count`, `addItem`, `removeItem`, `reset`, `cancel`, `settle` | 盤點單管理。`start` 會鎖定盤點範圍內的儲位，`settle` 是唯一會改動庫存的方法。`findItems` 是單身的分頁查詢 | `lib/services/inventory-count-order.service.ts` |
 | `QualityInspectionOrderService<T>` | `inspect` | 品質檢驗 | `lib/services/quality-inspection-order.service.ts` |
 | `SaleOrderService` | （DataSource 直接操作） | 銷售訂單查詢 | `lib/services/sale-order.service.ts` |
 | `HelperService` | `getSeq` | 序號產生工具 | `lib/services/helper.service.ts` |
@@ -286,7 +287,7 @@ enum InventoryCountStatus { PENDING, COUNTING, COMPLETED, CANCELLED }
 
 ### `WmsOperationName` (type) / `WMS_OPERATION_NAMES` (const)
 ```ts
-type WmsOperationName = 'material:read' | 'material:create' | /* …58 項… */;
+type WmsOperationName = 'material:read' | 'material:create' | /* …59 項… */;
 const WMS_OPERATION_NAMES: readonly WmsOperationName[];
 ```
 本套件所有 root operation 的 `` `${resource}:${action}` `` 名稱。同一組字串有三個用途：
@@ -627,7 +628,7 @@ WmsModuleGraphqlModule.forRootAsync({
 | `MaterialQuery` | `material`, `materials` | `MaterialDto`, `Materials` | `lib/queries/material.query.ts` |
 | `StockQuery` | `stock`, `stocks`, `stocksGroupedByMaterial`, `aggregatedStocks`, `changeLogs` | `StockDto`, `Stocks`, `Materials`, `AggregatedStocks`, `ChangeLogs` | `lib/queries/stock.query.ts` |
 | `BatchQuery` | `batches` | `Batches` | `lib/queries/batch.query.ts` |
-| `InventoryCountOrderQuery` | `inventoryCountOrders`, `inventoryCountOrder` | `InventoryCountOrders`, `InventoryCountOrderDto` | `lib/queries/inventory-count-order.query.ts` |
+| `InventoryCountOrderQuery` | `inventoryCountOrders`, `inventoryCountOrder`, `inventoryCountOrderItems` | `InventoryCountOrders`, `InventoryCountOrderDto`, `InventoryCountOrderItems` | `lib/queries/inventory-count-order.query.ts` |
 | `LocationQuery` | `location`, `locations` | `LocationDto`, `Locations` | `lib/queries/location.query.ts` |
 | `ReceiveInventoryOrderQuery` | `receiveInventoryOrder`, `receiveInventoryOrders` | `ReceiveInventoryOrderDto`, `ReceiveInventoryOrders` | `lib/queries/recieve-inventory-order.query.ts` |
 | `ShipInventoryOrderQuery` | `shipInventoryOrder`, `shipInventoryOrders` | `ShipInventoryOrderDto`, `ShipInventoryOrders` | `lib/queries/ship-inventory-order.query.ts` |
@@ -735,6 +736,9 @@ WmsModuleGraphqlModule.forRootAsync({
 
 **庫存**
 - `FindStockArgs` (extends `PaginationArgs`) — 來源: `lib/inputs/find-stock.args.ts`
+  - `materialKey` / `batchKey` / `locationKey` / `loaderKey` 為 ILIKE 模糊比對。
+  - `vendorId` / `customerId` / `saleId` / `saleSerialId` 取自批號，為**完全比對**：它們是上游系統的識別碼，
+    模糊比對會讓 `SO-1` 撈到 `SO-10`。四支 stock query（`stocks`、`stocksGroupedByMaterial`、`aggregatedStocks`、`changeLogs`）皆適用。
 - `DateRangeArgs` (`@InputType`) — 來源: `lib/inputs/date-range.args.ts`
 
 **批號**

package/docs/integration-guide.md

@@ -348,23 +348,37 @@ The `DEFAULT` location/loader/loaderType returned by the second query was seeded
 
 ### 4.6 Version compatibility matrix
 
-Tested combinations as of 0.1.2:
-
-| Package                          | Tested version          | Notes                                                              |
-|----------------------------------|-------------------------|--------------------------------------------------------------------|
-| NestJS (`@nestjs/*`)             | 11.x                    | 10.x untested; some Express-5-related APIs differ                  |
-| `@nestjs/graphql`                | 13.x                    | Required for `@nestjs/apollo@13`                                   |
-| `@nestjs/apollo`                 | 13.0.x – 13.1.x         | 13.2+ requires @apollo/server@^5 which breaks lib's v4 plugin usage |
-| `@apollo/server`                 | 4.x                     | v5 is breaking; not supported                                      |
-| `@as-integrations/express5`      | 1.x                     | Required runtime peer                                              |
-| TypeORM                          | 0.3.x                   | 0.2.x not supported (different DataSource API)                     |
-| PostgreSQL                       | 14+                     | Native dialect                                                     |
-| `graphql`                        | 16.x                    | 15.x untested                                                      |
-| Node.js                          | 20 LTS or 22            | 18 deprecated, 24 untested                                         |
-| Next.js                          | 15.x Pages Router       | App Router unsupported (see §13.11)                                |
-| React                            | 19.x                    | 18.x likely works but untested                                     |
-| `@mezzanine-ui/react`            | 1.3.x                   | Earlier versions untested                                          |
-| `nuqs`                           | 2.x (Pages adapter)     | App Router adapter untested (see §13.11)                           |
+Two different questions, so two columns. **Accepted** is what the published
+`peerDependencies` allow — a version outside it fails to install. **Tested** is the
+combination CI and the integration suite actually run against; anything else is
+accepted because nothing in the lib's use of that package is known to break, not
+because it was exercised.
+
+| Package                     | Accepted (peer range)     | Tested            | Notes                                                                       |
+|-----------------------------|---------------------------|-------------------|-----------------------------------------------------------------------------|
+| `@nestjs/common` / `core`   | 10.x – 11.x               | 11.1.x            | **12.x is not accepted**: the whole NestJS 12 line is ESM-only, which this package (dual CJS+ESM) and a webpack-bundled host cannot consume yet |
+| `@nestjs/graphql`           | 13.x                      | 13.4.5            | 14.x requires NestJS 12 (ESM-only)                                          |
+| `@nestjs/apollo`            | 13.x                      | 13.4.5            | The lib itself imports neither `@nestjs/apollo` nor `@apollo/server`; the peer records that a driver is required |
+| `@apollo/server`            | not a peer                | 5.5.1             | Chosen by your driver, not by this package                                   |
+| `@as-integrations/express5` | 1.x                       | 1.1.2             | Required runtime peer of the Express driver                                  |
+| `graphql`                   | 16.x                      | 16.12.0           | 17.x is blocked upstream — `@apollo/server@5` still peers `^16.11.0`         |
+| `rxjs`                      | 7.x                       | 7.8.x             | One import (the mutation interceptor)                                        |
+| `@nestjs/event-emitter`     | 2.x – 3.x (optional)      | 3.1.0             | The next release is 12.x, which is ESM-only                                  |
+| `@rytass/wms-base-nestjs-module` | 0.4.x                | 0.4.0             | Imported directly by this package (the warehouse-map mutation and the location resolver) and shared with `@rytass/wms-module-core`. Declared as a peer since 0.10.0 so both see the same copy |
+| TypeORM                     | 0.3.x – 1.x               | 1.1.1             | The suite is run against both 0.3.31 and 1.1.1. 0.2.x is not supported. TypeORM 1.x additionally needs `@nestjs/typeorm` >= 11.0.1 |
+| PostgreSQL                  | —                         | 14+               | Native dialect                                                              |
+| Node.js                     | —                         | 20 LTS / 22       | 18 deprecated, 24 untested                                                  |
+| Next.js                     | 15.x – 16.x               | 15.5.x Pages      | Only `next/router` and `next/navigation` are used; App Router unsupported (see §13.11) |
+| React / React DOM           | 18.x – 19.x               | 19.2.x            | No React-19-only API is used, and `@mezzanine-ui/react` peers `>=18`        |
+| `@mezzanine-ui/react`       | 1.x                       | 1.4.1             | `@mezzanine-ui/system` is required — 45 of the lib's SCSS files `@use` it   |
+| `nuqs`                      | 2.x                       | 2.8.x             | Pages adapter; App Router adapter untested (see §13.11)                     |
+
+> **Why `@apollo/server` v5 is fine.** An earlier release pinned `@nestjs/apollo` to
+> `>=13.0.0 <13.2.0`, on the grounds that 13.2+ moved to `@apollo/server@^5` and "the lib
+> uses v4 plugin APIs". That was wrong: the only `ApolloServerPluginLandingPageLocalDefault`
+> usage lives in this repo's own `apps/api`, never in the published package, which imports
+> nothing from `@apollo/server` at all. The pin excluded the very combination the test suite
+> runs on, so it has been widened back to `^13.0.0`.
 
 ---
 

package/index.cjs.js

@@ -1760,6 +1760,20 @@ let InventoryCountOrderItemDto = class InventoryCountOrderItemDto {
     countedQuantity;
     /** `true` for a line added during counting for stock the books never had. */
     isAddition;
+    // ── Batch attributes as they were when counting started ────────────────── //
+    //
+    // Snapshotted rather than resolved live: the batch keeps moving after a count
+    // settles, and a sheet that silently rewrites itself months later stops being
+    // a record of what was found. `null` before counting has started.
+    held;
+    inShipment;
+    /** `null` = awaiting inspection, `false` = failed, `true` = passed. */
+    inspectionResult;
+    transferId;
+    vendorId;
+    customerId;
+    saleId;
+    saleSerialId;
 };
 tslib.__decorate([
     graphql.Field(() => graphql.ID),
@@ -1801,6 +1815,38 @@ tslib.__decorate([
     graphql.Field(() => Boolean),
     tslib.__metadata("design:type", Boolean)
 ], InventoryCountOrderItemDto.prototype, "isAddition", void 0);
+tslib.__decorate([
+    graphql.Field(() => Boolean, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "held", void 0);
+tslib.__decorate([
+    graphql.Field(() => Boolean, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "inShipment", void 0);
+tslib.__decorate([
+    graphql.Field(() => Boolean, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "inspectionResult", void 0);
+tslib.__decorate([
+    graphql.Field(() => graphql.ID, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "transferId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "vendorId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "customerId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "saleId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "saleSerialId", void 0);
 InventoryCountOrderItemDto = tslib.__decorate([
     graphql.ObjectType()
 ], InventoryCountOrderItemDto);
@@ -1868,6 +1914,11 @@ tslib.__decorate([
 InventoryCountOrderDto = tslib.__decorate([
     graphql.ObjectType()
 ], InventoryCountOrderDto);
+let InventoryCountOrderItems = class InventoryCountOrderItems extends PaginatedResponse(InventoryCountOrderItemDto) {
+};
+InventoryCountOrderItems = tslib.__decorate([
+    graphql.ObjectType()
+], InventoryCountOrderItems);
 let InventoryCountOrders = class InventoryCountOrders extends PaginatedResponse(InventoryCountOrderDto) {
 };
 InventoryCountOrders = tslib.__decorate([
@@ -2556,6 +2607,15 @@ let FindStockArgs = class FindStockArgs extends PaginationArgs {
     batchKey;
     locationKey;
     loaderKey;
+    /**
+     * Commercial attributes carried by the stock's batch. Matched exactly — they
+     * are identifiers from the host system, and a partial match on 「SO-1」 would
+     * quietly sweep in 「SO-10」.
+     */
+    vendorId;
+    customerId;
+    saleId;
+    saleSerialId;
 };
 tslib.__decorate([
     graphql.Field(() => graphql.ID, { nullable: true }),
@@ -2601,6 +2661,22 @@ tslib.__decorate([
     graphql.Field(() => String, { nullable: true }),
     tslib.__metadata("design:type", String)
 ], FindStockArgs.prototype, "loaderKey", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindStockArgs.prototype, "vendorId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindStockArgs.prototype, "customerId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindStockArgs.prototype, "saleId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindStockArgs.prototype, "saleSerialId", void 0);
 FindStockArgs = tslib.__decorate([
     graphql.ArgsType()
 ], FindStockArgs);
@@ -6991,6 +7067,67 @@ tslib.__decorate([
 FindInventoryCountOrderArgs = tslib.__decorate([
     graphql.ArgsType()
 ], FindInventoryCountOrderArgs);
+let FindInventoryCountOrderItemArgs = class FindInventoryCountOrderItemArgs extends PaginationArgs {
+    id;
+    materialKey;
+    materialDescription;
+    batchKey;
+    locationKey;
+    loaderSerialId;
+    vendorId;
+    customerId;
+    saleId;
+    saleSerialId;
+    /** Only lines whose counted quantity differs from the books (顯示盤差項目). */
+    onlyVariance;
+};
+tslib.__decorate([
+    graphql.Field(() => graphql.ID),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "id", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "materialKey", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "materialDescription", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "batchKey", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "locationKey", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "loaderSerialId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "vendorId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "customerId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "saleId", void 0);
+tslib.__decorate([
+    graphql.Field(() => String, { nullable: true }),
+    tslib.__metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "saleSerialId", void 0);
+tslib.__decorate([
+    graphql.Field(() => Boolean, { nullable: true }),
+    tslib.__metadata("design:type", Boolean)
+], FindInventoryCountOrderItemArgs.prototype, "onlyVariance", void 0);
+FindInventoryCountOrderItemArgs = tslib.__decorate([
+    graphql.ArgsType()
+], FindInventoryCountOrderItemArgs);
 let CreateInventoryCountOrderArgs = class CreateInventoryCountOrderArgs {
     name;
     countDate;
@@ -7149,6 +7286,17 @@ let InventoryCountOrderQuery = class InventoryCountOrderQuery {
         const [items, total] = await this.inventoryCountOrderService.findMany(args);
         return { items, total };
     }
+    /**
+     * The count sheet, filtered and paginated.
+     *
+     * Separate from `inventoryCountOrder.items` on purpose: the detail page needs
+     * to narrow thousands of lines down to the shelf in front of the operator, and
+     * a field resolver cannot take filters or a page.
+     */
+    async inventoryCountOrderItems({ id, ...options }) {
+        const [items, total] = await this.inventoryCountOrderService.findItems(id, options);
+        return { items, total };
+    }
     async inventoryCountOrder({ id }) {
         return this.inventoryCountOrderService.findOne(id);
     }
@@ -7161,6 +7309,14 @@ tslib.__decorate([
     tslib.__metadata("design:paramtypes", [FindInventoryCountOrderArgs]),
     tslib.__metadata("design:returntype", Promise)
 ], InventoryCountOrderQuery.prototype, "inventoryCountOrders", null);
+tslib.__decorate([
+    graphql.Query(() => InventoryCountOrderItems),
+    WmsOperation({ resource: 'inventory-count-order', action: 'read-items' }),
+    tslib.__param(0, graphql.Args()),
+    tslib.__metadata("design:type", Function),
+    tslib.__metadata("design:paramtypes", [FindInventoryCountOrderItemArgs]),
+    tslib.__metadata("design:returntype", Promise)
+], InventoryCountOrderQuery.prototype, "inventoryCountOrderItems", null);
 tslib.__decorate([
     graphql.Query(() => InventoryCountOrderDto),
     WmsOperation({ resource: 'inventory-count-order', action: 'read' }),

package/lib/dto/inventory-count-order.dto.d.ts

@@ -21,6 +21,15 @@ export declare class InventoryCountOrderItemDto {
     countedQuantity: number | null;
     /** `true` for a line added during counting for stock the books never had. */
     isAddition: boolean;
+    held: boolean | null;
+    inShipment: boolean | null;
+    /** `null` = awaiting inspection, `false` = failed, `true` = passed. */
+    inspectionResult: boolean | null;
+    transferId: string | null;
+    vendorId: string | null;
+    customerId: string | null;
+    saleId: string | null;
+    saleSerialId: string | null;
 }
 /**
  * A count order. `items` and `locations` come from
@@ -43,6 +52,9 @@ export declare class InventoryCountOrderDto {
     cancelledAt: Date | null;
     createdAt: Date;
 }
+declare const InventoryCountOrderItems_base: new () => import("./pagination.dto").PaginatedType<InventoryCountOrderItemDto>;
+export declare class InventoryCountOrderItems extends InventoryCountOrderItems_base {
+}
 declare const InventoryCountOrders_base: new () => import("./pagination.dto").PaginatedType<InventoryCountOrderDto>;
 export declare class InventoryCountOrders extends InventoryCountOrders_base {
 }

package/lib/dto/inventory-count-order.dto.js

@@ -29,6 +29,20 @@ let InventoryCountOrderItemDto = class InventoryCountOrderItemDto {
     countedQuantity;
     /** `true` for a line added during counting for stock the books never had. */
     isAddition;
+    // ── Batch attributes as they were when counting started ────────────────── //
+    //
+    // Snapshotted rather than resolved live: the batch keeps moving after a count
+    // settles, and a sheet that silently rewrites itself months later stops being
+    // a record of what was found. `null` before counting has started.
+    held;
+    inShipment;
+    /** `null` = awaiting inspection, `false` = failed, `true` = passed. */
+    inspectionResult;
+    transferId;
+    vendorId;
+    customerId;
+    saleId;
+    saleSerialId;
 };
 __decorate([
     Field(() => ID),
@@ -70,6 +84,38 @@ __decorate([
     Field(() => Boolean),
     __metadata("design:type", Boolean)
 ], InventoryCountOrderItemDto.prototype, "isAddition", void 0);
+__decorate([
+    Field(() => Boolean, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "held", void 0);
+__decorate([
+    Field(() => Boolean, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "inShipment", void 0);
+__decorate([
+    Field(() => Boolean, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "inspectionResult", void 0);
+__decorate([
+    Field(() => ID, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "transferId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "vendorId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "customerId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "saleId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "saleSerialId", void 0);
 InventoryCountOrderItemDto = __decorate([
     ObjectType()
 ], InventoryCountOrderItemDto);
@@ -137,10 +183,15 @@ __decorate([
 InventoryCountOrderDto = __decorate([
     ObjectType()
 ], InventoryCountOrderDto);
+let InventoryCountOrderItems = class InventoryCountOrderItems extends PaginatedResponse(InventoryCountOrderItemDto) {
+};
+InventoryCountOrderItems = __decorate([
+    ObjectType()
+], InventoryCountOrderItems);
 let InventoryCountOrders = class InventoryCountOrders extends PaginatedResponse(InventoryCountOrderDto) {
 };
 InventoryCountOrders = __decorate([
     ObjectType()
 ], InventoryCountOrders);
 
-export { InventoryCountOrderDto, InventoryCountOrderItemDto, InventoryCountOrders };
+export { InventoryCountOrderDto, InventoryCountOrderItemDto, InventoryCountOrderItems, InventoryCountOrders };

package/lib/inputs/find-stock.args.d.ts

@@ -12,4 +12,13 @@ export declare class FindStockArgs extends PaginationArgs {
     batchKey?: string;
     locationKey?: string;
     loaderKey?: string;
+    /**
+     * Commercial attributes carried by the stock's batch. Matched exactly — they
+     * are identifiers from the host system, and a partial match on 「SO-1」 would
+     * quietly sweep in 「SO-10」.
+     */
+    vendorId?: string;
+    customerId?: string;
+    saleId?: string;
+    saleSerialId?: string;
 }

package/lib/inputs/find-stock.args.js

@@ -15,6 +15,15 @@ let FindStockArgs = class FindStockArgs extends PaginationArgs {
     batchKey;
     locationKey;
     loaderKey;
+    /**
+     * Commercial attributes carried by the stock's batch. Matched exactly — they
+     * are identifiers from the host system, and a partial match on 「SO-1」 would
+     * quietly sweep in 「SO-10」.
+     */
+    vendorId;
+    customerId;
+    saleId;
+    saleSerialId;
 };
 __decorate([
     Field(() => ID, { nullable: true }),
@@ -60,6 +69,22 @@ __decorate([
     Field(() => String, { nullable: true }),
     __metadata("design:type", String)
 ], FindStockArgs.prototype, "loaderKey", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindStockArgs.prototype, "vendorId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindStockArgs.prototype, "customerId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindStockArgs.prototype, "saleId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindStockArgs.prototype, "saleSerialId", void 0);
 FindStockArgs = __decorate([
     ArgsType()
 ], FindStockArgs);

package/lib/inputs/inventory-count-order.args.d.ts

@@ -14,6 +14,20 @@ export declare class FindInventoryCountOrderArgs extends PaginationArgs {
      */
     locationIds?: string[];
 }
+export declare class FindInventoryCountOrderItemArgs extends PaginationArgs {
+    id: string;
+    materialKey?: string;
+    materialDescription?: string;
+    batchKey?: string;
+    locationKey?: string;
+    loaderSerialId?: string;
+    vendorId?: string;
+    customerId?: string;
+    saleId?: string;
+    saleSerialId?: string;
+    /** Only lines whose counted quantity differs from the books (顯示盤差項目). */
+    onlyVariance?: boolean;
+}
 export declare class CreateInventoryCountOrderArgs {
     name: string;
     countDate: string;

package/lib/inputs/inventory-count-order.args.js

@@ -44,6 +44,67 @@ __decorate([
 FindInventoryCountOrderArgs = __decorate([
     ArgsType()
 ], FindInventoryCountOrderArgs);
+let FindInventoryCountOrderItemArgs = class FindInventoryCountOrderItemArgs extends PaginationArgs {
+    id;
+    materialKey;
+    materialDescription;
+    batchKey;
+    locationKey;
+    loaderSerialId;
+    vendorId;
+    customerId;
+    saleId;
+    saleSerialId;
+    /** Only lines whose counted quantity differs from the books (顯示盤差項目). */
+    onlyVariance;
+};
+__decorate([
+    Field(() => ID),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "id", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "materialKey", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "materialDescription", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "batchKey", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "locationKey", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "loaderSerialId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "vendorId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "customerId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "saleId", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], FindInventoryCountOrderItemArgs.prototype, "saleSerialId", void 0);
+__decorate([
+    Field(() => Boolean, { nullable: true }),
+    __metadata("design:type", Boolean)
+], FindInventoryCountOrderItemArgs.prototype, "onlyVariance", void 0);
+FindInventoryCountOrderItemArgs = __decorate([
+    ArgsType()
+], FindInventoryCountOrderItemArgs);
 let CreateInventoryCountOrderArgs = class CreateInventoryCountOrderArgs {
     name;
     countDate;
@@ -193,4 +254,4 @@ InventoryCountOrderIdArgs = __decorate([
     ArgsType()
 ], InventoryCountOrderIdArgs);
 
-export { AddInventoryCountItemArgs, CountInventoryArgs, CountInventoryItemInput, CreateInventoryCountOrderArgs, FindInventoryCountOrderArgs, InventoryCountOrderIdArgs, RemoveInventoryCountItemArgs, UpdateInventoryCountOrderArgs };
+export { AddInventoryCountItemArgs, CountInventoryArgs, CountInventoryItemInput, CreateInventoryCountOrderArgs, FindInventoryCountOrderArgs, FindInventoryCountOrderItemArgs, InventoryCountOrderIdArgs, RemoveInventoryCountItemArgs, UpdateInventoryCountOrderArgs };

package/lib/queries/inventory-count-order.query.d.ts

@@ -1,9 +1,17 @@
 import { InventoryCountOrderService } from '@rytass/wms-module-core';
-import { InventoryCountOrderDto, InventoryCountOrders } from '../dto/inventory-count-order.dto';
-import { FindInventoryCountOrderArgs, InventoryCountOrderIdArgs } from '../inputs/inventory-count-order.args';
+import { InventoryCountOrderDto, InventoryCountOrderItems, InventoryCountOrders } from '../dto/inventory-count-order.dto';
+import { FindInventoryCountOrderArgs, FindInventoryCountOrderItemArgs, InventoryCountOrderIdArgs } from '../inputs/inventory-count-order.args';
 export declare class InventoryCountOrderQuery {
     private readonly inventoryCountOrderService;
     constructor(inventoryCountOrderService: InventoryCountOrderService);
     inventoryCountOrders(args: FindInventoryCountOrderArgs): Promise<InventoryCountOrders>;
+    /**
+     * The count sheet, filtered and paginated.
+     *
+     * Separate from `inventoryCountOrder.items` on purpose: the detail page needs
+     * to narrow thousands of lines down to the shelf in front of the operator, and
+     * a field resolver cannot take filters or a page.
+     */
+    inventoryCountOrderItems({ id, ...options }: FindInventoryCountOrderItemArgs): Promise<InventoryCountOrderItems>;
     inventoryCountOrder({ id }: InventoryCountOrderIdArgs): Promise<InventoryCountOrderDto>;
 }

package/lib/queries/inventory-count-order.query.js

@@ -2,8 +2,8 @@ import { __decorate, __param, __metadata } from 'tslib';
 import { Injectable } from '@nestjs/common';
 import { Query, Args } from '@nestjs/graphql';
 import { InventoryCountOrderService } from '@rytass/wms-module-core';
-import { InventoryCountOrders, InventoryCountOrderDto } from '../dto/inventory-count-order.dto.js';
-import { FindInventoryCountOrderArgs, InventoryCountOrderIdArgs } from '../inputs/inventory-count-order.args.js';
+import { InventoryCountOrders, InventoryCountOrderItems, InventoryCountOrderDto } from '../dto/inventory-count-order.dto.js';
+import { FindInventoryCountOrderArgs, FindInventoryCountOrderItemArgs, InventoryCountOrderIdArgs } from '../inputs/inventory-count-order.args.js';
 import '../auth/wms-auth.guard.js';
 import { WmsOperation } from '../auth/wms-operation.decorator.js';
 
@@ -16,6 +16,17 @@ let InventoryCountOrderQuery = class InventoryCountOrderQuery {
         const [items, total] = await this.inventoryCountOrderService.findMany(args);
         return { items, total };
     }
+    /**
+     * The count sheet, filtered and paginated.
+     *
+     * Separate from `inventoryCountOrder.items` on purpose: the detail page needs
+     * to narrow thousands of lines down to the shelf in front of the operator, and
+     * a field resolver cannot take filters or a page.
+     */
+    async inventoryCountOrderItems({ id, ...options }) {
+        const [items, total] = await this.inventoryCountOrderService.findItems(id, options);
+        return { items, total };
+    }
     async inventoryCountOrder({ id }) {
         return this.inventoryCountOrderService.findOne(id);
     }
@@ -28,6 +39,14 @@ __decorate([
     __metadata("design:paramtypes", [FindInventoryCountOrderArgs]),
     __metadata("design:returntype", Promise)
 ], InventoryCountOrderQuery.prototype, "inventoryCountOrders", null);
+__decorate([
+    Query(() => InventoryCountOrderItems),
+    WmsOperation({ resource: 'inventory-count-order', action: 'read-items' }),
+    __param(0, Args()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [FindInventoryCountOrderItemArgs]),
+    __metadata("design:returntype", Promise)
+], InventoryCountOrderQuery.prototype, "inventoryCountOrderItems", null);
 __decorate([
     Query(() => InventoryCountOrderDto),
     WmsOperation({ resource: 'inventory-count-order', action: 'read' }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rytass/wms-module-graphql",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "description": "Rytass WMS Module — GraphQL schema, resolvers and DTOs for warehouse management",
   "keywords": [
     "rytass",
@@ -30,10 +30,12 @@
     },
     "./adapters/member-base": {
       "types": "./adapters/member-base.d.ts",
+      "require": "./adapters/member-base.cjs.js",
       "import": "./adapters/member-base.js"
     },
     "./adapters/event-emitter": {
       "types": "./adapters/event-emitter.d.ts",
+      "require": "./adapters/event-emitter.cjs.js",
       "import": "./adapters/event-emitter.js"
     },
     "./package.json": "./package.json"
@@ -50,17 +52,21 @@
   },
   "dependencies": {
     "dataloader": "^2.2.3",
-    "lru-cache": "^10.0.0"
+    "lodash": "^4.17.0",
+    "lru-cache": "^10.0.0 || ^11.0.0"
   },
   "peerDependencies": {
     "@as-integrations/express5": "^1.0.0",
-    "@nestjs/apollo": ">=13.0.0 <13.2.0",
-    "@nestjs/common": "^11.0.0",
+    "@nestjs/apollo": "^13.0.0",
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0",
     "@nestjs/graphql": "^13.0.0",
-    "@rytass/wms-module-core": "^0.6.0",
+    "@rytass/wms-base-nestjs-module": "^0.4.0",
+    "@rytass/wms-module-core": "^0.8.0",
     "graphql": "^16.0.0",
     "reflect-metadata": "^0.1.13 || ^0.2.0",
-    "rxjs": "^7.8.0",
+    "rxjs": "^7.0.0",
+    "typeorm": "^0.3.0 || ^1.0.0",
     "@nestjs/event-emitter": "^2.0.0 || ^3.0.0"
   },
   "peerDependenciesMeta": {