@explorins/pers-shared 2.1.91 → 2.1.93

package/dist/cjs/index.d.ts

@@ -2,6 +2,7 @@ export * from './shared-lib/enum';
 export * from './shared-lib/interfaces';
 export * from './shared-lib/types';
 export type * from './shared-lib/dto';
+export * from './shared-lib/decorators';
 export * from '@explorins/web3-types';
 export type * from './shared-lib/errors';
 export { type StructuredError, ErrorCategory } from './shared-lib/errors/base/error-classification-enums';

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,uBAAuB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC"}

package/dist/cjs/index.js

@@ -21,6 +21,8 @@ exports.ErrorCategory = void 0;
 __exportStar(require("./shared-lib/enum"), exports);
 __exportStar(require("./shared-lib/interfaces"), exports);
 __exportStar(require("./shared-lib/types"), exports);
+// Decorators - Validation decorators for DTO handling (Zapier/automation tool compatibility)
+__exportStar(require("./shared-lib/decorators"), exports);
 // Re-export web3 types for convenience
 __exportStar(require("@explorins/web3-types"), exports);
 var error_classification_enums_1 = require("./shared-lib/errors/base/error-classification-enums");

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,oDAAkC;AAClC,0DAAwC;AACxC,qDAAmC;AAGnC,uCAAuC;AACvC,wDAAsC;AAItC,kGAA0G;AAA3E,2HAAA,aAAa,OAAA;AAE5C,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,oDAAkC;AAClC,0DAAwC;AACxC,qDAAmC;AAGnC,6FAA6F;AAC7F,0DAAwC;AAExC,uCAAuC;AACvC,wDAAsC;AAItC,kGAA0G;AAA3E,2HAAA,aAAa,OAAA;AAE5C,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}

package/dist/cjs/shared-lib/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export * from './validation.decorators';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/shared-lib/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/cjs/shared-lib/decorators/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./validation.decorators"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/shared-lib/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC"}

package/dist/cjs/shared-lib/decorators/validation.decorators.d.ts

@@ -0,0 +1,231 @@
+import { TransformFnParams } from 'class-transformer';
+/**
+ * =============================================================================
+ * OPTIONAL FIELD VALIDATION DECORATORS
+ * =============================================================================
+ *
+ * These decorators handle empty values from automation tools (Zapier, forms, etc.)
+ * that send "" instead of omitting optional fields.
+ *
+ * DECISION TREE - Which decorator to use?
+ * ────────────────────────────────────────
+ *
+ * Is this for CREATE or UPDATE?
+ * │
+ * ├─ CREATE → Empty "" should be STRIPPED (field not set)
+ * │   ├─ String/UUID/Email field → @OptionalStrip()
+ * │   └─ Number field           → @OptionalStripNumber()
+ * │
+ * └─ UPDATE → Empty "" should NULLIFY the field (set to null)
+ *     ├─ String/UUID/Email field → @OptionalNullify()
+ *     └─ Number field           → @OptionalNullifyNumber()
+ *
+ *
+ * BEHAVIOR COMPARISON
+ * ───────────────────
+ *
+ * | Input      | @OptionalStrip   | @OptionalNullify    |
+ * |------------|------------------|---------------------|
+ * | ""         | undefined        | null                |
+ * | null       | undefined        | null                |
+ * | "hello"    | "hello"          | "hello"             |
+ * | "123"      | 123 (if Number)  | 123 (if Number)     |
+ * | not sent   | undefined        | undefined           |
+ *
+ *
+ * EXAMPLES
+ * ────────
+ *
+ * CREATE DTO:
+ * ```typescript
+ * @OptionalStrip()
+ * @IsString()
+ * name?: string;
+ *
+ * @OptionalStripNumber()
+ * @IsNumber()
+ * multiplier?: number;
+ * ```
+ *
+ * UPDATE DTO:
+ * ```typescript
+ * @OptionalNullify()
+ * @IsString()
+ * description?: string | null;
+ *
+ * @OptionalNullifyNumber()
+ * @IsNumber()
+ * latitude?: number | null;
+ * ```
+ */
+/**
+ * Transform function: empty string → null
+ *
+ * Use for UPDATE operations where empty string should CLEAR the field (set to null).
+ *
+ * Behavior:
+ * - "" → null (clear the field)
+ * - null → null (already null)
+ * - undefined → undefined (field unchanged, not sent to DB)
+ * - "value" → "value" (preserved)
+ *
+ * @example
+ * ```typescript
+ * @IsOptional()
+ * @Transform(emptyToNull)
+ * @ValidateIf((o, v) => v !== null)
+ * @IsString()
+ * name?: string | null;
+ * ```
+ */
+export declare const emptyToNull: ({ value }: TransformFnParams) => any;
+/**
+ * Transform function: empty/null/whitespace → undefined
+ *
+ * Use for CREATE operations where empty values should be IGNORED (stripped).
+ *
+ * Behavior:
+ * - "" → undefined (stripped)
+ * - null → undefined (stripped)
+ * - "   " → undefined (whitespace stripped)
+ * - undefined → undefined (already absent)
+ * - "value" → "value" (preserved)
+ */
+export declare const emptyToUndefined: ({ value }: TransformFnParams) => any;
+/**
+ * Transform function: empty → undefined, string numbers → parsed numbers
+ *
+ * Use for number fields in CREATE operations.
+ *
+ * Behavior:
+ * - "" → undefined (stripped)
+ * - null → undefined (stripped)
+ * - "   " → undefined (whitespace stripped)
+ * - "123" → 123 (parsed to number)
+ * - "42.5" → 42.5 (parsed to float)
+ * - 123 → 123 (already number)
+ */
+export declare const emptyToUndefinedNumber: ({ value }: TransformFnParams) => any;
+/**
+ * @OptionalStrip - Strips empty values for CREATE operations (string/general fields)
+ *
+ * Combines @IsOptional() with empty value stripping.
+ * Empty values are converted to undefined (field is ignored).
+ *
+ * Use Case: CREATE operations where empty strings from Zapier/forms should be ignored.
+ *
+ * Behavior:
+ * - "" → undefined (stripped, validation passes)
+ * - null → undefined (stripped, validation passes)
+ * - "   " → undefined (whitespace stripped, validation passes)
+ * - undefined → undefined (already absent, validation passes)
+ * - "value" → "value" (preserved, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalStrip()
+ * @IsString()
+ * name?: string;
+ *
+ * @OptionalStrip()
+ * @IsUUID()
+ * referenceId?: string;
+ * ```
+ */
+export declare function OptionalStrip(): PropertyDecorator;
+/**
+ * @OptionalStripNumber - Strips empty values for number fields in CREATE operations
+ *
+ * Combines @IsOptional() with:
+ * 1. Empty value stripping (empty strings, null, whitespace → undefined)
+ * 2. String number parsing ("123" → 123)
+ *
+ * Use Case: CREATE operations where Zapier sends "" or "42.5" for number fields.
+ *
+ * Behavior:
+ * - "" → undefined (stripped, validation passes)
+ * - null → undefined (stripped, validation passes)
+ * - "   " → undefined (whitespace stripped, validation passes)
+ * - "123" → 123 (parsed to number, validation runs)
+ * - "42.5" → 42.5 (parsed to float, validation runs)
+ * - 123 → 123 (already number, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalStripNumber()
+ * @IsNumber()
+ * multiplier?: number;
+ * ```
+ */
+export declare function OptionalStripNumber(): PropertyDecorator;
+/**
+ * @OptionalNullify - Nullifies empty values for UPDATE operations (nullable fields)
+ *
+ * Combines @IsOptional(), @Transform(emptyToNull), and @ValidateIf for nullable fields.
+ * Empty strings are converted to null (field is explicitly cleared in DB).
+ *
+ * Use Case: UPDATE operations where "" should CLEAR the field (set to null).
+ *
+ * Behavior:
+ * - "" → null (clear field in DB)
+ * - null → null (clear field in DB)
+ * - undefined → undefined (field not updated)
+ * - "value" → "value" (preserved, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalNullify()
+ * @IsString()
+ * description?: string | null;
+ *
+ * @OptionalNullify()
+ * @IsUrl()
+ * imageUrl?: string | null;
+ * ```
+ */
+export declare function OptionalNullify(): PropertyDecorator;
+/**
+ * Transform function: empty → null, string numbers → parsed numbers
+ *
+ * Use for number fields in UPDATE operations.
+ *
+ * Behavior:
+ * - "" → null (clear field in DB)
+ * - null → null (clear field in DB)
+ * - "   " → null (whitespace → null)
+ * - undefined → undefined (field not updated)
+ * - "123" → 123 (parsed to number)
+ * - "42.5" → 42.5 (parsed to float)
+ * - 123 → 123 (already number)
+ */
+export declare const emptyToNullNumber: ({ value }: TransformFnParams) => any;
+/**
+ * @OptionalNullifyNumber - Nullifies empty values for number fields in UPDATE operations
+ *
+ * Combines @IsOptional(), empty-to-null transform, and string-to-number parsing.
+ * Empty strings are converted to null (field is explicitly cleared in DB).
+ *
+ * Use Case: UPDATE operations where "" should CLEAR the number field (set to null).
+ *
+ * Behavior:
+ * - "" → null (clear field in DB)
+ * - null → null (clear field in DB)
+ * - "   " → null (whitespace → null)
+ * - undefined → undefined (field not updated)
+ * - "123" → 123 (parsed to number, validation runs)
+ * - "42.5" → 42.5 (parsed to float, validation runs)
+ * - 123 → 123 (already number, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalNullifyNumber()
+ * @IsNumber()
+ * latitude?: number | null;
+ *
+ * @OptionalNullifyNumber()
+ * @IsNumber()
+ * order?: number | null;
+ * ```
+ */
+export declare function OptionalNullifyNumber(): PropertyDecorator;
+//# sourceMappingURL=validation.decorators.d.ts.map

package/dist/cjs/shared-lib/decorators/validation.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.decorators.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/decorators/validation.decorators.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAMH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,iBAAiB,QAC3B,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,iBAAiB,QAK5D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,GAAI,WAAW,iBAAiB,QASlE,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAKjD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CAKvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAMnD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,iBAAiB,QAS7D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAMzD"}

package/dist/cjs/shared-lib/decorators/validation.decorators.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyToNullNumber = exports.emptyToUndefinedNumber = exports.emptyToUndefined = exports.emptyToNull = void 0;
+exports.OptionalStrip = OptionalStrip;
+exports.OptionalStripNumber = OptionalStripNumber;
+exports.OptionalNullify = OptionalNullify;
+exports.OptionalNullifyNumber = OptionalNullifyNumber;
+const common_1 = require("@nestjs/common");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+/**
+ * =============================================================================
+ * OPTIONAL FIELD VALIDATION DECORATORS
+ * =============================================================================
+ *
+ * These decorators handle empty values from automation tools (Zapier, forms, etc.)
+ * that send "" instead of omitting optional fields.
+ *
+ * DECISION TREE - Which decorator to use?
+ * ────────────────────────────────────────
+ *
+ * Is this for CREATE or UPDATE?
+ * │
+ * ├─ CREATE → Empty "" should be STRIPPED (field not set)
+ * │   ├─ String/UUID/Email field → @OptionalStrip()
+ * │   └─ Number field           → @OptionalStripNumber()
+ * │
+ * └─ UPDATE → Empty "" should NULLIFY the field (set to null)
+ *     ├─ String/UUID/Email field → @OptionalNullify()
+ *     └─ Number field           → @OptionalNullifyNumber()
+ *
+ *
+ * BEHAVIOR COMPARISON
+ * ───────────────────
+ *
+ * | Input      | @OptionalStrip   | @OptionalNullify    |
+ * |------------|------------------|---------------------|
+ * | ""         | undefined        | null                |
+ * | null       | undefined        | null                |
+ * | "hello"    | "hello"          | "hello"             |
+ * | "123"      | 123 (if Number)  | 123 (if Number)     |
+ * | not sent   | undefined        | undefined           |
+ *
+ *
+ * EXAMPLES
+ * ────────
+ *
+ * CREATE DTO:
+ * ```typescript
+ * @OptionalStrip()
+ * @IsString()
+ * name?: string;
+ *
+ * @OptionalStripNumber()
+ * @IsNumber()
+ * multiplier?: number;
+ * ```
+ *
+ * UPDATE DTO:
+ * ```typescript
+ * @OptionalNullify()
+ * @IsString()
+ * description?: string | null;
+ *
+ * @OptionalNullifyNumber()
+ * @IsNumber()
+ * latitude?: number | null;
+ * ```
+ */
+// =============================================================================
+// TRANSFORMS - Low-level transform functions for class-transformer
+// =============================================================================
+/**
+ * Transform function: empty string → null
+ *
+ * Use for UPDATE operations where empty string should CLEAR the field (set to null).
+ *
+ * Behavior:
+ * - "" → null (clear the field)
+ * - null → null (already null)
+ * - undefined → undefined (field unchanged, not sent to DB)
+ * - "value" → "value" (preserved)
+ *
+ * @example
+ * ```typescript
+ * @IsOptional()
+ * @Transform(emptyToNull)
+ * @ValidateIf((o, v) => v !== null)
+ * @IsString()
+ * name?: string | null;
+ * ```
+ */
+const emptyToNull = ({ value }) => value === '' ? null : value;
+exports.emptyToNull = emptyToNull;
+/**
+ * Transform function: empty/null/whitespace → undefined
+ *
+ * Use for CREATE operations where empty values should be IGNORED (stripped).
+ *
+ * Behavior:
+ * - "" → undefined (stripped)
+ * - null → undefined (stripped)
+ * - "   " → undefined (whitespace stripped)
+ * - undefined → undefined (already absent)
+ * - "value" → "value" (preserved)
+ */
+const emptyToUndefined = ({ value }) => {
+    if (value === '' || value === null || (typeof value === 'string' && value.trim() === '')) {
+        return undefined;
+    }
+    return value;
+};
+exports.emptyToUndefined = emptyToUndefined;
+/**
+ * Transform function: empty → undefined, string numbers → parsed numbers
+ *
+ * Use for number fields in CREATE operations.
+ *
+ * Behavior:
+ * - "" → undefined (stripped)
+ * - null → undefined (stripped)
+ * - "   " → undefined (whitespace stripped)
+ * - "123" → 123 (parsed to number)
+ * - "42.5" → 42.5 (parsed to float)
+ * - 123 → 123 (already number)
+ */
+const emptyToUndefinedNumber = ({ value }) => {
+    if (value === '' || value === null || (typeof value === 'string' && value.trim() === '')) {
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        const parsed = parseFloat(value);
+        return isNaN(parsed) ? value : parsed;
+    }
+    return value;
+};
+exports.emptyToUndefinedNumber = emptyToUndefinedNumber;
+// =============================================================================
+// COMBINED DECORATORS - High-level decorators for common patterns
+// =============================================================================
+/**
+ * @OptionalStrip - Strips empty values for CREATE operations (string/general fields)
+ *
+ * Combines @IsOptional() with empty value stripping.
+ * Empty values are converted to undefined (field is ignored).
+ *
+ * Use Case: CREATE operations where empty strings from Zapier/forms should be ignored.
+ *
+ * Behavior:
+ * - "" → undefined (stripped, validation passes)
+ * - null → undefined (stripped, validation passes)
+ * - "   " → undefined (whitespace stripped, validation passes)
+ * - undefined → undefined (already absent, validation passes)
+ * - "value" → "value" (preserved, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalStrip()
+ * @IsString()
+ * name?: string;
+ *
+ * @OptionalStrip()
+ * @IsUUID()
+ * referenceId?: string;
+ * ```
+ */
+function OptionalStrip() {
+    return (0, common_1.applyDecorators)((0, class_transformer_1.Transform)(exports.emptyToUndefined), (0, class_validator_1.IsOptional)());
+}
+/**
+ * @OptionalStripNumber - Strips empty values for number fields in CREATE operations
+ *
+ * Combines @IsOptional() with:
+ * 1. Empty value stripping (empty strings, null, whitespace → undefined)
+ * 2. String number parsing ("123" → 123)
+ *
+ * Use Case: CREATE operations where Zapier sends "" or "42.5" for number fields.
+ *
+ * Behavior:
+ * - "" → undefined (stripped, validation passes)
+ * - null → undefined (stripped, validation passes)
+ * - "   " → undefined (whitespace stripped, validation passes)
+ * - "123" → 123 (parsed to number, validation runs)
+ * - "42.5" → 42.5 (parsed to float, validation runs)
+ * - 123 → 123 (already number, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalStripNumber()
+ * @IsNumber()
+ * multiplier?: number;
+ * ```
+ */
+function OptionalStripNumber() {
+    return (0, common_1.applyDecorators)((0, class_transformer_1.Transform)(exports.emptyToUndefinedNumber), (0, class_validator_1.IsOptional)());
+}
+/**
+ * @OptionalNullify - Nullifies empty values for UPDATE operations (nullable fields)
+ *
+ * Combines @IsOptional(), @Transform(emptyToNull), and @ValidateIf for nullable fields.
+ * Empty strings are converted to null (field is explicitly cleared in DB).
+ *
+ * Use Case: UPDATE operations where "" should CLEAR the field (set to null).
+ *
+ * Behavior:
+ * - "" → null (clear field in DB)
+ * - null → null (clear field in DB)
+ * - undefined → undefined (field not updated)
+ * - "value" → "value" (preserved, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalNullify()
+ * @IsString()
+ * description?: string | null;
+ *
+ * @OptionalNullify()
+ * @IsUrl()
+ * imageUrl?: string | null;
+ * ```
+ */
+function OptionalNullify() {
+    return (0, common_1.applyDecorators)((0, class_validator_1.IsOptional)(), (0, class_transformer_1.Transform)(exports.emptyToNull), (0, class_validator_1.ValidateIf)((_object, value) => value !== null));
+}
+/**
+ * Transform function: empty → null, string numbers → parsed numbers
+ *
+ * Use for number fields in UPDATE operations.
+ *
+ * Behavior:
+ * - "" → null (clear field in DB)
+ * - null → null (clear field in DB)
+ * - "   " → null (whitespace → null)
+ * - undefined → undefined (field not updated)
+ * - "123" → 123 (parsed to number)
+ * - "42.5" → 42.5 (parsed to float)
+ * - 123 → 123 (already number)
+ */
+const emptyToNullNumber = ({ value }) => {
+    if (value === '' || value === null || (typeof value === 'string' && value.trim() === '')) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        const parsed = parseFloat(value);
+        return isNaN(parsed) ? value : parsed;
+    }
+    return value;
+};
+exports.emptyToNullNumber = emptyToNullNumber;
+/**
+ * @OptionalNullifyNumber - Nullifies empty values for number fields in UPDATE operations
+ *
+ * Combines @IsOptional(), empty-to-null transform, and string-to-number parsing.
+ * Empty strings are converted to null (field is explicitly cleared in DB).
+ *
+ * Use Case: UPDATE operations where "" should CLEAR the number field (set to null).
+ *
+ * Behavior:
+ * - "" → null (clear field in DB)
+ * - null → null (clear field in DB)
+ * - "   " → null (whitespace → null)
+ * - undefined → undefined (field not updated)
+ * - "123" → 123 (parsed to number, validation runs)
+ * - "42.5" → 42.5 (parsed to float, validation runs)
+ * - 123 → 123 (already number, validation runs)
+ *
+ * @example
+ * ```typescript
+ * @OptionalNullifyNumber()
+ * @IsNumber()
+ * latitude?: number | null;
+ *
+ * @OptionalNullifyNumber()
+ * @IsNumber()
+ * order?: number | null;
+ * ```
+ */
+function OptionalNullifyNumber() {
+    return (0, common_1.applyDecorators)((0, class_validator_1.IsOptional)(), (0, class_transformer_1.Transform)(exports.emptyToNullNumber), (0, class_validator_1.ValidateIf)((_object, value) => value !== null));
+}
+//# sourceMappingURL=validation.decorators.js.map

package/dist/cjs/shared-lib/decorators/validation.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.decorators.js","sourceRoot":"","sources":["../../../../src/shared-lib/decorators/validation.decorators.ts"],"names":[],"mappings":"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"}

package/dist/cjs/shared-lib/dto/account-selector.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account-selector.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/account-selector.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,qBAAa,kBAAkB;IAQ3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,WAAW,EAAE,gBAAgB,CAAyB;IAStD,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"account-selector.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/account-selector.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C;;;GAGG;AACH,qBAAa,kBAAkB;IAQ3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,WAAW,EAAE,gBAAgB,CAAyB;IAStD,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/cjs/shared-lib/dto/account-selector.dto.js

@@ -13,6 +13,7 @@ exports.AccountSelectorDTO = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const enum_1 = require("../enum");
+const decorators_1 = require("../decorators");
 /**
  * Standard Account Identification for Transaction Participants
  * Supports multiple identification methods with auto-detection
@@ -29,7 +30,7 @@ __decorate([
         example: 'user123',
         type: String
     }),
-    (0, class_validator_1.IsOptional)(),
+    (0, decorators_1.OptionalStrip)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AccountSelectorDTO.prototype, "accountId", void 0);
@@ -48,7 +49,7 @@ __decorate([
         example: '0x742d35Cc5dB3dC0F0e8f0b0d2fA0c3fA2ed5D0f8',
         type: String
     }),
-    (0, class_validator_1.IsOptional)(),
+    (0, decorators_1.OptionalStrip)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AccountSelectorDTO.prototype, "accountAddress", void 0);

package/dist/cjs/shared-lib/dto/account-selector.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-selector.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/account-selector.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,6CAAmE;AACnE,qDAA+D;AAC/D,kCAA2C;AAE3C;;;GAGG;AACH,MAAa,kBAAkB;IAQ3B,SAAS,CAAU;IAQnB,WAAW,GAAqB,uBAAgB,CAAC,IAAI,CAAC;IAStD,cAAc,CAAU;CAC3B;AA1BD,gDA0BC;AAlBG;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0EAA0E;QACvF,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;qDACQ;AAQnB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,uBAAgB;QACtB,OAAO,EAAE,uBAAgB,CAAC,IAAI;KACjC,CAAC;IACD,IAAA,wBAAM,EAAC,uBAAgB,CAAC;;uDAC6B;AAStD;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,2DAA2D;QACxE,OAAO,EAAE,4CAA4C;QACrD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0DACa"}
+{"version":3,"file":"account-selector.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/account-selector.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,6CAAmE;AACnE,qDAAmD;AACnD,kCAA2C;AAC3C,8CAA8C;AAE9C;;;GAGG;AACH,MAAa,kBAAkB;IAQ3B,SAAS,CAAU;IAQnB,WAAW,GAAqB,uBAAgB,CAAC,IAAI,CAAC;IAStD,cAAc,CAAU;CAC3B;AA1BD,gDA0BC;AAlBG;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0EAA0E;QACvF,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;qDACQ;AAQnB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,uBAAgB;QACtB,OAAO,EAAE,uBAAgB,CAAC,IAAI;KACjC,CAAC;IACD,IAAA,wBAAM,EAAC,uBAAgB,CAAC;;uDAC6B;AAStD;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,2DAA2D;QACxE,OAAO,EAAE,4CAA4C;QACrD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;0DACa"}

package/dist/cjs/shared-lib/dto/admin/admin-create.request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-create.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/admin/admin-create.request.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,qBAAa,qBAAqB;IAM9B,KAAK,EAAE,MAAM,CAAM;IAOnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,IAAI,EAAE,SAAS,CAA0B;CAC5C"}
+{"version":3,"file":"admin-create.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/admin/admin-create.request.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,qBAAa,qBAAqB;IAM9B,KAAK,EAAE,MAAM,CAAM;IAOnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,IAAI,EAAE,SAAS,CAA0B;CAC5C"}

package/dist/cjs/shared-lib/dto/admin/admin-create.request.dto.js

@@ -13,6 +13,7 @@ exports.AdminCreateRequestDTO = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const admin_type_enum_1 = require("./../../enum/admin-type.enum");
+const decorators_1 = require("../../decorators");
 class AdminCreateRequestDTO {
     email = '';
     displayName;
@@ -31,7 +32,7 @@ __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Display name of the admin',
     }),
-    (0, class_validator_1.IsOptional)(),
+    (0, decorators_1.OptionalStrip)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AdminCreateRequestDTO.prototype, "displayName", void 0);

package/dist/cjs/shared-lib/dto/admin/admin-create.request.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-create.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/admin/admin-create.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAoF;AACpF,kEAAyD;AAEzD,MAAa,qBAAqB;IAM9B,KAAK,GAAW,EAAE,CAAC;IAOnB,WAAW,CAAU;IAQrB,IAAI,GAAc,2BAAS,CAAC,YAAY,CAAC;CAC5C;AAtBD,sDAsBC;AAhBG;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,oBAAoB;KACpC,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,yBAAO,GAAE;;oDACS;AAOnB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,2BAA2B;KAC3C,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;0DACU;AAQrB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,2BAAS;KAClB,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,EAAC,2BAAS,CAAC;;mDACuB"}
+{"version":3,"file":"admin-create.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/admin/admin-create.request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAwE;AACxE,kEAAyD;AACzD,iDAAiD;AAEjD,MAAa,qBAAqB;IAM9B,KAAK,GAAW,EAAE,CAAC;IAOnB,WAAW,CAAU;IAQrB,IAAI,GAAc,2BAAS,CAAC,YAAY,CAAC;CAC5C;AAtBD,sDAsBC;AAhBG;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,oBAAoB;KACpC,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,yBAAO,GAAE;;oDACS;AAOnB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,2BAA2B;KAC3C,CAAC;IACD,IAAA,0BAAa,GAAE;IACf,IAAA,0BAAQ,GAAE;;0DACU;AAQrB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,2BAAS;KAClB,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,EAAC,2BAAS,CAAC;;mDACuB"}

package/dist/cjs/shared-lib/dto/analytics/base-analytics.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/base-analytics.dto.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,8BAAsB,uBAAuB;IAO3C,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,EAAE;QACT,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,IAAI,CAAC;KACf,CAAC;CACH;AAED;;;;;GAKG;AACH,8BAAsB,wBAAwB;IAC5C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;CAC1C"}
+{"version":3,"file":"base-analytics.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/analytics/base-analytics.dto.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,8BAAsB,uBAAuB;IAO3C,SAAS,CAAC,EAAE,IAAI,CAAC;IAQjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,EAAE;QACT,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,IAAI,CAAC;KACf,CAAC;CACH;AAED;;;;;GAKG;AACH,8BAAsB,wBAAwB;IAC5C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;CAC1C"}