@rytass/wms-module-graphql 0.8.0 → 0.10.0

package/index.d.ts

@@ -4,6 +4,8 @@ export type { LoaderOptions, LoaderOptionsWithPagination, } from './lib/helpers/
 export type { LoaderType } from './lib/helpers/dataloader.type';
 export { createWmsLoaders, type WmsLoaders, } from './lib/helpers/create-wms-loaders';
 export { HOST_SKIP_METADATA_KEY, WmsAuthGuard, WmsOperation, WMS_AUTH_OPTIONS, WMS_OPERATION_METADATA, type WmsAuthChecker, type WmsAuthModuleOptions, type WmsOperationRequirement, } from './lib/auth';
+export { pruneDisabledOperations, type PrunedOperations, type WmsOperationRegistrationOptions, } from './lib/registry';
 export type { WmsModuleGraphqlModuleAsyncOptions } from './lib/graphql.module';
 export { WmsMutationEvent, WmsMutationInterceptor, WMS_MUTATION_EVENT_METADATA, type WmsMutationEventConfig, type WmsOperationResultMap, type WmsEventPayloadFor, type WmsTypedAfterEventContext, type WmsTypedAfterListenerMap, type WmsTypedBeforeHookContext, type WmsTypedBeforeHookMap, } from './lib/events';
-export type { WmsActor, WmsActorExtractor, WmsAfterEventContext, WmsAfterListener, WmsAfterListenerMap, WmsBeforeHook, WmsBeforeHookContext, WmsBeforeHookMap, WmsDomainEvent, WmsEventModuleOptions, WmsEventName, WmsEventPayloadMap, WmsOperationEventName, WmsOperationEventPayload, WmsStockEventName, WmsStockEventPayload, } from '@rytass/wms-module-core';
+export type { WmsActor, WmsActorExtractor, WmsAfterEventContext, WmsAfterListener, WmsAfterListenerMap, WmsBeforeHook, WmsBeforeHookContext, WmsBeforeHookMap, WmsDomainEvent, WmsEventModuleOptions, WmsEventName, WmsEventPayloadMap, WmsOperationEventName, WmsOperationEventPayload, WmsOperationName, WmsStockEventName, WmsStockEventPayload, } from '@rytass/wms-module-core';
+export { WMS_OPERATION_NAMES } from '@rytass/wms-module-core';

package/index.js

@@ -5,6 +5,8 @@ export { HOST_SKIP_METADATA_KEY } from './lib/auth/host-skip.constant.js';
 export { WmsAuthGuard } from './lib/auth/wms-auth.guard.js';
 export { WmsOperation } from './lib/auth/wms-operation.decorator.js';
 export { WMS_AUTH_OPTIONS, WMS_OPERATION_METADATA } from './lib/auth/wms-auth.types.js';
+export { pruneDisabledOperations } from './lib/registry/operation-registry.js';
 export { WmsMutationEvent } from './lib/events/wms-mutation-event.decorator.js';
 export { WMS_MUTATION_EVENT_METADATA } from './lib/events/wms-mutation-event.constants.js';
 export { WmsMutationInterceptor } from './lib/events/wms-mutation.interceptor.js';
+export { WMS_OPERATION_NAMES } from '@rytass/wms-module-core';

package/lib/dto/index.d.ts

@@ -22,3 +22,4 @@ export * from './scrape-order.dto';
 export * from './scrape-order-item.dto';
 export * from './quality-inspection-order.dto';
 export * from './quality-inspection-order-item.dto';
+export * from './inventory-count-order.dto';

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

@@ -0,0 +1,61 @@
+import { InventoryCountStatus } from '@rytass/wms-module-core';
+/**
+ * A count-sheet line.
+ *
+ * `material` / `batch` / `location` / `loader` are deliberately absent from this
+ * class: they are added to the schema by `InventoryCountOrderItemResolver` as
+ * `@ResolveField`s so they load through DataLoaders, and declaring them here
+ * would make the class stop matching the entity the service returns.
+ */
+export declare class InventoryCountOrderItemDto {
+    id: string;
+    orderId: string;
+    materialId: string;
+    batchId: string;
+    locationId: string | null;
+    loaderId: string | null;
+    unitId: string | null;
+    /** Ledger quantity in base units, frozen when counting started. */
+    bookQuantity: number;
+    /** What was found, expressed in `unitId`. `null` until someone counts it. */
+    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
+ * `InventoryCountOrderResolver`, for the same reason as above; `locations`
+ * exposes the roots the user picked, not the expanded subtree.
+ */
+export declare class InventoryCountOrderDto {
+    id: string;
+    key: string;
+    name: string;
+    /**
+     * The count's base date. Stock adjustments from settlement are reported under
+     * this date rather than the day settlement happened to run.
+     */
+    countDate: string;
+    status: InventoryCountStatus;
+    createdBy: string | null;
+    startedAt: Date | null;
+    settledAt: Date | null;
+    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 {
+}
+export {};

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

@@ -0,0 +1,197 @@
+import { __decorate, __metadata } from 'tslib';
+import { registerEnumType, Field, ID, Float, ObjectType } from '@nestjs/graphql';
+import { InventoryCountStatus } from '@rytass/wms-module-core';
+import { PaginatedResponse } from './pagination.dto.js';
+
+registerEnumType(InventoryCountStatus, {
+    name: 'InventoryCountStatus',
+    description: 'Lifecycle of an inventory count: PENDING (尚未執行) → COUNTING (盤點中) → COMPLETED (已完成), or CANCELLED (已取消).',
+});
+/**
+ * A count-sheet line.
+ *
+ * `material` / `batch` / `location` / `loader` are deliberately absent from this
+ * class: they are added to the schema by `InventoryCountOrderItemResolver` as
+ * `@ResolveField`s so they load through DataLoaders, and declaring them here
+ * would make the class stop matching the entity the service returns.
+ */
+let InventoryCountOrderItemDto = class InventoryCountOrderItemDto {
+    id;
+    orderId;
+    materialId;
+    batchId;
+    locationId;
+    loaderId;
+    unitId;
+    /** Ledger quantity in base units, frozen when counting started. */
+    bookQuantity;
+    /** What was found, expressed in `unitId`. `null` until someone counts it. */
+    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),
+    __metadata("design:type", String)
+], InventoryCountOrderItemDto.prototype, "id", void 0);
+__decorate([
+    Field(() => ID),
+    __metadata("design:type", String)
+], InventoryCountOrderItemDto.prototype, "orderId", void 0);
+__decorate([
+    Field(() => ID),
+    __metadata("design:type", String)
+], InventoryCountOrderItemDto.prototype, "materialId", void 0);
+__decorate([
+    Field(() => ID),
+    __metadata("design:type", String)
+], InventoryCountOrderItemDto.prototype, "batchId", void 0);
+__decorate([
+    Field(() => ID, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "locationId", void 0);
+__decorate([
+    Field(() => ID, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "loaderId", void 0);
+__decorate([
+    Field(() => ID, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "unitId", void 0);
+__decorate([
+    Field(() => Float),
+    __metadata("design:type", Number)
+], InventoryCountOrderItemDto.prototype, "bookQuantity", void 0);
+__decorate([
+    Field(() => Float, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderItemDto.prototype, "countedQuantity", void 0);
+__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);
+/**
+ * A count order. `items` and `locations` come from
+ * `InventoryCountOrderResolver`, for the same reason as above; `locations`
+ * exposes the roots the user picked, not the expanded subtree.
+ */
+let InventoryCountOrderDto = class InventoryCountOrderDto {
+    id;
+    key;
+    name;
+    /**
+     * The count's base date. Stock adjustments from settlement are reported under
+     * this date rather than the day settlement happened to run.
+     */
+    countDate;
+    status;
+    createdBy;
+    startedAt;
+    settledAt;
+    cancelledAt;
+    createdAt;
+};
+__decorate([
+    Field(() => ID),
+    __metadata("design:type", String)
+], InventoryCountOrderDto.prototype, "id", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], InventoryCountOrderDto.prototype, "key", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], InventoryCountOrderDto.prototype, "name", void 0);
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], InventoryCountOrderDto.prototype, "countDate", void 0);
+__decorate([
+    Field(() => InventoryCountStatus),
+    __metadata("design:type", String)
+], InventoryCountOrderDto.prototype, "status", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderDto.prototype, "createdBy", void 0);
+__decorate([
+    Field(() => Date, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderDto.prototype, "startedAt", void 0);
+__decorate([
+    Field(() => Date, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderDto.prototype, "settledAt", void 0);
+__decorate([
+    Field(() => Date, { nullable: true }),
+    __metadata("design:type", Object)
+], InventoryCountOrderDto.prototype, "cancelledAt", void 0);
+__decorate([
+    Field(() => Date),
+    __metadata("design:type", Date)
+], InventoryCountOrderDto.prototype, "createdAt", void 0);
+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, InventoryCountOrderItems, InventoryCountOrders };

package/lib/events/operation-result-map.d.ts

@@ -12,6 +12,7 @@
 import type { WmsOperationEventName } from '@rytass/wms-module-core';
 import type { AllocateInventoryOrderDto, HoldInventoryOrderDto, LoaderDto, LoaderTypeDto, MaterialDto, QualityInspectionOrderDto, ReceiveInventoryOrderDto, ScrapeOrderDto, ShipInventoryOrderDto, TransferCustomerOrderDto, TransferOrderDto, TransferVendorOrderDto } from '../dto';
 import type { LocationDto } from '../dto/location.dto';
+import type { InventoryCountOrderDto, InventoryCountOrderItemDto } from '../dto/inventory-count-order.dto';
 import type { MapDataDto } from '../dto/warehouse-map.dto';
 import type { MergeBatchOrderDto } from '../dto/merge-batch-order.dto';
 import type { ReclassifyInventoryOrderDto } from '../dto/reclassify-inventory-order.dto';
@@ -27,6 +28,13 @@ import type { SplitBatchOrderDto } from '../dto/split-batch-order.dto';
  * Maintenance: for every new `@Mutation`, add the matching entry here.
  */
 export interface WmsOperationResultMap extends Record<WmsOperationEventName, unknown> {
+    'inventory-count-order.created': InventoryCountOrderDto;
+    'inventory-count-order.updated': InventoryCountOrderDto | InventoryCountOrderItemDto;
+    'inventory-count-order.started': InventoryCountOrderDto;
+    'inventory-count-order.counted': InventoryCountOrderDto;
+    'inventory-count-order.reset': InventoryCountOrderDto;
+    'inventory-count-order.cancelled': InventoryCountOrderDto;
+    'inventory-count-order.settled': InventoryCountOrderDto;
     'material.created': MaterialDto;
     'material.updated': MaterialDto;
     'location.created': LocationDto;

package/lib/graphql.module.d.ts

@@ -2,6 +2,7 @@ import { DynamicModule, type Provider } from '@nestjs/common';
 import { type WmsActorExtractor, type WmsModuleCoreModuleAsyncOptions } from '@rytass/wms-module-core';
 import { type WmsAuthModuleOptions } from './auth';
 import { type WmsTypedAfterListenerMap, type WmsTypedBeforeHookMap } from './events';
+import { type WmsOperationRegistrationOptions } from './registry';
 /**
  * Options for `WmsModuleGraphqlModule.forRootAsync`. Extends the core module
  * options with:
@@ -16,11 +17,14 @@ import { type WmsTypedAfterListenerMap, type WmsTypedBeforeHookMap } from './eve
  * - `eventEmitterBridge` — pass `wmsEventEmitterBridgeProvider` from
  *   `@rytass/wms-module-graphql/adapters/event-emitter` to also fan events out
  *   to `@nestjs/event-emitter` (`@OnEvent('wms.<event>')`).
+ * - `enabledOperations` / `disabledOperations` / `disabledFields` — deployment
+ *   switches that keep an operation **out of the schema entirely** rather than
+ *   merely refusing it (see {@link WmsOperationRegistrationOptions}).
  *
  * Everything is optional; with nothing configured the module behaves exactly as
- * before (no events emitted, fully permissive).
+ * before (no events emitted, fully permissive, every operation registered).
  */
-export type WmsModuleGraphqlModuleAsyncOptions = WmsModuleCoreModuleAsyncOptions & WmsAuthModuleOptions & {
+export type WmsModuleGraphqlModuleAsyncOptions = WmsModuleCoreModuleAsyncOptions & WmsAuthModuleOptions & WmsOperationRegistrationOptions & {
     readonly beforeHooks?: WmsTypedBeforeHookMap;
     readonly afterListeners?: WmsTypedAfterListenerMap;
     readonly actorExtractor?: WmsActorExtractor;

package/lib/graphql.module.js

@@ -7,6 +7,7 @@ import './helpers/query-path.js';
 import { WmsAuthGuard } from './auth/wms-auth.guard.js';
 import { WMS_AUTH_OPTIONS } from './auth/wms-auth.types.js';
 import { WmsMutationInterceptor } from './events/wms-mutation.interceptor.js';
+import { pruneDisabledOperations } from './registry/operation-registry.js';
 import { LoaderMutation } from './mutations/loader.mutation.js';
 import { LoaderQuery } from './queries/loader.query.js';
 import { MaterialMutation } from './mutations/material.mutation.js';
@@ -53,6 +54,9 @@ import { ScrapeMutation } from './mutations/scrape-order.mutation.js';
 import { QualityInspectionOrderMutation } from './mutations/quality-inspection-order.mutation.js';
 import { WarehouseMapDataQuery } from './queries/warehouse-map.query.js';
 import { MapRangeUnionResolver } from './resolvers/warehouse-map.resolver.js';
+import { InventoryCountOrderQuery } from './queries/inventory-count-order.query.js';
+import { InventoryCountOrderMutation } from './mutations/inventory-count-order.mutation.js';
+import { InventoryCountOrderResolver, InventoryCountOrderItemResolver } from './resolvers/inventory-count-order.resolver.js';
 
 var WmsModuleGraphqlModule_1;
 const exportDependencies = [
@@ -108,10 +112,23 @@ const exportDependencies = [
     QualityInspectionOrderMutation,
     WarehouseMapDataQuery,
     MapRangeUnionResolver,
+    InventoryCountOrderQuery,
+    InventoryCountOrderMutation,
+    InventoryCountOrderResolver,
+    InventoryCountOrderItemResolver,
 ];
 let WmsModuleGraphqlModule = WmsModuleGraphqlModule_1 = class WmsModuleGraphqlModule {
     static forRootAsync(options) {
-        const { authChecker, beforeHooks, afterListeners, actorExtractor, eventEmitterBridge, ...coreOptions } = options;
+        const { authChecker, beforeHooks, afterListeners, actorExtractor, eventEmitterBridge, enabledOperations, disabledOperations, disabledFields, ...coreOptions } = options;
+        // Must run before `GraphQLModule` builds the schema. `forRootAsync` is
+        // called while `AppModule` is still being defined, so this is the earliest
+        // point at which the deployment's switches are known — and it is early
+        // enough: the schema is not built until the app bootstraps.
+        pruneDisabledOperations(exportDependencies, {
+            enabledOperations,
+            disabledOperations,
+            disabledFields,
+        });
         // coreOptions still carries `enrichStockEvents`, forwarded to the core module.
         const coreModule = WmsModuleCoreModule.forRootAsync(coreOptions);
         const authOptions = { authChecker };

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

@@ -0,0 +1,69 @@
+import { InventoryCountStatus } from '@rytass/wms-module-core';
+import { PaginationArgs } from './pagination.args';
+export declare class FindInventoryCountOrderArgs extends PaginationArgs {
+    name?: string;
+    statuses?: InventoryCountStatus[];
+    createdBy?: string;
+    /** Inclusive lower bound on `countDate`, `YYYY-MM-DD`. */
+    countDateFrom?: string;
+    /** Inclusive upper bound on `countDate`, `YYYY-MM-DD`. */
+    countDateTo?: string;
+    /**
+     * Matches against the expanded scope, not the roots the user picked, so
+     * filtering by a shelf finds the count that covers its whole aisle.
+     */
+    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;
+    /** Root locations; every descendant is pulled into scope automatically. */
+    locationIds: string[];
+}
+export declare class UpdateInventoryCountOrderArgs {
+    id: string;
+    name?: string;
+    countDate?: string;
+    locationIds?: string[];
+}
+export declare class CountInventoryItemInput {
+    itemId: string;
+    /** `null` clears the entry, putting the line back to "not counted". */
+    countedQuantity?: number | null;
+    unitId?: string | null;
+}
+export declare class CountInventoryArgs {
+    id: string;
+    items: CountInventoryItemInput[];
+}
+export declare class AddInventoryCountItemArgs {
+    id: string;
+    materialId: string;
+    /** An existing batch key, or a new one — the batch is created on demand. */
+    batchKey: string;
+    locationId: string;
+    loaderId?: string | null;
+    countedQuantity: number;
+    unitId?: string | null;
+}
+export declare class RemoveInventoryCountItemArgs {
+    id: string;
+    itemId: string;
+}
+export declare class InventoryCountOrderIdArgs {
+    id: string;
+}