@things-factory/setting-base 4.3.752 → 4.3.764

package/README.md

@@ -0,0 +1,523 @@
+# Setting Base - Extensible Validation System
+
+This package provides a common setting management system with an extensible validation framework that allows each application (operato-wms, operato-hub, etc.) to register their own validators for specific settings without modifying the core mutation functions.
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Architecture](#architecture)
+- [Getting Started](#getting-started)
+- [Usage Guide](#usage-guide)
+- [Validator Types](#validator-types)
+- [Examples](#examples)
+- [Best Practices](#best-practices)
+- [Error Handling](#error-handling)
+- [Testing](#testing)
+- [Troubleshooting](#troubleshooting)
+
+## Overview
+
+The validation system uses a **registry pattern** that allows each application to register their own validators for specific settings. This design:
+
+- ✅ Keeps `setting-mutation.ts` as a common function
+- ✅ Avoids circular dependencies
+- ✅ Allows applications to add custom validation logic
+- ✅ Supports both exact name matching and pattern matching
+- ✅ Works seamlessly with the shared `setting-ui` component
+
+## Architecture
+
+### Dependency Flow
+
+The validator system is designed to avoid circular dependencies:
+
+```
+┌─────────────────┐
+│  setting-base   │  (Common package - no app dependencies)
+│                 │
+│  - Registry     │
+│  - Mutations    │
+└────────┬────────┘
+         │ exports registry
+         │
+         ▼
+┌─────────────────┐      ┌─────────────────┐
+│   operato-wms   │      │   operato-hub    │
+│                 │      │                 │
+│  - Validators   │      │  - Validators   │
+│  - Registers    │      │  - Registers    │
+└────────┬────────┘      └────────┬────────┘
+         │                        │
+         │ imports registry       │ imports registry
+         │                        │
+         └────────┬───────────────┘
+                  │
+                  ▼
+         ┌─────────────────┐
+         │   setting-ui     │
+         │                  │
+         │  - UI Component  │
+         │  - Uses mutations│
+         └──────────────────┘
+```
+
+### Key Components
+
+- **`setting-validator.ts`**: Contains the validator registry and validation logic
+- **`setting-mutation.ts`**: Common mutation functions that call validators before saving
+- **Application validators**: Each application registers its own validators
+
+### How It Works
+
+1. **Module Load Phase**: Applications register validators when their server code is imported
+2. **Schema Build Phase**: GraphQL schema is built with mutation resolvers
+3. **Runtime Phase**: When a setting is created/updated, the mutation function calls registered validators
+4. **Validation Result**: If validation fails, an error is thrown before saving; if it passes, the setting is saved normally
+
+### Package Dependencies
+
+```
+setting-base:
+  - No dependencies on applications ✅
+  - Only depends on: auth-base, code-base
+
+operato-wms:
+  - Depends on: setting-base ✅
+  - Registers validators at module load ✅
+
+operato-hub:
+  - Depends on: setting-base ✅
+  - Registers validators at module load ✅
+
+setting-ui:
+  - Depends on: setting-base ✅
+  - Uses mutations (which call validators) ✅
+```
+
+## Getting Started
+
+### Step 1: Create Validator Functions
+
+Create a validator file in your application (e.g., `packages/operato-wms/server/validators/setting-validators.ts`):
+
+```typescript
+import { settingValidatorRegistry, SettingValidationResult } from '@things-factory/setting-base'
+import { Domain } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { NewSetting, SettingPatch } from '@things-factory/setting-base'
+import { Setting } from '@things-factory/setting-base'
+
+// Validator for creating a setting
+async function validateBatchPickingLimit(
+  setting: NewSetting,
+  context: { domain: Domain; user: User }
+): Promise<SettingValidationResult> {
+  if (!setting.value) {
+    return { valid: false, error: 'batch-picking-limit value is required' }
+  }
+
+  const limit = parseInt(setting.value, 10)
+  if (isNaN(limit) || limit < 1 || limit > 1000) {
+    return {
+      valid: false,
+      error: 'batch-picking-limit must be a number between 1 and 1000'
+    }
+  }
+
+  return { valid: true }
+}
+
+// Validator for updating a setting
+async function validateBatchPickingLimitUpdate(
+  existingSetting: Setting,
+  patch: SettingPatch,
+  context: { domain: Domain; user: User }
+): Promise<SettingValidationResult> {
+  // Only validate if value is being updated
+  if (patch.value === undefined) {
+    return { valid: true }
+  }
+
+  return await validateBatchPickingLimit({ ...existingSetting, value: patch.value } as NewSetting, context)
+}
+
+// Register function
+export function registerOperatoWmsSettingValidators(): void {
+  settingValidatorRegistry.registerCreateValidator('batch-picking-limit', validateBatchPickingLimit)
+  settingValidatorRegistry.registerUpdateValidator('batch-picking-limit', validateBatchPickingLimitUpdate)
+}
+```
+
+### Step 2: Register Validators at Module Load Time
+
+**IMPORTANT**: Validators MUST be registered at module load time (when your application's server code is imported), NOT in bootstrap events. This ensures validators are registered before the GraphQL schema is built.
+
+In your application's server entry file (e.g., `packages/operato-wms/server/index.ts`):
+
+```typescript
+export * from './graphql'
+export * from './migrations'
+export * from './entities'
+
+import './routes'
+
+// Register setting validators at module load time (before schema is built)
+// This ensures validators are available when mutations are called
+import { registerOperatoWmsSettingValidators } from './validators/setting-validators'
+registerOperatoWmsSettingValidators()
+```
+
+**Why module load time?**
+
+- The GraphQL schema is built during server startup, before `bootstrap-module-start` event
+- Validators are called at runtime when mutations execute
+- Registering at module load ensures validators are ready before any mutations are called
+- No circular dependencies because `setting-base` doesn't import application packages
+
+## Usage Guide
+
+### Registering Validators
+
+#### Exact Name Matching
+
+Register validators for specific setting names:
+
+```typescript
+settingValidatorRegistry.registerCreateValidator('batch-picking-limit', validateBatchPickingLimit)
+settingValidatorRegistry.registerUpdateValidator('batch-picking-limit', validateBatchPickingLimitUpdate)
+```
+
+#### Pattern Matching
+
+For settings that follow a naming pattern, you can use pattern matching:
+
+```typescript
+// Register validators using regex pattern
+settingValidatorRegistry.registerPatternValidator(
+  /^rule-for-.*$/,
+  validateLocationSortingRule,
+  validateLocationSortingRule
+)
+
+// Or use a function for more complex matching
+settingValidatorRegistry.registerPatternValidator(
+  (name: string) => name.startsWith('enable-') || name.startsWith('disable-'),
+  validateBooleanSetting,
+  validateBooleanSetting
+)
+```
+
+### Complete Flow Example
+
+1. **Application Registers Validators**:
+
+   ```typescript
+   // packages/operato-wms/server/index.ts
+   import { registerOperatoWmsSettingValidators } from './validators/setting-validators'
+   registerOperatoWmsSettingValidators() // Module loads → validators registered
+   ```
+
+2. **Server Starts**:
+
+   ```typescript
+   // shell/server/server.ts
+   const builtSchema = await schema() // Schema built with SettingMutation resolver
+   ```
+
+3. **User Makes Request**:
+   ```typescript
+   // User calls: mutation { createSetting(setting: {...}) }
+   // setting-base/server/service/setting/setting-mutation.ts
+   async createSetting(...) {
+     await settingValidatorRegistry.validateCreate(setting, { domain, user })
+     // ↑ Calls registered validators from operato-wms
+   }
+   ```
+
+## Validator Types
+
+### SettingCreateValidator
+
+```typescript
+type SettingCreateValidator = (
+  setting: NewSetting,
+  context: { domain: Domain; user: User }
+) => Promise<SettingValidationResult> | SettingValidationResult
+```
+
+### SettingUpdateValidator
+
+```typescript
+type SettingUpdateValidator = (
+  setting: Setting,
+  patch: SettingPatch,
+  context: { domain: Domain; user: User }
+) => Promise<SettingValidationResult> | SettingValidationResult
+```
+
+### SettingValidationResult
+
+```typescript
+interface SettingValidationResult {
+  valid: boolean
+  error?: string // Error message if validation fails
+}
+```
+
+## Examples
+
+### Example 1: Validate JSON Format
+
+```typescript
+async function validateStackingOptionLimit(
+  setting: NewSetting,
+  context: { domain: Domain; user: User }
+): Promise<SettingValidationResult> {
+  if (!setting.value) {
+    return { valid: false, error: 'stacking-option-limit value is required' }
+  }
+
+  try {
+    const parsed = JSON.parse(setting.value)
+    if (typeof parsed.Min !== 'number' || typeof parsed.Max !== 'number') {
+      return {
+        valid: false,
+        error: 'stacking-option-limit must have Min and Max as numbers'
+      }
+    }
+    if (parsed.Min < 0 || parsed.Max < parsed.Min) {
+      return {
+        valid: false,
+        error: 'Min must be >= 0 and Max must be >= Min'
+      }
+    }
+  } catch (e) {
+    return {
+      valid: false,
+      error: 'stacking-option-limit must be valid JSON: { "Min": 1, "Max": 1 }'
+    }
+  }
+
+  return { valid: true }
+}
+```
+
+### Example 2: Validate Boolean Setting
+
+```typescript
+async function validateBooleanSetting(
+  setting: NewSetting,
+  context: { domain: Domain; user: User }
+): Promise<SettingValidationResult> {
+  if (setting.value && setting.value !== 'true' && setting.value !== 'false') {
+    return {
+      valid: false,
+      error: `${setting.name} must be "true" or "false"`
+    }
+  }
+  return { valid: true }
+}
+
+// Register for multiple boolean settings
+const booleanSettings = ['enable-bin-picking', 'enable-product-scanning', 'enable-beta-feature']
+booleanSettings.forEach(settingName => {
+  settingValidatorRegistry.registerCreateValidator(settingName, validateBooleanSetting)
+  settingValidatorRegistry.registerUpdateValidator(settingName, validateBooleanSetting)
+})
+```
+
+### Example 3: Validate Integer (No Decimals, No Negatives)
+
+```typescript
+async function validateMinimumSealNumber(
+  setting: NewSetting,
+  context: { domain: Domain; user: User }
+): Promise<SettingValidationResult> {
+  if (!setting.value) {
+    return { valid: false, error: 'minimum-seal-number value is required' }
+  }
+
+  // Check if value contains decimal point
+  if (setting.value.includes('.')) {
+    return {
+      valid: false,
+      error: 'minimum-seal-number must be an integer (no decimals allowed)'
+    }
+  }
+
+  const number = parseInt(setting.value, 10)
+
+  // Check if parsing resulted in NaN
+  if (isNaN(number)) {
+    return {
+      valid: false,
+      error: 'minimum-seal-number must be a valid number'
+    }
+  }
+
+  // Check if the parsed value matches the original string (to catch cases like "123abc")
+  if (number.toString() !== setting.value.trim()) {
+    return {
+      valid: false,
+      error: 'minimum-seal-number must be a valid integer'
+    }
+  }
+
+  // Check if negative
+  if (number < 0) {
+    return {
+      valid: false,
+      error: 'minimum-seal-number must be 0 or above (negative numbers not allowed)'
+    }
+  }
+
+  return { valid: true }
+}
+```
+
+### Example 4: Validate with Database Check
+
+```typescript
+import { getRepository } from 'typeorm'
+import { SomeEntity } from './entities'
+
+async function validateSettingWithDbCheck(
+  setting: NewSetting,
+  context: { domain: Domain; user: User }
+): Promise<SettingValidationResult> {
+  // Example: Check if referenced entity exists
+  if (setting.name === 'referenced-entity-id') {
+    const entity = await getRepository(SomeEntity).findOne({
+      where: { id: setting.value, domain: context.domain }
+    })
+
+    if (!entity) {
+      return {
+        valid: false,
+        error: `Referenced entity not found: ${setting.value}`
+      }
+    }
+  }
+
+  return { valid: true }
+}
+```
+
+## Best Practices
+
+1. **Keep validators focused**: Each validator should validate one specific aspect
+2. **Return clear error messages**: Help users understand what went wrong
+3. **Use pattern matching**: For settings that follow naming conventions
+4. **Register at module load time**: Ensure validators are registered before the application starts
+5. **Handle async operations**: Validators can be async if you need to check database or external services
+6. **Skip validation when not needed**: In update validators, check if the field being validated is actually being updated
+
+## Error Handling
+
+When validation fails, the mutation will throw an error with the message from `SettingValidationResult.error`. This error will be caught by GraphQL and returned to the client.
+
+Example error response:
+
+```json
+{
+  "errors": [
+    {
+      "message": "batch-picking-limit must be a number between 1 and 1000",
+      "extensions": {
+        "code": "INTERNAL_SERVER_ERROR"
+      }
+    }
+  ]
+}
+```
+
+## Testing
+
+You can test validators independently:
+
+```typescript
+// In operato-wms tests
+import { settingValidatorRegistry } from '@things-factory/setting-base'
+import { registerOperatoWmsSettingValidators } from '../validators/setting-validators'
+
+beforeAll(() => {
+  registerOperatoWmsSettingValidators()
+})
+
+test('validates batch-picking-limit', async () => {
+  const result = await settingValidatorRegistry.validateCreate(
+    { name: 'batch-picking-limit', value: '50', category: 'id-rule' },
+    { domain: mockDomain, user: mockUser }
+  )
+  // No error means validation passed
+  expect(result).toBeUndefined()
+})
+```
+
+## Troubleshooting
+
+### Common Mistakes to Avoid
+
+❌ **DON'T register in bootstrap-module-start**:
+
+```typescript
+// WRONG - too late!
+process.on('bootstrap-module-start', () => {
+  registerValidators() // Schema already built
+})
+```
+
+✅ **DO register at module load**:
+
+```typescript
+// CORRECT - before schema build
+import { registerValidators } from './validators'
+registerValidators() // Module loads first
+```
+
+❌ **DON'T import application packages in setting-base**:
+
+```typescript
+// WRONG - creates circular dependency!
+import { operatoWmsValidators } from '@things-factory/operato-wms'
+```
+
+✅ **DO let applications register themselves**:
+
+```typescript
+// CORRECT - applications register to shared registry
+// setting-base just exports the registry
+export { settingValidatorRegistry }
+```
+
+### Error: "Cannot read properties of undefined (reading 'registerCreateValidator')"
+
+This error occurs when `settingValidatorRegistry` is undefined. Make sure:
+
+1. You've imported from the correct path: `@things-factory/setting-base`
+2. The `setting-base` package has been rebuilt after adding the validator exports
+3. Your application has been rebuilt to pick up the updated `setting-base` exports
+
+### Validators Not Being Called
+
+If validators aren't being called:
+
+1. Verify validators are registered at module load time (not in bootstrap events)
+2. Check that the setting name matches exactly (case-sensitive)
+3. For pattern matching, verify the regex or function matches correctly
+4. Ensure the mutation is actually calling `settingValidatorRegistry.validateCreate()` or `validateUpdate()`
+
+## Migration Guide
+
+If you have existing validation logic in your application:
+
+1. Extract validation logic into validator functions
+2. Register validators at module load time in your server entry file
+3. Remove any custom validation from mutation hooks or middleware
+4. Test thoroughly to ensure validation still works
+
+## See Also
+
+- Example validators:
+  - `packages/operato-wms/server/validators/setting-validators.ts`
+  - `packages/operato-hub/server/validators/setting-validators.ts`

package/dist-server/service/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.schema = exports.entities = void 0;
+exports.schema = exports.entities = exports.settingValidatorRegistry = void 0;
 /* IMPORT ENTITIES AND RESOLVERS */
 const partner_setting_1 = require("./partner-setting");
 const setting_1 = require("./setting");
@@ -24,6 +24,9 @@ __exportStar(require("./setting/setting"), exports);
 /* EXPORT TYPES */
 __exportStar(require("./partner-setting/partner-setting-type"), exports);
 __exportStar(require("./setting/setting-type"), exports);
+/* EXPORT VALIDATOR REGISTRY */
+var setting_validator_1 = require("./setting/setting-validator");
+Object.defineProperty(exports, "settingValidatorRegistry", { enumerable: true, get: function () { return setting_validator_1.settingValidatorRegistry; } });
 exports.entities = [
     /* ENTITIES */
     ...partner_setting_1.entities,

package/dist-server/service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAmC;AACnC,uDAA4G;AAC5G,uCAAsF;AAEtF,yBAAyB;AACzB,oEAAiD;AACjD,oDAAiC;AAEjC,kBAAkB;AAClB,yEAAsD;AACtD,yDAAsC;AAEzB,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,GAAG,0BAAsB;IACzB,GAAG,kBAAe;CACnB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,GAAG,2BAAuB;QAC1B,GAAG,mBAAgB;KACpB;CACF,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAmC;AACnC,uDAA4G;AAC5G,uCAAsF;AAEtF,yBAAyB;AACzB,oEAAiD;AACjD,oDAAiC;AAEjC,kBAAkB;AAClB,yEAAsD;AACtD,yDAAsC;AAEtC,+BAA+B;AAC/B,iEAMoC;AALlC,6HAAA,wBAAwB,OAAA;AAOb,QAAA,QAAQ,GAAG;IACtB,cAAc;IACd,GAAG,0BAAsB;IACzB,GAAG,kBAAe;CACnB,CAAA;AAEY,QAAA,MAAM,GAAG;IACpB,eAAe,EAAE;QACf,sBAAsB;QACtB,GAAG,2BAAuB;QAC1B,GAAG,mBAAgB;KACpB;CACF,CAAA"}

package/dist-server/service/setting/index.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolvers = exports.entities = void 0;
+exports.settingValidatorRegistry = exports.resolvers = exports.entities = void 0;
 const setting_1 = require("./setting");
 const setting_query_1 = require("./setting-query");
 const setting_mutation_1 = require("./setting-mutation");
 exports.entities = [setting_1.Setting];
 exports.resolvers = [setting_query_1.SettingQuery, setting_mutation_1.SettingMutation];
+// Export validator registry and types for applications to use
+var setting_validator_1 = require("./setting-validator");
+Object.defineProperty(exports, "settingValidatorRegistry", { enumerable: true, get: function () { return setting_validator_1.settingValidatorRegistry; } });
 //# sourceMappingURL=index.js.map

package/dist-server/service/setting/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/setting/index.ts"],"names":[],"mappings":";;;AAAA,uCAAmC;AACnC,mDAA8C;AAC9C,yDAAoD;AAEvC,QAAA,QAAQ,GAAG,CAAC,iBAAO,CAAC,CAAA;AACpB,QAAA,SAAS,GAAG,CAAC,4BAAY,EAAE,kCAAe,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/setting/index.ts"],"names":[],"mappings":";;;AAAA,uCAAmC;AACnC,mDAA8C;AAC9C,yDAAoD;AAEvC,QAAA,QAAQ,GAAG,CAAC,iBAAO,CAAC,CAAA;AACpB,QAAA,SAAS,GAAG,CAAC,4BAAY,EAAE,kCAAe,CAAC,CAAA;AAExD,8DAA8D;AAC9D,yDAM4B;AAL1B,6HAAA,wBAAwB,OAAA"}

package/dist-server/service/setting/setting-mutation.js

@@ -17,16 +17,24 @@ const type_graphql_1 = require("type-graphql");
 const typeorm_1 = require("typeorm");
 const setting_1 = require("./setting");
 const setting_type_1 = require("./setting-type");
+const setting_validator_1 = require("./setting-validator");
 let SettingMutation = class SettingMutation {
     async createSetting(setting, context) {
         const { tx, domain, user } = context.state;
+        // Validate before creating
+        await setting_validator_1.settingValidatorRegistry.validateCreate(setting, { domain, user });
         return await tx.getRepository(setting_1.Setting).save(Object.assign(Object.assign({ domain }, setting), { creator: user, updater: user }));
     }
     async updateSetting(name, patch, context) {
         const { tx, domain, user } = context.state;
         const repository = tx.getRepository(setting_1.Setting);
         const setting = await repository.findOne({ domain, name });
-        return await repository.save(Object.assign(Object.assign(Object.assign({ creater: user }, setting), patch), { domain, updater: user }));
+        if (!setting) {
+            throw new Error(`Setting not found: ${name}`);
+        }
+        // Validate before updating
+        await setting_validator_1.settingValidatorRegistry.validateUpdate(setting, patch, { domain, user });
+        return await repository.save(Object.assign(Object.assign(Object.assign({ creator: user }, setting), patch), { domain, updater: user }));
     }
     async updateMultipleSetting(patches, context) {
         const { tx, domain, user } = context.state;
@@ -37,14 +45,35 @@ let SettingMutation = class SettingMutation {
         if (_createRecords.length > 0) {
             for (let i = 0; i < _createRecords.length; i++) {
                 const newRecord = _createRecords[i];
+                // Validate before creating - ensure required fields are present
+                if (newRecord.name && newRecord.category) {
+                    await setting_validator_1.settingValidatorRegistry.validateCreate({
+                        name: newRecord.name,
+                        description: newRecord.description,
+                        category: newRecord.category,
+                        value: newRecord.value
+                    }, { domain, user });
+                }
                 const result = await settingRepo.save(Object.assign({ domain, creator: user, updater: user }, newRecord));
                 results.push(Object.assign(Object.assign({}, result), { cuFlag: '+' }));
             }
         }
         if (_updateRecords.length > 0) {
+            // Load all existing settings first
+            const settingIds = _updateRecords.map((record) => record.id).filter(Boolean);
+            const existingSettingsList = settingIds.length > 0 ? await settingRepo.findByIds(settingIds) : [];
+            const existingSettingsMap = new Map(existingSettingsList.map((s) => [s.id, s]));
+            // Batch validation: validate all patches together before individual validation
+            // This prevents race conditions when multiple related settings are updated simultaneously
+            await setting_validator_1.settingValidatorRegistry.validateBatch(_updateRecords, existingSettingsMap, { domain, user });
             for (let i = 0; i < _updateRecords.length; i++) {
                 const newRecord = _updateRecords[i];
-                const setting = await settingRepo.findOne({ id: newRecord.id });
+                const setting = existingSettingsMap.get(newRecord.id);
+                if (!setting) {
+                    throw new Error(`Setting not found: ${newRecord.id}`);
+                }
+                // Validate before updating (individual validators)
+                await setting_validator_1.settingValidatorRegistry.validateUpdate(setting, newRecord, { domain, user });
                 const result = await settingRepo.save(Object.assign(Object.assign(Object.assign({}, setting), newRecord), { updater: user }));
                 results.push(Object.assign(Object.assign({}, result), { cuFlag: 'M' }));
             }

package/dist-server/service/setting/setting-mutation.js.map

@@ -1 +1 @@
-{"version":3,"file":"setting-mutation.js","sourceRoot":"","sources":["../../../server/service/setting/setting-mutation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"setting-mutation.js","sourceRoot":"","sources":["../../../server/service/setting/setting-mutation.ts"],"names":[],"mappings":"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"}

package/dist-server/service/setting/setting-validator.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingValidatorRegistry = void 0;
+/**
+ * Validator registry that stores validators by setting name
+ */
+class SettingValidatorRegistry {
+    constructor() {
+        this.createValidators = new Map();
+        this.updateValidators = new Map();
+        this.batchValidators = [];
+        this.patternCreateValidators = [];
+        this.patternUpdateValidators = [];
+    }
+    /**
+     * Register a validator for a specific setting name
+     * @param settingName - The name of the setting to validate
+     * @param validator - The validator function for create operations
+     */
+    registerCreateValidator(settingName, validator) {
+        if (!this.createValidators.has(settingName)) {
+            this.createValidators.set(settingName, []);
+        }
+        this.createValidators.get(settingName).push(validator);
+    }
+    /**
+     * Register a validator for a specific setting name
+     * @param settingName - The name of the setting to validate
+     * @param validator - The validator function for update operations
+     */
+    registerUpdateValidator(settingName, validator) {
+        if (!this.updateValidators.has(settingName)) {
+            this.updateValidators.set(settingName, []);
+        }
+        this.updateValidators.get(settingName).push(validator);
+    }
+    /**
+     * Register validators for multiple setting names using a pattern
+     * @param pattern - Regex pattern or function to match setting names
+     * @param createValidator - Validator for create operations (optional)
+     * @param updateValidator - Validator for update operations (optional)
+     */
+    registerPatternValidator(pattern, createValidator, updateValidator) {
+        // Store pattern validators separately for matching
+        if (createValidator) {
+            // For pattern matching, we'll check during validation
+            this.patternCreateValidators.push({ pattern, validator: createValidator });
+        }
+        if (updateValidator) {
+            this.patternUpdateValidators.push({ pattern, validator: updateValidator });
+        }
+    }
+    /**
+     * Get all validators for a setting name (exact match + pattern matches)
+     */
+    getCreateValidators(settingName) {
+        const validators = [];
+        // Add exact match validators
+        const exactValidators = this.createValidators.get(settingName);
+        if (exactValidators) {
+            validators.push(...exactValidators);
+        }
+        // Add pattern match validators
+        for (const { pattern, validator } of this.patternCreateValidators) {
+            const matches = pattern instanceof RegExp ? pattern.test(settingName) : pattern(settingName);
+            if (matches) {
+                validators.push(validator);
+            }
+        }
+        return validators;
+    }
+    /**
+     * Get all validators for a setting name (exact match + pattern matches)
+     */
+    getUpdateValidators(settingName) {
+        const validators = [];
+        // Add exact match validators
+        const exactValidators = this.updateValidators.get(settingName);
+        if (exactValidators) {
+            validators.push(...exactValidators);
+        }
+        // Add pattern match validators
+        for (const { pattern, validator } of this.patternUpdateValidators) {
+            const matches = pattern instanceof RegExp ? pattern.test(settingName) : pattern(settingName);
+            if (matches) {
+                validators.push(validator);
+            }
+        }
+        return validators;
+    }
+    /**
+     * Validate a setting before creation
+     */
+    async validateCreate(setting, context) {
+        const validators = this.getCreateValidators(setting.name);
+        for (const validator of validators) {
+            const result = await validator(setting, context);
+            if (!result.valid) {
+                throw new Error(result.error || `Validation failed for setting: ${setting.name}`);
+            }
+        }
+    }
+    /**
+     * Register a batch validator for validating multiple settings together
+     * @param validator - The batch validator function
+     */
+    registerBatchValidator(validator) {
+        this.batchValidators.push(validator);
+    }
+    /**
+     * Validate multiple settings together before update
+     * This is useful for cross-validation between related settings
+     */
+    async validateBatch(patches, existingSettings, context) {
+        for (const validator of this.batchValidators) {
+            const result = await validator(patches, existingSettings, context);
+            if (!result.valid) {
+                throw new Error(result.error || 'Batch validation failed');
+            }
+        }
+    }
+    /**
+     * Validate a setting before update
+     */
+    async validateUpdate(setting, patch, context) {
+        const validators = this.getUpdateValidators(setting.name);
+        for (const validator of validators) {
+            const result = await validator(setting, patch, context);
+            if (!result.valid) {
+                throw new Error(result.error || `Validation failed for setting: ${setting.name}`);
+            }
+        }
+    }
+}
+// Export singleton instance
+exports.settingValidatorRegistry = new SettingValidatorRegistry();
+//# sourceMappingURL=setting-validator.js.map

package/dist-server/service/setting/setting-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-validator.js","sourceRoot":"","sources":["../../../server/service/setting/setting-validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/setting-base",
-  "version": "4.3.752",
+  "version": "4.3.764",
   "main": "dist-server/index.js",
   "browser": "client/index.js",
   "things-factory": true,
@@ -23,8 +23,8 @@
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create -d ./server/migrations"
   },
   "dependencies": {
-    "@things-factory/auth-base": "^4.3.752",
-    "@things-factory/code-base": "^4.3.752"
+    "@things-factory/auth-base": "^4.3.764",
+    "@things-factory/code-base": "^4.3.764"
   },
-  "gitHead": "cc2f8abfd00055dfbd1737e3016fe4a464af2548"
+  "gitHead": "4dd8055a25e773814603c4be21fc70930d0cfb13"
 }

package/server/service/index.ts

@@ -10,6 +10,15 @@ export * from './setting/setting'
 export * from './partner-setting/partner-setting-type'
 export * from './setting/setting-type'
 
+/* EXPORT VALIDATOR REGISTRY */
+export {
+  settingValidatorRegistry,
+  SettingValidationResult,
+  SettingCreateValidator,
+  SettingUpdateValidator,
+  SettingBatchValidator
+} from './setting/setting-validator'
+
 export const entities = [
   /* ENTITIES */
   ...PartnerSettingEntities,

package/server/service/setting/index.ts

@@ -4,3 +4,12 @@ import { SettingMutation } from './setting-mutation'
 
 export const entities = [Setting]
 export const resolvers = [SettingQuery, SettingMutation]
+
+// Export validator registry and types for applications to use
+export {
+  settingValidatorRegistry,
+  SettingValidationResult,
+  SettingCreateValidator,
+  SettingUpdateValidator,
+  SettingBatchValidator
+} from './setting-validator'

package/server/service/setting/setting-mutation.ts

@@ -4,6 +4,7 @@ import { Domain } from '@things-factory/shell'
 import { User } from '@things-factory/auth-base'
 import { Setting } from './setting'
 import { NewSetting, SettingPatch } from './setting-type'
+import { settingValidatorRegistry } from './setting-validator'
 
 @Resolver(Setting)
 export class SettingMutation {
@@ -12,6 +13,10 @@ export class SettingMutation {
   @Mutation(returns => Setting, { description: 'To create new Setting' })
   async createSetting(@Arg('setting') setting: NewSetting, @Ctx() context: any): Promise<Setting> {
     const { tx, domain, user }: { tx: EntityManager; domain: Domain; user: User } = context.state
+
+    // Validate before creating
+    await settingValidatorRegistry.validateCreate(setting, { domain, user })
+
     return await tx.getRepository(Setting).save({
       domain,
       ...setting,
@@ -33,8 +38,15 @@ export class SettingMutation {
     const repository = tx.getRepository(Setting)
     const setting = await repository.findOne({ domain, name })
 
+    if (!setting) {
+      throw new Error(`Setting not found: ${name}`)
+    }
+
+    // Validate before updating
+    await settingValidatorRegistry.validateUpdate(setting, patch, { domain, user })
+
     return await repository.save({
-      creater: user,
+      creator: user,
       ...setting,
       ...patch,
       domain,
@@ -60,6 +72,19 @@ export class SettingMutation {
       for (let i = 0; i < _createRecords.length; i++) {
         const newRecord = _createRecords[i]
 
+        // Validate before creating - ensure required fields are present
+        if (newRecord.name && newRecord.category) {
+          await settingValidatorRegistry.validateCreate(
+            {
+              name: newRecord.name,
+              description: newRecord.description,
+              category: newRecord.category,
+              value: newRecord.value
+            },
+            { domain, user }
+          )
+        }
+
         const result = await settingRepo.save({
           domain,
           creator: user,
@@ -72,9 +97,25 @@ export class SettingMutation {
     }
 
     if (_updateRecords.length > 0) {
+      // Load all existing settings first
+      const settingIds = _updateRecords.map((record: any) => record.id).filter(Boolean)
+      const existingSettingsList = settingIds.length > 0 ? await settingRepo.findByIds(settingIds) : []
+      const existingSettingsMap = new Map(existingSettingsList.map((s: Setting) => [s.id, s]))
+
+      // Batch validation: validate all patches together before individual validation
+      // This prevents race conditions when multiple related settings are updated simultaneously
+      await settingValidatorRegistry.validateBatch(_updateRecords, existingSettingsMap, { domain, user })
+
       for (let i = 0; i < _updateRecords.length; i++) {
         const newRecord = _updateRecords[i]
-        const setting = await settingRepo.findOne({ id: newRecord.id })
+        const setting = existingSettingsMap.get(newRecord.id)
+
+        if (!setting) {
+          throw new Error(`Setting not found: ${newRecord.id}`)
+        }
+
+        // Validate before updating (individual validators)
+        await settingValidatorRegistry.validateUpdate(setting, newRecord, { domain, user })
 
         const result = await settingRepo.save({
           ...setting,

package/server/service/setting/setting-validator.ts

@@ -0,0 +1,203 @@
+import { Domain } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { NewSetting, SettingPatch } from './setting-type'
+import { Setting } from './setting'
+
+/**
+ * Validation result returned by validators
+ */
+export interface SettingValidationResult {
+  valid: boolean
+  error?: string
+}
+
+/**
+ * Validator function type for creating settings
+ */
+export type SettingCreateValidator = (
+  setting: NewSetting,
+  context: { domain: Domain; user: User }
+) => Promise<SettingValidationResult> | SettingValidationResult
+
+/**
+ * Validator function type for updating settings
+ */
+export type SettingUpdateValidator = (
+  setting: Setting,
+  patch: SettingPatch,
+  context: { domain: Domain; user: User }
+) => Promise<SettingValidationResult> | SettingValidationResult
+
+/**
+ * Batch validator function type for validating multiple settings together
+ */
+export type SettingBatchValidator = (
+  patches: SettingPatch[],
+  existingSettings: Map<string, Setting>,
+  context: { domain: Domain; user: User }
+) => Promise<SettingValidationResult> | SettingValidationResult
+
+/**
+ * Validator registry that stores validators by setting name
+ */
+class SettingValidatorRegistry {
+  private createValidators: Map<string, SettingCreateValidator[]> = new Map()
+  private updateValidators: Map<string, SettingUpdateValidator[]> = new Map()
+  private batchValidators: SettingBatchValidator[] = []
+
+  /**
+   * Register a validator for a specific setting name
+   * @param settingName - The name of the setting to validate
+   * @param validator - The validator function for create operations
+   */
+  registerCreateValidator(settingName: string, validator: SettingCreateValidator): void {
+    if (!this.createValidators.has(settingName)) {
+      this.createValidators.set(settingName, [])
+    }
+    this.createValidators.get(settingName)!.push(validator)
+  }
+
+  /**
+   * Register a validator for a specific setting name
+   * @param settingName - The name of the setting to validate
+   * @param validator - The validator function for update operations
+   */
+  registerUpdateValidator(settingName: string, validator: SettingUpdateValidator): void {
+    if (!this.updateValidators.has(settingName)) {
+      this.updateValidators.set(settingName, [])
+    }
+    this.updateValidators.get(settingName)!.push(validator)
+  }
+
+  /**
+   * Register validators for multiple setting names using a pattern
+   * @param pattern - Regex pattern or function to match setting names
+   * @param createValidator - Validator for create operations (optional)
+   * @param updateValidator - Validator for update operations (optional)
+   */
+  registerPatternValidator(
+    pattern: RegExp | ((name: string) => boolean),
+    createValidator?: SettingCreateValidator,
+    updateValidator?: SettingUpdateValidator
+  ): void {
+    // Store pattern validators separately for matching
+    if (createValidator) {
+      // For pattern matching, we'll check during validation
+      this.patternCreateValidators.push({ pattern, validator: createValidator })
+    }
+    if (updateValidator) {
+      this.patternUpdateValidators.push({ pattern, validator: updateValidator })
+    }
+  }
+
+  private patternCreateValidators: Array<{
+    pattern: RegExp | ((name: string) => boolean)
+    validator: SettingCreateValidator
+  }> = []
+  private patternUpdateValidators: Array<{
+    pattern: RegExp | ((name: string) => boolean)
+    validator: SettingUpdateValidator
+  }> = []
+
+  /**
+   * Get all validators for a setting name (exact match + pattern matches)
+   */
+  getCreateValidators(settingName: string): SettingCreateValidator[] {
+    const validators: SettingCreateValidator[] = []
+
+    // Add exact match validators
+    const exactValidators = this.createValidators.get(settingName)
+    if (exactValidators) {
+      validators.push(...exactValidators)
+    }
+
+    // Add pattern match validators
+    for (const { pattern, validator } of this.patternCreateValidators) {
+      const matches = pattern instanceof RegExp ? pattern.test(settingName) : pattern(settingName)
+      if (matches) {
+        validators.push(validator)
+      }
+    }
+
+    return validators
+  }
+
+  /**
+   * Get all validators for a setting name (exact match + pattern matches)
+   */
+  getUpdateValidators(settingName: string): SettingUpdateValidator[] {
+    const validators: SettingUpdateValidator[] = []
+
+    // Add exact match validators
+    const exactValidators = this.updateValidators.get(settingName)
+    if (exactValidators) {
+      validators.push(...exactValidators)
+    }
+
+    // Add pattern match validators
+    for (const { pattern, validator } of this.patternUpdateValidators) {
+      const matches = pattern instanceof RegExp ? pattern.test(settingName) : pattern(settingName)
+      if (matches) {
+        validators.push(validator)
+      }
+    }
+
+    return validators
+  }
+
+  /**
+   * Validate a setting before creation
+   */
+  async validateCreate(setting: NewSetting, context: { domain: Domain; user: User }): Promise<void> {
+    const validators = this.getCreateValidators(setting.name)
+
+    for (const validator of validators) {
+      const result = await validator(setting, context)
+      if (!result.valid) {
+        throw new Error(result.error || `Validation failed for setting: ${setting.name}`)
+      }
+    }
+  }
+
+  /**
+   * Register a batch validator for validating multiple settings together
+   * @param validator - The batch validator function
+   */
+  registerBatchValidator(validator: SettingBatchValidator): void {
+    this.batchValidators.push(validator)
+  }
+
+  /**
+   * Validate multiple settings together before update
+   * This is useful for cross-validation between related settings
+   */
+  async validateBatch(
+    patches: SettingPatch[],
+    existingSettings: Map<string, Setting>,
+    context: { domain: Domain; user: User }
+  ): Promise<void> {
+    for (const validator of this.batchValidators) {
+      const result = await validator(patches, existingSettings, context)
+      if (!result.valid) {
+        throw new Error(result.error || 'Batch validation failed')
+      }
+    }
+  }
+
+  /**
+   * Validate a setting before update
+   */
+  async validateUpdate(setting: Setting, patch: SettingPatch, context: { domain: Domain; user: User }): Promise<void> {
+    const validators = this.getUpdateValidators(setting.name)
+
+    for (const validator of validators) {
+      const result = await validator(setting, patch, context)
+      if (!result.valid) {
+        throw new Error(result.error || `Validation failed for setting: ${setting.name}`)
+      }
+    }
+  }
+}
+
+// Export singleton instance
+export const settingValidatorRegistry = new SettingValidatorRegistry()