@explorins/pers-shared 2.1.91 → 2.1.93

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC"}

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

@@ -28,4 +28,5 @@ __exportStar(require("./transaction-include-relation.type"), exports);
 __exportStar(require("./campaign-include-relation.type"), exports);
 __exportStar(require("./campaign-claim-include-relation.type"), exports);
 __exportStar(require("./redemption-redeem-include-relation.type"), exports);
+__exportStar(require("./business-membership-include-relation.type"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAmD;AACnD,mDAAiC;AACjC,gEAA8C;AAC9C,sDAAoC;AACpC,mDAAiC;AACjC,0DAAwC;AACxC,4CAA0B;AAC1B,8DAA4C;AAC5C,6DAA2C;AAC3C,6DAA2C;AAC3C,sEAAoD;AACpD,mEAAiD;AACjD,yEAAuD;AACvD,4EAA0D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAmD;AACnD,mDAAiC;AACjC,gEAA8C;AAC9C,sDAAoC;AACpC,mDAAiC;AACjC,0DAAwC;AACxC,4CAA0B;AAC1B,8DAA4C;AAC5C,6DAA2C;AAC3C,6DAA2C;AAC3C,sEAAoD;AACpD,mEAAiD;AACjD,yEAAuD;AACvD,4EAA0D;AAC1D,8EAA4D"}

package/dist/esm/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/esm/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/esm/index.js

@@ -4,6 +4,8 @@
 export * from './shared-lib/enum/index.js';
 export * from './shared-lib/interfaces/index.js';
 export * from './shared-lib/types/index.js';
+// Decorators - Validation decorators for DTO handling (Zapier/automation tool compatibility)
+export * from './shared-lib/decorators/index.js';
 // Re-export web3 types for convenience
 export * from '@explorins/web3-types';
 export { ErrorCategory } from './shared-lib/errors/base/error-classification-enums.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AAGnC,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAwB,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAE1G,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AAGnC,6FAA6F;AAC7F,cAAc,yBAAyB,CAAC;AAExC,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAwB,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAE1G,4CAA4C;AAC5C,2CAA2C;AAC3C,iFAAiF"}

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

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

package/dist/esm/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/esm/shared-lib/decorators/index.js

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

package/dist/esm/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,cAAc,yBAAyB,CAAC"}

package/dist/esm/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/esm/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/esm/shared-lib/decorators/validation.decorators.js

@@ -0,0 +1,270 @@
+import { applyDecorators } from '@nestjs/common';
+import { IsOptional, ValidateIf } from 'class-validator';
+import { Transform } 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;
+ * ```
+ */
+// =============================================================================
+// 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;
+ * ```
+ */
+export const emptyToNull = ({ value }) => value === '' ? null : value;
+/**
+ * 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 const emptyToUndefined = ({ value }) => {
+    if (value === '' || value === null || (typeof value === 'string' && value.trim() === '')) {
+        return undefined;
+    }
+    return value;
+};
+/**
+ * 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 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;
+};
+// =============================================================================
+// 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;
+ * ```
+ */
+export function OptionalStrip() {
+    return applyDecorators(Transform(emptyToUndefined), 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;
+ * ```
+ */
+export function OptionalStripNumber() {
+    return applyDecorators(Transform(emptyToUndefinedNumber), 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;
+ * ```
+ */
+export function OptionalNullify() {
+    return applyDecorators(IsOptional(), Transform(emptyToNull), 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)
+ */
+export 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;
+};
+/**
+ * @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 function OptionalNullifyNumber() {
+    return applyDecorators(IsOptional(), Transform(emptyToNullNumber), ValidateIf((_object, value) => value !== null));
+}
+//# sourceMappingURL=validation.decorators.js.map

package/dist/esm/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/esm/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/esm/shared-lib/dto/account-selector.dto.js

@@ -5,8 +5,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { IsOptional, IsString, IsEnum } from "class-validator";
+import { IsString, IsEnum } from "class-validator";
 import { AccountOwnerType } from "../enum/index.js";
+import { OptionalStrip } from '../decorators/index.js';
 /**
  * Standard Account Identification for Transaction Participants
  * Supports multiple identification methods with auto-detection
@@ -22,7 +23,7 @@ __decorate([
         example: 'user123',
         type: String
     }),
-    IsOptional(),
+    OptionalStrip(),
     IsString()
 ], AccountSelectorDTO.prototype, "accountId", void 0);
 __decorate([
@@ -39,7 +40,7 @@ __decorate([
         example: '0x742d35Cc5dB3dC0F0e8f0b0d2fA0c3fA2ed5D0f8',
         type: String
     }),
-    IsOptional(),
+    OptionalStrip(),
     IsString()
 ], AccountSelectorDTO.prototype, "accountAddress", void 0);
 //# sourceMappingURL=account-selector.dto.js.map

package/dist/esm/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,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAQ3B,SAAS,CAAU;IAQnB,WAAW,GAAqB,gBAAgB,CAAC,IAAI,CAAC;IAStD,cAAc,CAAU;CAC3B;AAlBG;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,0EAA0E;QACvF,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;KACf,CAAC;IACD,UAAU,EAAE;IACZ,QAAQ,EAAE;qDACQ;AAQnB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gBAAgB,CAAC,IAAI;KACjC,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAC;uDAC6B;AAStD;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,2DAA2D;QACxE,OAAO,EAAE,4CAA4C;QACrD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,UAAU,EAAE;IACZ,QAAQ,EAAE;0DACa"}
+{"version":3,"file":"account-selector.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/account-selector.dto.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAQ3B,SAAS,CAAU;IAQnB,WAAW,GAAqB,gBAAgB,CAAC,IAAI,CAAC;IAStD,cAAc,CAAU;CAC3B;AAlBG;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,0EAA0E;QACvF,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;KACf,CAAC;IACD,aAAa,EAAE;IACf,QAAQ,EAAE;qDACQ;AAQnB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gBAAgB,CAAC,IAAI;KACjC,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAC;uDAC6B;AAStD;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,2DAA2D;QACxE,OAAO,EAAE,4CAA4C;QACrD,IAAI,EAAE,MAAM;KACf,CAAC;IACD,aAAa,EAAE;IACf,QAAQ,EAAE;0DACa"}

package/dist/esm/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/esm/shared-lib/dto/admin/admin-create.request.dto.js

@@ -5,8 +5,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { IsNotEmpty, IsEmail, IsString, IsOptional, IsEnum } from 'class-validator';
+import { IsNotEmpty, IsEmail, IsString, IsEnum } from 'class-validator';
 import { AdminType } from './../../enum/admin-type.enum.js';
+import { OptionalStrip } from '../../decorators/index.js';
 export class AdminCreateRequestDTO {
     email = '';
     displayName;
@@ -23,7 +24,7 @@ __decorate([
     ApiPropertyOptional({
         description: 'Display name of the admin',
     }),
-    IsOptional(),
+    OptionalStrip(),
     IsString()
 ], AdminCreateRequestDTO.prototype, "displayName", void 0);
 __decorate([

package/dist/esm/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,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,MAAM,OAAO,qBAAqB;IAM9B,KAAK,GAAW,EAAE,CAAC;IAOnB,WAAW,CAAU;IAQrB,IAAI,GAAc,SAAS,CAAC,YAAY,CAAC;CAC5C;AAhBG;IALC,WAAW,CAAC;QACT,WAAW,EAAE,oBAAoB;KACpC,CAAC;IACD,UAAU,EAAE;IACZ,OAAO,EAAE;oDACS;AAOnB;IALC,mBAAmB,CAAC;QACjB,WAAW,EAAE,2BAA2B;KAC3C,CAAC;IACD,UAAU,EAAE;IACZ,QAAQ,EAAE;0DACU;AAQrB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,SAAS;KAClB,CAAC;IACD,UAAU,EAAE;IACZ,MAAM,CAAC,SAAS,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,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,OAAO,qBAAqB;IAM9B,KAAK,GAAW,EAAE,CAAC;IAOnB,WAAW,CAAU;IAQrB,IAAI,GAAc,SAAS,CAAC,YAAY,CAAC;CAC5C;AAhBG;IALC,WAAW,CAAC;QACT,WAAW,EAAE,oBAAoB;KACpC,CAAC;IACD,UAAU,EAAE;IACZ,OAAO,EAAE;oDACS;AAOnB;IALC,mBAAmB,CAAC;QACjB,WAAW,EAAE,2BAA2B;KAC3C,CAAC;IACD,aAAa,EAAE;IACf,QAAQ,EAAE;0DACU;AAQrB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,SAAS;KAClB,CAAC;IACD,UAAU,EAAE;IACZ,MAAM,CAAC,SAAS,CAAC;mDACuB"}

package/dist/esm/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"}