@tailor-platform/erp-kit 0.2.1 → 0.2.2

package/src/modules/primitives/command/setReferenceUnit.ts

@@ -1,9 +1,6 @@
-import { ok, err, type CommandContext } from "../../shared/internal";
-import { DB } from "../generated/kysely-tailordb";
+import { ok, err } from "../../../shared";
+import { Transaction } from "../generated/kysely-tailordb";
 import { UnitNotFoundError, UnitNotInCategoryError } from "../lib/errors.generated";
-import { getUnit } from "../query/getUnit.generated";
-import { getUoMCategory } from "../query/getUoMCategory.generated";
-import { listUnitsByCategory } from "../query/listUnitsByCategory.generated";
 
 export interface SetReferenceUnitInput {
   unitId: string;
@@ -16,9 +13,14 @@ export interface SetReferenceUnitInput {
  * Changes the reference unit for a UoM category. All conversion factors
  * are recalculated relative to the new reference unit.
  */
-export async function run(db: DB, input: SetReferenceUnitInput, ctx: CommandContext) {
+export async function run(db: Transaction, input: SetReferenceUnitInput) {
   // 1. Find unit by ID
-  const { unit } = await getUnit(db, { id: input.unitId }, ctx);
+  const unit = await db
+    .selectFrom("Unit")
+    .selectAll()
+    .where("id", "=", input.unitId)
+    .forUpdate()
+    .executeTakeFirst();
 
   if (!unit) {
     return err(new UnitNotFoundError(input.unitId));
@@ -30,7 +32,12 @@ export async function run(db: DB, input: SetReferenceUnitInput, ctx: CommandCont
   }
 
   // 3. Get category
-  const { uoMCategory } = await getUoMCategory(db, { id: input.categoryId }, ctx);
+  const uoMCategory = await db
+    .selectFrom("UoMCategory")
+    .selectAll()
+    .where("id", "=", input.categoryId)
+    .forUpdate()
+    .executeTakeFirst();
 
   // 4. If already reference unit, return (idempotent)
   if (uoMCategory?.referenceUnitId === input.unitId && uoMCategory) {
@@ -38,7 +45,12 @@ export async function run(db: DB, input: SetReferenceUnitInput, ctx: CommandCont
   }
 
   // 5. Get all units in category for recalculation
-  const { units } = await listUnitsByCategory(db, { categoryId: input.categoryId }, ctx);
+  const units = await db
+    .selectFrom("Unit")
+    .selectAll()
+    .where("categoryId", "=", input.categoryId)
+    .forUpdate()
+    .execute();
 
   // 6. Recalculate all conversion factors
   // new_factor = old_factor / new_reference_old_factor

package/src/modules/primitives/docs/commands/ActivateCategory.md

@@ -31,3 +31,9 @@ flowchart TD
 ## Error Scenarios
 
 - **UOM_CATEGORY_NOT_FOUND**: Specified category ID does not exist
+
+## Test Cases
+
+- throws when category doesn
+- returns category unchanged when already active
+- activates inactive category

package/src/modules/primitives/docs/commands/ActivateCurrency.md

@@ -30,3 +30,9 @@ flowchart TD
 ## Error Scenarios
 
 - **CURRENCY_NOT_FOUND**: Specified currency ID does not exist
+
+## Test Cases
+
+- throws when currency doesn
+- returns currency unchanged when already active
+- activates inactive currency

package/src/modules/primitives/docs/commands/ActivateUnit.md

@@ -31,3 +31,9 @@ flowchart TD
 ## Error Scenarios
 
 - **UNIT_NOT_FOUND**: Specified unit ID does not exist
+
+## Test Cases
+
+- throws when unit doesn
+- returns unit unchanged when already active
+- activates inactive unit

package/src/modules/primitives/docs/commands/CreateCategory.md

@@ -39,3 +39,9 @@ flowchart TD
 ## Error Scenarios
 
 - **DUPLICATE_CATEGORY_NAME**: Category with same name already exists
+
+## Test Cases
+
+- throws when category name already exists
+- creates category with reference unit
+- passes custom fields through to insert

package/src/modules/primitives/docs/commands/CreateCurrency.md

@@ -44,3 +44,13 @@ flowchart TD
 - **INVALID_ISO_CODE**: Code is not exactly 3 uppercase letters
 - **DUPLICATE_CURRENCY_CODE**: Currency with same code already exists
 - **INVALID_DECIMAL_PLACES**: Value is negative or exceeds maximum (typically 4)
+
+## Test Cases
+
+- throws when ISO code is invalid format
+- throws when ISO code already exists
+- throws when decimal places is negative
+- throws when decimal places exceeds maximum
+- creates first currency as base currency
+- creates subsequent currency as non-base
+- passes custom fields through to insert

package/src/modules/primitives/docs/commands/CreateExchangeRate.md

@@ -45,3 +45,14 @@ flowchart TD
 - **INACTIVE_CURRENCY**: Source or target currency is inactive
 - **SAME_CURRENCY_PAIR**: Source and target currencies are the same
 - **INVALID_EXCHANGE_RATE**: Rate is zero, negative, or not a valid number
+
+## Test Cases
+
+- throws when source currency doesn
+- throws when source currency is inactive
+- throws when target currency doesn
+- throws when target currency is inactive
+- throws when source and target are the same
+- throws when rate is not positive
+- creates exchange rate successfully
+- passes custom fields through to insert

package/src/modules/primitives/docs/commands/CreateUnit.md

@@ -46,3 +46,13 @@ flowchart TD
 - **DUPLICATE_UNIT_SYMBOL**: Unit with same symbol already exists in category
 - **INVALID_CONVERSION_FACTOR**: Factor is zero, negative, or not a valid number
 - **INVALID_ROUNDING_PRECISION**: Precision is negative
+
+## Test Cases
+
+- throws when category doesn
+- throws when category is inactive
+- throws when symbol already exists in category
+- throws when conversion factor is not positive
+- throws when rounding precision is negative
+- creates unit successfully
+- passes custom fields through to insert

package/src/modules/primitives/docs/commands/DeactivateCategory.md

@@ -35,3 +35,10 @@ flowchart TD
 
 - **UOM_CATEGORY_NOT_FOUND**: Specified category ID does not exist
 - **CATEGORY_HAS_ACTIVE_UNITS**: Category still contains active units that must be deactivated first
+
+## Test Cases
+
+- throws when category doesn
+- throws when category has active units
+- returns category unchanged when already inactive
+- deactivates active category with no active units

package/src/modules/primitives/docs/commands/DeactivateCurrency.md

@@ -35,3 +35,10 @@ flowchart TD
 
 - **CURRENCY_NOT_FOUND**: Specified currency ID does not exist
 - **CANNOT_DEACTIVATE_BASE_CURRENCY**: Attempting to deactivate the base currency, must change base currency first
+
+## Test Cases
+
+- throws when currency doesn
+- throws when attempting to deactivate base currency
+- returns currency unchanged when already inactive
+- deactivates active non-base currency

package/src/modules/primitives/docs/commands/DeactivateUnit.md

@@ -35,3 +35,10 @@ flowchart TD
 
 - **UNIT_NOT_FOUND**: Specified unit ID does not exist
 - **CANNOT_DEACTIVATE_REFERENCE_UNIT**: Attempting to deactivate the category's reference unit, must change reference unit first
+
+## Test Cases
+
+- throws when unit doesn
+- throws when attempting to deactivate reference unit
+- returns unit unchanged when already inactive
+- deactivates active non-reference unit

package/src/modules/primitives/docs/commands/SetBaseCurrency.md

@@ -36,3 +36,10 @@ flowchart TD
 
 - **CURRENCY_NOT_FOUND**: Specified currency ID does not exist
 - **CANNOT_SET_INACTIVE_AS_BASE_CURRENCY**: Target currency is not in Active status, must be activated first
+
+## Test Cases
+
+- throws when currency doesn
+- throws when currency is inactive
+- returns currency unchanged when already base
+- changes base currency

package/src/modules/primitives/docs/commands/SetReferenceUnit.md

@@ -40,3 +40,10 @@ flowchart TD
 
 - **UNIT_NOT_FOUND**: Specified unit ID does not exist
 - **UNIT_NOT_IN_CATEGORY**: Unit belongs to a different category than specified
+
+## Test Cases
+
+- throws when unit doesn
+- throws when unit is not in specified category
+- returns category unchanged when unit is already reference
+- changes reference unit and recalculates conversion factors

package/src/modules/primitives/docs/queries/ConvertAmount.md

@@ -46,3 +46,17 @@ flowchart TD
 - **INACTIVE_CURRENCY**: Either source or target currency is inactive
 - **EXCHANGE_RATE_NOT_FOUND**: No rate found for the currency pair on or before the specified date
 - **CURRENCY_NOT_FOUND**: Specified currency code/ID does not exist
+
+## Test Cases
+
+- returns error when source currency doesn
+- returns error when target currency doesn
+- returns error when source currency is inactive
+- returns error when target currency is inactive
+- returns error when no exchange rate exists for the currency pair
+- returns same amount when source and target are the same currency
+- converts USD to EUR using direct rate
+- uses inverse rate when no direct rate exists
+- uses most recent rate on or before the conversion date
+- rounds to target currency decimal places (JPY has 0)
+- handles zero amount correctly

package/src/modules/primitives/docs/queries/ConvertQuantity.md

@@ -39,3 +39,16 @@ flowchart TD
 - **INCOMPATIBLE_UNITS**: Source and target units belong to different categories
 - **INACTIVE_UNIT**: Either source or target unit is inactive
 - **UNIT_NOT_FOUND**: Specified unit ID does not exist
+
+## Test Cases
+
+- returns error when source unit doesn
+- returns error when target unit doesn
+- returns error when source unit is inactive
+- returns error when target unit is inactive
+- returns error when units belong to different categories
+- returns same quantity when source and target are the same unit
+- converts kg to grams correctly
+- converts grams to kg correctly
+- converts pounds to kg correctly
+- handles zero quantity correctly

package/src/modules/primitives/docs/queries/GetBaseCurrency.md

@@ -30,3 +30,8 @@ flowchart TD
 ## Error Scenarios
 
 - None (returns null when no base currency is set instead of throwing)
+
+## Test Cases
+
+- returns base currency when set
+- returns null when no base currency is set

package/src/modules/primitives/docs/queries/GetCurrency.md

@@ -34,3 +34,10 @@ flowchart TD
 ## Error Scenarios
 
 - None (returns null when not found instead of throwing)
+
+## Test Cases
+
+- returns currency when found
+- returns null when currency not found
+- returns currency when found
+- returns null when currency not found

package/src/modules/primitives/docs/queries/GetUnit.md

@@ -34,3 +34,10 @@ flowchart TD
 ## Error Scenarios
 
 - None (returns null when not found instead of throwing)
+
+## Test Cases
+
+- returns unit when found
+- returns null when unit not found
+- returns unit when found
+- returns null when unit not found

package/src/modules/primitives/docs/queries/GetUoMCategory.md

@@ -34,3 +34,10 @@ flowchart TD
 ## Error Scenarios
 
 - None (returns null when not found instead of throwing)
+
+## Test Cases
+
+- returns category when found
+- returns null when category not found
+- returns category when found
+- returns null when category not found

package/src/modules/primitives/docs/queries/ListUnitsByCategory.md

@@ -2,19 +2,21 @@
 
 ## Overview
 
-ListUnitsByCategory retrieves all units belonging to a specific UoM category. Used to find related units within a category and to validate category constraints such as ensuring a category has units before deactivation.
+ListUnitsByCategory retrieves paginated units belonging to a specific UoM category. Used to find related units within a category and to validate category constraints such as ensuring a category has units before deactivation.
 
 ## Business Rules
 
-- Returns all units with the matching categoryId
-- Returns empty array if no units match
+- Returns paginated units with the matching categoryId
+- Returns empty result if no units match
+- Supports limit, offset, orderBy, and orderDirection parameters
+- Indicates whether more results exist via hasNextPage
 
 ## Process Flow
 
 ```mermaid
 flowchart TD
-    A[Receive categoryId] --> B[SELECT from Unit where categoryId = input]
-    B --> C[Return units array]
+    A[Receive categoryId and pagination params] --> B[SELECT from Unit where categoryId = input with limit+1, offset, order]
+    B --> C[Build paginated result with items and hasNextPage]
 ```
 
 ## External Dependencies
@@ -24,3 +26,11 @@ flowchart TD
 ## Error Scenarios
 
 - None
+
+## Test Cases
+
+- returns paginated units with default page size
+- returns hasNextPage true when more results exist
+- returns empty result when no units match
+- respects custom limit and offset
+- accepts orderBy and orderDirection

package/src/modules/primitives/index.ts

@@ -1,51 +1,2 @@
 export { defineModule } from "./module";
 export { permissions, own, all } from "./lib/permissions.generated";
-
-// errors
-export {
-  UomCategoryNotFoundError,
-  UnitNotFoundError,
-  IncompatibleUnitsError,
-  InactiveUnitError,
-  CurrencyNotFoundError,
-  InactiveCurrencyError,
-  ExchangeRateNotFoundError,
-  CannotDeactivateReferenceUnitError,
-  CategoryNotActiveError,
-  DuplicateUnitSymbolError,
-  InvalidConversionFactorError,
-  InvalidRoundingPrecisionError,
-  DuplicateCategoryNameError,
-  CategoryHasActiveUnitsError,
-  UnitNotInCategoryError,
-  InvalidIsoCodeError,
-  DuplicateCurrencyCodeError,
-  InvalidDecimalPlacesError,
-  CannotDeactivateBaseCurrencyError,
-  CannotSetInactiveAsBaseCurrencyError,
-  SameCurrencyPairError,
-  InvalidExchangeRateError,
-} from "./lib/errors.generated";
-
-// queries
-export { getUnit } from "./query/getUnit.generated";
-export { getCurrency } from "./query/getCurrency.generated";
-export { getUoMCategory } from "./query/getUoMCategory.generated";
-export { getBaseCurrency } from "./query/getBaseCurrency.generated";
-export { listUnitsByCategory } from "./query/listUnitsByCategory.generated";
-
-// input types
-export { type GetUnitInput } from "./query/getUnit";
-export { type GetCurrencyInput } from "./query/getCurrency";
-export { type GetUoMCategoryInput } from "./query/getUoMCategory";
-export { type ListUnitsByCategoryInput } from "./query/listUnitsByCategory";
-export { type ConvertQuantityInput } from "./query/convertQuantity";
-export { type ActivateCategoryInput } from "./command/activateCategory";
-export { type DeactivateCategoryInput } from "./command/deactivateCategory";
-export { type SetReferenceUnitInput } from "./command/setReferenceUnit";
-export { type ActivateUnitInput } from "./command/activateUnit";
-export { type DeactivateUnitInput } from "./command/deactivateUnit";
-export { type ConvertAmountInput } from "./query/convertAmount";
-export { type ActivateCurrencyInput } from "./command/activateCurrency";
-export { type DeactivateCurrencyInput } from "./command/deactivateCurrency";
-export { type SetBaseCurrencyInput } from "./command/setBaseCurrency";

package/src/modules/primitives/lib/errors.generated.ts

@@ -1,112 +1,112 @@
 // @generated — do not edit
-import { createDomainError } from "../../shared/internal";
+import { createDomainError } from "../../../shared";
 
 export const UomCategoryNotFoundError = createDomainError(
-  "UomCategoryNotFoundError", "UOM_CATEGORY_NOT_FOUND",
+  "UomCategoryNotFoundError", "PRIMITIVES_UOM_CATEGORY_NOT_FOUND",
   (identifier: string) => `Specified category ID does not exist: ${identifier}`,
 );
 
 export const CurrencyNotFoundError = createDomainError(
-  "CurrencyNotFoundError", "CURRENCY_NOT_FOUND",
+  "CurrencyNotFoundError", "PRIMITIVES_CURRENCY_NOT_FOUND",
   (identifier: string) => `Specified currency ID does not exist: ${identifier}`,
 );
 
 export const UnitNotFoundError = createDomainError(
-  "UnitNotFoundError", "UNIT_NOT_FOUND",
+  "UnitNotFoundError", "PRIMITIVES_UNIT_NOT_FOUND",
   (identifier: string) => `Specified unit ID does not exist: ${identifier}`,
 );
 
 export const DuplicateCategoryNameError = createDomainError(
-  "DuplicateCategoryNameError", "DUPLICATE_CATEGORY_NAME",
+  "DuplicateCategoryNameError", "PRIMITIVES_DUPLICATE_CATEGORY_NAME",
   (identifier: string) => `Category with same name already exists: ${identifier}`,
 );
 
 export const InvalidIsoCodeError = createDomainError(
-  "InvalidIsoCodeError", "INVALID_ISO_CODE",
+  "InvalidIsoCodeError", "PRIMITIVES_INVALID_ISO_CODE",
   (identifier: string) => `Code is not exactly 3 uppercase letters: ${identifier}`,
 );
 
 export const DuplicateCurrencyCodeError = createDomainError(
-  "DuplicateCurrencyCodeError", "DUPLICATE_CURRENCY_CODE",
+  "DuplicateCurrencyCodeError", "PRIMITIVES_DUPLICATE_CURRENCY_CODE",
   (identifier: string) => `Currency with same code already exists: ${identifier}`,
 );
 
 export const InvalidDecimalPlacesError = createDomainError(
-  "InvalidDecimalPlacesError", "INVALID_DECIMAL_PLACES",
+  "InvalidDecimalPlacesError", "PRIMITIVES_INVALID_DECIMAL_PLACES",
   (identifier: string) => `Value is negative or exceeds maximum (typically 4): ${identifier}`,
 );
 
 export const InactiveCurrencyError = createDomainError(
-  "InactiveCurrencyError", "INACTIVE_CURRENCY",
+  "InactiveCurrencyError", "PRIMITIVES_INACTIVE_CURRENCY",
   (identifier: string) => `Source or target currency is inactive: ${identifier}`,
 );
 
 export const SameCurrencyPairError = createDomainError(
-  "SameCurrencyPairError", "SAME_CURRENCY_PAIR",
+  "SameCurrencyPairError", "PRIMITIVES_SAME_CURRENCY_PAIR",
   (identifier: string) => `Source and target currencies are the same: ${identifier}`,
 );
 
 export const InvalidExchangeRateError = createDomainError(
-  "InvalidExchangeRateError", "INVALID_EXCHANGE_RATE",
+  "InvalidExchangeRateError", "PRIMITIVES_INVALID_EXCHANGE_RATE",
   (identifier: string) => `Rate is zero, negative, or not a valid number: ${identifier}`,
 );
 
 export const CategoryNotActiveError = createDomainError(
-  "CategoryNotActiveError", "CATEGORY_NOT_ACTIVE",
+  "CategoryNotActiveError", "PRIMITIVES_CATEGORY_NOT_ACTIVE",
   (identifier: string) => `Category is inactive: ${identifier}`,
 );
 
 export const DuplicateUnitSymbolError = createDomainError(
-  "DuplicateUnitSymbolError", "DUPLICATE_UNIT_SYMBOL",
+  "DuplicateUnitSymbolError", "PRIMITIVES_DUPLICATE_UNIT_SYMBOL",
   (identifier: string) => `Unit with same symbol already exists in category: ${identifier}`,
 );
 
 export const InvalidConversionFactorError = createDomainError(
-  "InvalidConversionFactorError", "INVALID_CONVERSION_FACTOR",
+  "InvalidConversionFactorError", "PRIMITIVES_INVALID_CONVERSION_FACTOR",
   (identifier: string) => `Factor is zero, negative, or not a valid number: ${identifier}`,
 );
 
 export const InvalidRoundingPrecisionError = createDomainError(
-  "InvalidRoundingPrecisionError", "INVALID_ROUNDING_PRECISION",
+  "InvalidRoundingPrecisionError", "PRIMITIVES_INVALID_ROUNDING_PRECISION",
   (identifier: string) => `Precision is negative: ${identifier}`,
 );
 
 export const CategoryHasActiveUnitsError = createDomainError(
-  "CategoryHasActiveUnitsError", "CATEGORY_HAS_ACTIVE_UNITS",
+  "CategoryHasActiveUnitsError", "PRIMITIVES_CATEGORY_HAS_ACTIVE_UNITS",
   (identifier: string) => `Category still contains active units that must be deactivated first: ${identifier}`,
 );
 
 export const CannotDeactivateBaseCurrencyError = createDomainError(
-  "CannotDeactivateBaseCurrencyError", "CANNOT_DEACTIVATE_BASE_CURRENCY",
+  "CannotDeactivateBaseCurrencyError", "PRIMITIVES_CANNOT_DEACTIVATE_BASE_CURRENCY",
   (identifier: string) => `Attempting to deactivate the base currency, must change base currency first: ${identifier}`,
 );
 
 export const CannotDeactivateReferenceUnitError = createDomainError(
-  "CannotDeactivateReferenceUnitError", "CANNOT_DEACTIVATE_REFERENCE_UNIT",
+  "CannotDeactivateReferenceUnitError", "PRIMITIVES_CANNOT_DEACTIVATE_REFERENCE_UNIT",
   (identifier: string) => `Attempting to deactivate the category's reference unit, must change reference unit first: ${identifier}`,
 );
 
 export const CannotSetInactiveAsBaseCurrencyError = createDomainError(
-  "CannotSetInactiveAsBaseCurrencyError", "CANNOT_SET_INACTIVE_AS_BASE_CURRENCY",
+  "CannotSetInactiveAsBaseCurrencyError", "PRIMITIVES_CANNOT_SET_INACTIVE_AS_BASE_CURRENCY",
   (identifier: string) => `Target currency is not in Active status, must be activated first: ${identifier}`,
 );
 
 export const UnitNotInCategoryError = createDomainError(
-  "UnitNotInCategoryError", "UNIT_NOT_IN_CATEGORY",
+  "UnitNotInCategoryError", "PRIMITIVES_UNIT_NOT_IN_CATEGORY",
   (identifier: string) => `Unit belongs to a different category than specified: ${identifier}`,
 );
 
 export const ExchangeRateNotFoundError = createDomainError(
-  "ExchangeRateNotFoundError", "EXCHANGE_RATE_NOT_FOUND",
+  "ExchangeRateNotFoundError", "PRIMITIVES_EXCHANGE_RATE_NOT_FOUND",
   (identifier: string) => `No rate found for the currency pair on or before the specified date: ${identifier}`,
 );
 
 export const IncompatibleUnitsError = createDomainError(
-  "IncompatibleUnitsError", "INCOMPATIBLE_UNITS",
+  "IncompatibleUnitsError", "PRIMITIVES_INCOMPATIBLE_UNITS",
   (identifier: string) => `Source and target units belong to different categories: ${identifier}`,
 );
 
 export const InactiveUnitError = createDomainError(
-  "InactiveUnitError", "INACTIVE_UNIT",
+  "InactiveUnitError", "PRIMITIVES_INACTIVE_UNIT",
   (identifier: string) => `Either source or target unit is inactive: ${identifier}`,
 );

package/src/modules/primitives/lib/permissions.generated.ts

@@ -1,5 +1,5 @@
 // @generated — do not edit
-import { definePermissions } from "../../shared/internal";
+import { definePermissions } from "../../../shared";
 
 export const { permissions, own, all } = definePermissions("primitives", [
   "activateCategory",

package/src/modules/primitives/lib/types.ts

@@ -1,4 +1,4 @@
-import type { InferSchema, Selectable, Insertable, Updateable } from "../../shared/internal";
+import type { InferSchema, Selectable, Insertable, Updateable } from "../../../shared";
 import type { DB } from "../generated/kysely-tailordb";
 
 export type Schema = InferSchema<DB>;

package/src/modules/primitives/module.ts

@@ -1,5 +1,5 @@
 import { type TailorAnyDBField } from "@tailor-platform/sdk";
-import { type EmptyFields, type FieldsToInsertable } from "../shared/internal";
+import { type EmptyFields, type FieldsToInsertable } from "../../shared";
 import { createCategory } from "./command/createCategory.generated";
 import { createCurrency } from "./command/createCurrency.generated";
 import { createUnit } from "./command/createUnit.generated";

package/src/modules/primitives/query/convertAmount.generated.ts

@@ -1,5 +1,5 @@
 // @generated — do not edit
-import { defineQuery } from "../../shared/internal";
+import { defineQuery } from "../../../shared";
 import { run } from "./convertAmount";
 
 export const convertAmount = defineQuery(run);