@classytic/flow 0.1.4

package/dist/index-C_aEnozN.d.mts

@@ -0,0 +1,220 @@
+//#region src/domain/errors/base.d.ts
+declare abstract class FlowError extends Error {
+  abstract readonly code: string;
+  abstract readonly httpStatus: number;
+  constructor(message: string);
+  toJSON(): {
+    code: string;
+    message: string;
+    name: string;
+  };
+}
+//#endregion
+//#region src/domain/errors/domain-errors.d.ts
+declare class DuplicateReservationError extends FlowError {
+  readonly ownerType: string;
+  readonly ownerId: string;
+  readonly skuRef: string;
+  readonly code: "DUPLICATE_RESERVATION";
+  readonly httpStatus = 409;
+  constructor(ownerType: string, ownerId: string, skuRef: string);
+}
+declare class LocationNotStockableError extends FlowError {
+  readonly locationId: string;
+  readonly locationType: string;
+  readonly code: "LOCATION_NOT_STOCKABLE";
+  readonly httpStatus = 422;
+  constructor(locationId: string, locationType: string);
+}
+declare class NegativeStockError extends FlowError {
+  readonly skuRef: string;
+  readonly locationId: string;
+  readonly currentQty: number;
+  readonly requestedQty: number;
+  readonly code: "NEGATIVE_STOCK";
+  readonly httpStatus = 422;
+  constructor(skuRef: string, locationId: string, currentQty: number, requestedQty: number);
+}
+declare class MoveAlreadyPostedError extends FlowError {
+  readonly moveId: string;
+  readonly code: "MOVE_ALREADY_POSTED";
+  readonly httpStatus = 409;
+  constructor(moveId: string);
+}
+declare class ConcurrencyConflictError extends FlowError {
+  readonly code: "CONCURRENCY_CONFLICT";
+  readonly httpStatus = 409;
+  constructor(message?: string);
+}
+declare class QuantMismatchError extends FlowError {
+  readonly skuRef: string;
+  readonly locationId: string;
+  readonly expected: number;
+  readonly actual: number;
+  readonly code: "QUANT_MISMATCH";
+  readonly httpStatus = 500;
+  constructor(skuRef: string, locationId: string, expected: number, actual: number);
+}
+declare class LotRequiredError extends FlowError {
+  readonly skuRef: string;
+  readonly code: "LOT_REQUIRED";
+  readonly httpStatus = 422;
+  constructor(skuRef: string);
+}
+declare class SerialQuantityError extends FlowError {
+  readonly serialCode: string;
+  readonly code: "SERIAL_QUANTITY";
+  readonly httpStatus = 422;
+  constructor(serialCode: string);
+}
+declare class StockFrozenError extends FlowError {
+  readonly locationId: string;
+  readonly reason: string;
+  readonly code: "STOCK_FROZEN";
+  readonly httpStatus = 423;
+  constructor(locationId: string, reason: string);
+}
+declare class ProcurementNotApprovedError extends FlowError {
+  readonly orderId: string;
+  readonly code: "PROCUREMENT_NOT_APPROVED";
+  readonly httpStatus = 422;
+  constructor(orderId: string);
+}
+declare class NodeNotFoundError extends FlowError {
+  readonly nodeId: string;
+  readonly code: "NODE_NOT_FOUND";
+  readonly httpStatus = 404;
+  constructor(nodeId: string);
+}
+declare class LocationNotFoundError extends FlowError {
+  readonly locationId: string;
+  readonly code: "LOCATION_NOT_FOUND";
+  readonly httpStatus = 404;
+  constructor(locationId: string);
+}
+declare class MoveGroupNotFoundError extends FlowError {
+  readonly groupId: string;
+  readonly code: "MOVE_GROUP_NOT_FOUND";
+  readonly httpStatus = 404;
+  constructor(groupId: string);
+}
+declare class ReservationNotFoundError extends FlowError {
+  readonly reservationId: string;
+  readonly code: "RESERVATION_NOT_FOUND";
+  readonly httpStatus = 404;
+  constructor(reservationId: string);
+}
+declare class ValidationError extends FlowError {
+  readonly fields?: Record<string, string> | undefined;
+  readonly code: "VALIDATION_ERROR";
+  readonly httpStatus = 400;
+  constructor(message: string, fields?: Record<string, string> | undefined);
+}
+//#endregion
+//#region src/domain/errors/insufficient-stock.error.d.ts
+declare class InsufficientStockError extends FlowError {
+  readonly skuRef: string;
+  readonly requested: number;
+  readonly available: number;
+  readonly locationId?: string | undefined;
+  readonly code: "INSUFFICIENT_STOCK";
+  readonly httpStatus = 409;
+  constructor(skuRef: string, requested: number, available: number, locationId?: string | undefined);
+}
+//#endregion
+//#region src/domain/errors/invalid-transition.error.d.ts
+declare class InvalidTransitionError extends FlowError {
+  readonly entityType: string;
+  readonly entityId: string;
+  readonly from: string;
+  readonly to: string;
+  readonly code: "INVALID_TRANSITION";
+  readonly httpStatus = 422;
+  constructor(entityType: string, entityId: string, from: string, to: string);
+}
+//#endregion
+//#region src/domain/errors/location-capacity-exceeded.error.d.ts
+declare class LocationCapacityExceededError extends FlowError {
+  readonly locationId: string;
+  readonly capacity: number;
+  readonly requested: number;
+  readonly code: "LOCATION_CAPACITY_EXCEEDED";
+  readonly httpStatus = 422;
+  constructor(locationId: string, capacity: number, requested: number);
+}
+//#endregion
+//#region src/domain/errors/reservation-expired.error.d.ts
+declare class ReservationExpiredError extends FlowError {
+  readonly reservationId: string;
+  readonly code: "RESERVATION_EXPIRED";
+  readonly httpStatus = 410;
+  constructor(reservationId: string);
+}
+//#endregion
+//#region src/domain/errors/tenant-isolation.error.d.ts
+declare class TenantIsolationError extends FlowError {
+  readonly code: "TENANT_ISOLATION";
+  readonly httpStatus = 403;
+  constructor(message?: string);
+}
+//#endregion
+//#region src/domain/value-objects/quantity.d.ts
+/**
+ * Non-negative quantity value object.
+ * Used for planned/done quantities on moves and availability.
+ */
+declare class Quantity {
+  readonly value: number;
+  private constructor();
+  static create(value: number): Quantity;
+  static zero(): Quantity;
+  add(other: Quantity): Quantity;
+  subtract(other: Quantity): Quantity;
+  isZero(): boolean;
+  isGreaterThan(other: Quantity): boolean;
+  isGreaterThanOrEqual(other: Quantity): boolean;
+  equals(other: Quantity): boolean;
+  toString(): string;
+}
+//#endregion
+//#region src/domain/value-objects/sku-ref.d.ts
+/**
+ * Product/variant reference — opaque string identifier linking to the external catalog.
+ * Flow never owns the product definition; it references via skuRef.
+ */
+declare class SkuRef {
+  readonly value: string;
+  private constructor();
+  static create(value: string): SkuRef;
+  equals(other: SkuRef): boolean;
+  toString(): string;
+}
+//#endregion
+//#region src/domain/value-objects/uom-quantity.d.ts
+/**
+ * Quantity with unit of measure.
+ * Stock is stored in base UoM per SKU. Moves can specify alternate UoM; conversion applied at posting.
+ */
+interface UoMQuantity {
+  quantity: number;
+  uom: string;
+}
+/**
+ * UoM conversion definition.
+ */
+interface UoMConversion {
+  fromUom: string;
+  toUom: string;
+  factor: number;
+  skuRef?: string;
+}
+/**
+ * Convert quantity from one UoM to base UoM.
+ */
+declare function convertToBase(quantity: number, conversion: UoMConversion): number;
+/**
+ * Convert quantity from base UoM to target UoM.
+ */
+declare function convertFromBase(quantity: number, conversion: UoMConversion): number;
+//#endregion
+export { ReservationNotFoundError as C, FlowError as D, ValidationError as E, QuantMismatchError as S, StockFrozenError as T, MoveAlreadyPostedError as _, SkuRef as a, NodeNotFoundError as b, ReservationExpiredError as c, InsufficientStockError as d, ConcurrencyConflictError as f, LotRequiredError as g, LocationNotStockableError as h, convertToBase as i, LocationCapacityExceededError as l, LocationNotFoundError as m, UoMQuantity as n, Quantity as o, DuplicateReservationError as p, convertFromBase as r, TenantIsolationError as s, UoMConversion as t, InvalidTransitionError as u, MoveGroupNotFoundError as v, SerialQuantityError as w, ProcurementNotApprovedError as x, NegativeStockError as y };

package/dist/index-CulWO137.d.mts

@@ -0,0 +1,107 @@
+//#region src/domain/enums/move-status.d.ts
+declare const MoveStatus: {
+  readonly draft: "draft";
+  readonly planned: "planned";
+  readonly waiting: "waiting";
+  readonly ready: "ready";
+  readonly partially_done: "partially_done";
+  readonly done: "done";
+  readonly cancelled: "cancelled";
+};
+type MoveStatus = (typeof MoveStatus)[keyof typeof MoveStatus];
+/** Valid status transitions for stock moves. */
+declare const MOVE_STATUS_TRANSITIONS: Record<MoveStatus, readonly MoveStatus[]>;
+declare function isValidMoveTransition(from: MoveStatus, to: MoveStatus): boolean;
+//#endregion
+//#region src/domain/enums/operation-type.d.ts
+declare const OperationType: {
+  readonly receipt: "receipt";
+  readonly transfer: "transfer";
+  readonly shipment: "shipment";
+  readonly return: "return";
+  readonly adjustment: "adjustment";
+  readonly count: "count";
+};
+type OperationType = (typeof OperationType)[keyof typeof OperationType];
+//#endregion
+//#region src/domain/enums/group-type.d.ts
+declare const GroupType: {
+  readonly receipt: "receipt";
+  readonly transfer: "transfer";
+  readonly shipment: "shipment";
+  readonly return: "return";
+  readonly adjustment: "adjustment";
+  readonly pick_wave: "pick_wave";
+  readonly count_reconciliation: "count_reconciliation";
+};
+type GroupType = (typeof GroupType)[keyof typeof GroupType];
+//#endregion
+//#region src/domain/enums/location-type.d.ts
+declare const LocationType: {
+  readonly view: "view";
+  readonly internal: "internal";
+  readonly receiving: "receiving";
+  readonly storage: "storage";
+  readonly picking: "picking";
+  readonly packing: "packing";
+  readonly shipping: "shipping";
+  readonly transit: "transit";
+  readonly vendor: "vendor";
+  readonly customer: "customer";
+  readonly returns: "returns";
+  readonly quality_hold: "quality_hold";
+  readonly damaged: "damaged";
+  readonly scrap: "scrap";
+  readonly inventory_loss: "inventory_loss";
+  readonly production: "production";
+};
+type LocationType = (typeof LocationType)[keyof typeof LocationType];
+/** Location types that hold physical stock (non-virtual). */
+declare const STOCKABLE_LOCATION_TYPES: readonly LocationType[];
+/** Virtual location types — no physical stock, used for accounting/routing. */
+declare const VIRTUAL_LOCATION_TYPES: readonly LocationType[];
+//#endregion
+//#region src/domain/enums/reservation-status.d.ts
+declare const ReservationStatus: {
+  readonly active: "active";
+  readonly partially_consumed: "partially_consumed";
+  readonly consumed: "consumed";
+  readonly released: "released";
+  readonly expired: "expired";
+  readonly cancelled: "cancelled";
+};
+type ReservationStatus = (typeof ReservationStatus)[keyof typeof ReservationStatus];
+//#endregion
+//#region src/domain/enums/stock-status.d.ts
+declare const StockStatus: {
+  readonly sellable: "sellable";
+  readonly damaged: "damaged";
+  readonly quarantine: "quarantine";
+  readonly hold: "hold";
+  readonly returns: "returns";
+  readonly expired: "expired";
+  readonly in_transit: "in_transit";
+};
+type StockStatus = (typeof StockStatus)[keyof typeof StockStatus];
+/** Only sellable stock is counted as available for sale. */
+declare const SELLABLE_STATUSES: readonly StockStatus[];
+//#endregion
+//#region src/domain/enums/tracking-mode.d.ts
+declare const TrackingMode: {
+  readonly none: "none";
+  readonly lot: "lot";
+  readonly serial: "serial";
+};
+type TrackingMode = (typeof TrackingMode)[keyof typeof TrackingMode];
+//#endregion
+//#region src/domain/enums/valuation-method.d.ts
+declare const ValuationMethod: {
+  readonly wac: "wac";
+  readonly fifo: "fifo";
+  readonly fefo: "fefo";
+  readonly specific: "specific";
+  readonly standard: "standard";
+};
+type ValuationMethod = (typeof ValuationMethod)[keyof typeof ValuationMethod];
+//#endregion
+export { ReservationStatus as a, VIRTUAL_LOCATION_TYPES as c, MOVE_STATUS_TRANSITIONS as d, MoveStatus as f, StockStatus as i, GroupType as l, TrackingMode as n, LocationType as o, isValidMoveTransition as p, SELLABLE_STATUSES as r, STOCKABLE_LOCATION_TYPES as s, ValuationMethod as t, OperationType as u };

package/dist/index-DFF0GJ4J.d.mts

@@ -0,0 +1,36 @@
+//#region src/types/index.d.ts
+/**
+ * Shared context passed to every service method.
+ * organizationId and actorId live here, never in domain input objects.
+ */
+interface FlowContext {
+  organizationId: string;
+  actorId: string;
+  roles?: string[];
+  nodeScope?: string;
+  idempotencyKey?: string;
+}
+/** Paginated list result. */
+interface PaginatedResult<T> {
+  data: T[];
+  total: number;
+  page: number;
+  pageSize: number;
+  hasMore: boolean;
+}
+/** Standard list query with filters and pagination. */
+interface ListQuery {
+  filter?: Record<string, unknown>;
+  sort?: Record<string, 1 | -1>;
+  page?: number;
+  pageSize?: number;
+}
+/** Query options for findMany — passed through to MongoKit's findAll. */
+interface QueryOptions {
+  sort?: Record<string, 1 | -1> | string;
+  select?: string;
+}
+/** Flow engine deployment mode. */
+type FlowMode = 'simple' | 'standard' | 'enterprise';
+//#endregion
+export { QueryOptions as a, PaginatedResult as i, FlowMode as n, ListQuery as r, FlowContext as t };

package/dist/index-DsE7lZdO.d.mts

@@ -0,0 +1,11 @@
+//#region src/domain/contracts/auth-context.d.ts
+/**
+ * AuthContext — optional contract for consumer to provide auth context.
+ */
+interface AuthContext {
+  organizationId: string;
+  actorId: string;
+  roles?: string[];
+}
+//#endregion
+export { AuthContext as t };

package/dist/index-DwO9IdNa.d.mts

@@ -0,0 +1 @@
+export { };