bozonx-social-media-posting 1.1.0

package/dist/src/common/services/shutdown.module.js

@@ -0,0 +1,18 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Module } from '@nestjs/common';
+import { ShutdownService } from './shutdown.service.js';
+let ShutdownModule = class ShutdownModule {
+};
+ShutdownModule = __decorate([
+    Module({
+        providers: [ShutdownService],
+        exports: [ShutdownService],
+    })
+], ShutdownModule);
+export { ShutdownModule };
+//# sourceMappingURL=shutdown.module.js.map

package/dist/src/common/services/shutdown.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.module.js","sourceRoot":"","sources":["../../../../src/common/services/shutdown.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMjD,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,cAAc;IAJ1B,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,eAAe,CAAC;QAC5B,OAAO,EAAE,CAAC,eAAe,CAAC;KAC3B,CAAC;GACW,cAAc,CAAG"}

package/dist/src/common/services/shutdown.service.d.ts

@@ -0,0 +1,40 @@
+import { OnApplicationShutdown, OnModuleDestroy } from '@nestjs/common';
+/**
+ * Service to manage graceful shutdown
+ * Tracks in-flight requests and signals shutdown state to the application
+ * Thread-safe implementation to prevent race conditions
+ */
+export declare class ShutdownService implements OnApplicationShutdown, OnModuleDestroy {
+    private readonly logger;
+    private isShuttingDown;
+    private inFlightRequests;
+    private shutdownResolve?;
+    private operationLock;
+    constructor();
+    /**
+     * Check if the application is shutting down
+     */
+    get shuttingDown(): boolean;
+    /**
+     * Increment in-flight request counter atomically
+     */
+    trackRequest(): void;
+    /**
+     * Decrement in-flight request counter atomically and resolve shutdown if no requests remain
+     */
+    untrackRequest(): void;
+    /**
+     * Get the current count of in-flight requests
+     */
+    getInFlightRequestsCount(): number;
+    /**
+     * Called by NestJS when shutdown signal is received
+     * Waits for all in-flight requests to complete with timeout
+     */
+    onApplicationShutdown(signal?: string): Promise<void>;
+    /**
+     * Called by NestJS when module is being destroyed
+     * Cleanup internal state
+     */
+    onModuleDestroy(): void;
+}

package/dist/src/common/services/shutdown.service.js

@@ -0,0 +1,122 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ShutdownService_1;
+import { Injectable, Logger } from '@nestjs/common';
+import { GRACEFUL_SHUTDOWN_TIMEOUT_MS } from '../../app.constants.js';
+/**
+ * Service to manage graceful shutdown
+ * Tracks in-flight requests and signals shutdown state to the application
+ * Thread-safe implementation to prevent race conditions
+ */
+let ShutdownService = ShutdownService_1 = class ShutdownService {
+    logger = new Logger(ShutdownService_1.name);
+    isShuttingDown = false;
+    inFlightRequests = 0;
+    shutdownResolve;
+    operationLock = false;
+    constructor() { }
+    /**
+     * Check if the application is shutting down
+     */
+    get shuttingDown() {
+        return this.isShuttingDown;
+    }
+    /**
+     * Increment in-flight request counter atomically
+     */
+    trackRequest() {
+        // Wait for any ongoing operation to complete
+        while (this.operationLock) {
+            // Busy wait (acceptable for very short operations)
+        }
+        this.operationLock = true;
+        try {
+            this.inFlightRequests++;
+            this.logger.debug(`Request tracked. In-flight requests: ${this.inFlightRequests}`, 'ShutdownService');
+        }
+        finally {
+            this.operationLock = false;
+        }
+    }
+    /**
+     * Decrement in-flight request counter atomically and resolve shutdown if no requests remain
+     */
+    untrackRequest() {
+        // Wait for any ongoing operation to complete
+        while (this.operationLock) {
+            // Busy wait (acceptable for very short operations)
+        }
+        this.operationLock = true;
+        try {
+            this.inFlightRequests--;
+            this.logger.debug(`Request untracked. In-flight requests: ${this.inFlightRequests}`, 'ShutdownService');
+            // Check if we should resolve shutdown
+            if (this.isShuttingDown && this.inFlightRequests <= 0 && this.shutdownResolve) {
+                this.logger.log('All in-flight requests completed during shutdown', 'ShutdownService');
+                this.shutdownResolve();
+                this.shutdownResolve = undefined;
+            }
+        }
+        finally {
+            this.operationLock = false;
+        }
+    }
+    /**
+     * Get the current count of in-flight requests
+     */
+    getInFlightRequestsCount() {
+        return this.inFlightRequests;
+    }
+    /**
+     * Called by NestJS when shutdown signal is received
+     * Waits for all in-flight requests to complete with timeout
+     */
+    async onApplicationShutdown(signal) {
+        this.logger.log(`Received shutdown signal: ${signal ?? 'unknown'}. In-flight requests: ${this.inFlightRequests}`, 'ShutdownService');
+        this.isShuttingDown = true;
+        if (this.inFlightRequests > 0) {
+            this.logger.log(`Waiting for ${this.inFlightRequests} in-flight requests to complete...`, 'ShutdownService');
+            const startTime = Date.now();
+            // Wait for requests to complete with timeout
+            await Promise.race([
+                new Promise(resolve => {
+                    this.shutdownResolve = resolve;
+                }),
+                new Promise(resolve => {
+                    setTimeout(() => {
+                        this.logger.warn(`Shutdown timeout reached. Remaining in-flight requests: ${this.inFlightRequests}`, 'ShutdownService');
+                        resolve();
+                    }, GRACEFUL_SHUTDOWN_TIMEOUT_MS);
+                }),
+            ]);
+            const duration = Date.now() - startTime;
+            this.logger.log(`Shutdown wait completed in ${duration}ms. Remaining requests: ${this.inFlightRequests}`, 'ShutdownService');
+        }
+        else {
+            this.logger.log('No in-flight requests, shutting down immediately', 'ShutdownService');
+        }
+    }
+    /**
+     * Called by NestJS when module is being destroyed
+     * Cleanup internal state
+     */
+    onModuleDestroy() {
+        this.logger.debug('ShutdownService module destroyed', 'ShutdownService');
+        this.shutdownResolve = undefined;
+        this.inFlightRequests = 0;
+        this.isShuttingDown = false;
+    }
+};
+ShutdownService = ShutdownService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [])
+], ShutdownService);
+export { ShutdownService };
+//# sourceMappingURL=shutdown.service.js.map

package/dist/src/common/services/shutdown.service.js.map

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

package/dist/src/common/types/index.d.ts

@@ -0,0 +1 @@
+export type { MediaInput, MediaInputObject } from './media-input.type.js';

package/dist/src/common/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/common/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/types/index.ts"],"names":[],"mappings":""}

package/dist/src/common/types/media-input.type.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Media type for explicit type specification in media arrays
+ * Used in albums to avoid auto-detection by URL extension
+ */
+export type MediaType = 'image' | 'video' | 'audio' | 'document';
+/**
+ * MediaInput type
+ * Always an object with src and optional parameters
+ * For single media fields (cover, video, audio, document): hasSpoiler is optional
+ * For media arrays: type should be specified to override auto-detection
+ */
+export type MediaInput = MediaInputObject;
+export interface MediaInputObject {
+    /**
+     * Media source (URL or Telegram file_id)
+     */
+    src: string;
+    /**
+     * Hide media with spoiler animation (for shocking content)
+     * Supported by Telegram Bot API 5.6+
+     */
+    hasSpoiler?: boolean;
+    /**
+     * Explicit media type specification
+     * For single media fields (cover, video, audio, document) this is ignored
+     * For media[] arrays this overrides auto-detection by URL extension
+     */
+    type?: MediaType;
+}

package/dist/src/common/types/media-input.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=media-input.type.js.map

package/dist/src/common/types/media-input.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-input.type.js","sourceRoot":"","sources":["../../../../src/common/types/media-input.type.ts"],"names":[],"mappings":""}

package/dist/src/common/validators/body-length.validator.d.ts

@@ -0,0 +1,24 @@
+import { ValidationOptions, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/** Absolute maximum body length limit in characters (cannot be exceeded) */
+export declare const MAX_BODY_LIMIT = 500000;
+/**
+ * Validator constraint for body field with dynamic max length
+ * Uses maxBody from request (capped at MAX_BODY_LIMIT)
+ */
+export declare class IsValidBodyLengthConstraint implements ValidatorConstraintInterface {
+    /**
+     * Validates body length against maxBody or MAX_BODY_LIMIT
+     * @param value - Body string to validate
+     * @param args - Validation arguments containing the object
+     * @returns True if valid, false otherwise
+     */
+    validate(value: any, args: ValidationArguments): boolean;
+    defaultMessage(args: ValidationArguments): string;
+}
+/**
+ * Decorator factory for body length validation
+ * Validates body against maxBody parameter or default max length
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export declare function IsValidBodyLength(validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;

package/dist/src/common/validators/body-length.validator.js

@@ -0,0 +1,57 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { registerDecorator, ValidatorConstraint, } from 'class-validator';
+/** Absolute maximum body length limit in characters (cannot be exceeded) */
+export const MAX_BODY_LIMIT = 500_000;
+/**
+ * Validator constraint for body field with dynamic max length
+ * Uses maxBody from request (capped at MAX_BODY_LIMIT)
+ */
+let IsValidBodyLengthConstraint = class IsValidBodyLengthConstraint {
+    /**
+     * Validates body length against maxBody or MAX_BODY_LIMIT
+     * @param value - Body string to validate
+     * @param args - Validation arguments containing the object
+     * @returns True if valid, false otherwise
+     */
+    validate(value, args) {
+        if (typeof value !== 'string') {
+            return false;
+        }
+        const obj = args.object;
+        // Use maxBody from request if provided, otherwise use absolute limit
+        const maxLength = Math.min(obj.maxBody || MAX_BODY_LIMIT, MAX_BODY_LIMIT);
+        return value.length <= maxLength;
+    }
+    defaultMessage(args) {
+        const obj = args.object;
+        const maxLength = Math.min(obj.maxBody || MAX_BODY_LIMIT, MAX_BODY_LIMIT);
+        return `Body length must not exceed ${maxLength} characters`;
+    }
+};
+IsValidBodyLengthConstraint = __decorate([
+    ValidatorConstraint({ name: 'isValidBodyLength', async: false })
+], IsValidBodyLengthConstraint);
+export { IsValidBodyLengthConstraint };
+/**
+ * Decorator factory for body length validation
+ * Validates body against maxBody parameter or default max length
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export function IsValidBodyLength(validationOptions) {
+    return function (object, propertyName) {
+        registerDecorator({
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            constraints: [],
+            validator: IsValidBodyLengthConstraint,
+        });
+    };
+}
+//# sourceMappingURL=body-length.validator.js.map

package/dist/src/common/validators/body-length.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-length.validator.js","sourceRoot":"","sources":["../../../../src/common/validators/body-length.validator.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EACL,iBAAiB,EAGjB,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC;AAEzB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;GAGG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,KAAU,EAAE,IAAyB;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAa,CAAC;QAC/B,qEAAqE;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,cAAc,EAAE,cAAc,CAAC,CAAC;QAE1E,OAAO,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;IACnC,CAAC;IAED,cAAc,CAAC,IAAyB;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAa,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,cAAc,EAAE,cAAc,CAAC,CAAC;QAC1E,OAAO,+BAA+B,SAAS,aAAa,CAAC;IAC/D,CAAC;CACF,CAAA;AAxBY,2BAA2B;IADvC,mBAAmB,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GACpD,2BAA2B,CAwBvC;;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,iBAAqC;IACrE,OAAO,UAAU,MAAc,EAAE,YAAoB;QACnD,iBAAiB,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY,EAAE,YAAY;YAC1B,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,2BAA2B;SACvC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/common/validators/channel-id.validator.d.ts

@@ -0,0 +1,19 @@
+import { ValidationOptions, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/**
+ * Validator constraint for channelId field
+ * Validates that channelId is either a string or a number
+ * Allows formats like:
+ * - String: "@mychannel", "-100123456789", "123456789"
+ * - Number: 123456789, -100123456789
+ */
+export declare class IsChannelIdConstraint implements ValidatorConstraintInterface {
+    validate(value: any, args: ValidationArguments): boolean;
+    defaultMessage(args: ValidationArguments): string;
+}
+/**
+ * Decorator factory for channelId validation
+ * Use on DTO properties that accept channelId
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export declare function IsChannelId(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;

package/dist/src/common/validators/channel-id.validator.js

@@ -0,0 +1,58 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { registerDecorator, ValidatorConstraint, } from 'class-validator';
+/**
+ * Validator constraint for channelId field
+ * Validates that channelId is either a string or a number
+ * Allows formats like:
+ * - String: "@mychannel", "-100123456789", "123456789"
+ * - Number: 123456789, -100123456789
+ */
+let IsChannelIdConstraint = class IsChannelIdConstraint {
+    validate(value, args) {
+        // Allow undefined/null for optional fields
+        if (value === undefined || value === null) {
+            return true;
+        }
+        // Check if it's a string or number
+        if (typeof value === 'string') {
+            // String must not be empty
+            return value.trim().length > 0;
+        }
+        if (typeof value === 'number') {
+            // Number must be a valid integer
+            return Number.isInteger(value);
+        }
+        return false;
+    }
+    defaultMessage(args) {
+        return 'channelId must be a non-empty string or an integer number';
+    }
+};
+IsChannelIdConstraint = __decorate([
+    ValidatorConstraint({ name: 'isChannelId', async: false })
+], IsChannelIdConstraint);
+export { IsChannelIdConstraint };
+/**
+ * Decorator factory for channelId validation
+ * Use on DTO properties that accept channelId
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export function IsChannelId(validationOptions) {
+    return function (object, propertyName) {
+        registerDecorator({
+            name: 'isChannelId',
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            constraints: [],
+            validator: IsChannelIdConstraint,
+        });
+    };
+}
+//# sourceMappingURL=channel-id.validator.js.map

package/dist/src/common/validators/channel-id.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-id.validator.js","sourceRoot":"","sources":["../../../../src/common/validators/channel-id.validator.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EACH,iBAAiB,EAGjB,mBAAmB,GAEtB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAC9B,QAAQ,CAAC,KAAU,EAAE,IAAyB;QAC1C,2CAA2C;QAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,2BAA2B;YAC3B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,iCAAiC;YACjC,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,cAAc,CAAC,IAAyB;QACpC,OAAO,2DAA2D,CAAC;IACvE,CAAC;CACJ,CAAA;AAxBY,qBAAqB;IADjC,mBAAmB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GAC9C,qBAAqB,CAwBjC;;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,iBAAqC;IAC7D,OAAO,UAAU,MAAc,EAAE,YAAoB;QACjD,iBAAiB,CAAC;YACd,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY,EAAE,YAAY;YAC1B,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,qBAAqB;SACnC,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

package/dist/src/common/validators/has-content.validator.d.ts

@@ -0,0 +1,23 @@
+import { ValidationOptions, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/**
+ * Validator constraint for ensuring post has content
+ * Checks that either body or at least one media field is provided
+ */
+export declare class HasContentConstraint implements ValidatorConstraintInterface {
+    /**
+     * Validates that post has either body or media content
+     * @param _value - Not used (class-level validator)
+     * @param args - Validation arguments containing the object
+     * @returns True if valid, false otherwise
+     */
+    validate(_value: any, args: ValidationArguments): any;
+    defaultMessage(_args: ValidationArguments): string;
+}
+/**
+ * Decorator factory for content validation
+ * Validates that post has either body or media content
+ * This is a class-level decorator
+ * @param validationOptions - Optional validation options
+ * @returns Class decorator
+ */
+export declare function HasContent(validationOptions?: ValidationOptions): (object: Function) => void;

package/dist/src/common/validators/has-content.validator.js

@@ -0,0 +1,57 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { registerDecorator, ValidatorConstraint, } from 'class-validator';
+/**
+ * Validator constraint for ensuring post has content
+ * Checks that either body or at least one media field is provided
+ */
+let HasContentConstraint = class HasContentConstraint {
+    /**
+     * Validates that post has either body or media content
+     * @param _value - Not used (class-level validator)
+     * @param args - Validation arguments containing the object
+     * @returns True if valid, false otherwise
+     */
+    validate(_value, args) {
+        const obj = args.object;
+        // Check if body is a non-empty string
+        const hasBody = typeof obj.body === 'string' && obj.body.trim().length > 0;
+        // Check if at least one media field is provided (ignore falsy values like false, null, undefined, '')
+        const hasMedia = (obj.cover && typeof obj.cover === 'object') ||
+            (obj.video && typeof obj.video === 'object') ||
+            (obj.audio && typeof obj.audio === 'object') ||
+            (obj.document && typeof obj.document === 'object') ||
+            (Array.isArray(obj.media) && obj.media.length > 0);
+        return hasBody || hasMedia;
+    }
+    defaultMessage(_args) {
+        return 'Post must have either body text or at least one media field (cover, video, audio, document, or media)';
+    }
+};
+HasContentConstraint = __decorate([
+    ValidatorConstraint({ name: 'hasContent', async: false })
+], HasContentConstraint);
+export { HasContentConstraint };
+/**
+ * Decorator factory for content validation
+ * Validates that post has either body or media content
+ * This is a class-level decorator
+ * @param validationOptions - Optional validation options
+ * @returns Class decorator
+ */
+export function HasContent(validationOptions) {
+    return function (object) {
+        registerDecorator({
+            target: object,
+            propertyName: '',
+            options: validationOptions,
+            constraints: [],
+            validator: HasContentConstraint,
+        });
+    };
+}
+//# sourceMappingURL=has-content.validator.js.map

package/dist/src/common/validators/has-content.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-content.validator.js","sourceRoot":"","sources":["../../../../src/common/validators/has-content.validator.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EACH,iBAAiB,EAGjB,mBAAmB,GAEtB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,MAAW,EAAE,IAAyB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAa,CAAC;QAE/B,sCAAsC;QACtC,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAE3E,sGAAsG;QACtG,MAAM,QAAQ,GACV,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC;YAC5C,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC;YAC5C,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC;YAC5C,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;YAClD,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEvD,OAAO,OAAO,IAAI,QAAQ,CAAC;IAC/B,CAAC;IAED,cAAc,CAAC,KAA0B;QACrC,OAAO,uGAAuG,CAAC;IACnH,CAAC;CACJ,CAAA;AA3BY,oBAAoB;IADhC,mBAAmB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GAC7C,oBAAoB,CA2BhC;;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,iBAAqC;IAC5D,OAAO,UAAU,MAAgB;QAC7B,iBAAiB,CAAC;YACd,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,oBAAoB;SAClC,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

package/dist/src/common/validators/media-input.validator.d.ts

@@ -0,0 +1,44 @@
+import { ValidationOptions, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/**
+ * Validator constraint for MediaInput type
+ * Validates that a value is an object with src property
+ */
+export declare class IsMediaInputConstraint implements ValidatorConstraintInterface {
+    /**
+     * Validates MediaInput value
+     * Accepts only an object with src property (max 500 characters)
+     * @param value - Value to validate
+     * @param args - Validation arguments
+     * @returns True if valid, false otherwise
+     */
+    validate(value: any, args: ValidationArguments): boolean;
+    defaultMessage(args: ValidationArguments): string;
+}
+/**
+ * Decorator factory for MediaInput validation
+ * Use on DTO properties that accept MediaInput type
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export declare function IsMediaInput(validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;
+/**
+ * Validator constraint for MediaInput array type
+ * Validates that each item in the array is a valid MediaInput
+ */
+export declare class IsMediaInputArrayConstraint implements ValidatorConstraintInterface {
+    /**
+     * Validates array of MediaInput values
+     * @param value - Array to validate
+     * @param args - Validation arguments
+     * @returns True if all items are valid MediaInput, false otherwise
+     */
+    validate(value: any, args: ValidationArguments): boolean;
+    defaultMessage(args: ValidationArguments): string;
+}
+/**
+ * Decorator factory for MediaInput array validation
+ * Use on DTO properties that accept MediaInput[] type
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export declare function IsMediaInputArray(validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;

package/dist/src/common/validators/media-input.validator.js

@@ -0,0 +1,112 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { registerDecorator, ValidatorConstraint, } from 'class-validator';
+/** Maximum length for URL and fileId strings */
+const MAX_MEDIA_STRING_LENGTH = 500;
+/**
+ * Validator constraint for MediaInput type
+ * Validates that a value is an object with src property
+ */
+let IsMediaInputConstraint = class IsMediaInputConstraint {
+    /**
+     * Validates MediaInput value
+     * Accepts only an object with src property (max 500 characters)
+     * @param value - Value to validate
+     * @param args - Validation arguments
+     * @returns True if valid, false otherwise
+     */
+    validate(value, args) {
+        // Optional field - allow null/undefined/false
+        if (value === null || value === undefined || value === false) {
+            return true;
+        }
+        // Must be an object with src property
+        if (typeof value === 'object' && value !== null) {
+            const hasSrc = typeof value.src === 'string';
+            const hasSpoiler = value.hasSpoiler === undefined || typeof value.hasSpoiler === 'boolean';
+            const hasType = value.type === undefined || typeof value.type === 'string';
+            // Validate string length
+            if (hasSrc && value.src.length > MAX_MEDIA_STRING_LENGTH) {
+                return false;
+            }
+            // Must have src, and hasSpoiler/type must be correct types if present
+            return hasSrc && value.src.length > 0 && hasSpoiler && hasType;
+        }
+        return false;
+    }
+    defaultMessage(args) {
+        return `MediaInput must be an object with src (max ${MAX_MEDIA_STRING_LENGTH} characters), optional hasSpoiler boolean, and optional type string`;
+    }
+};
+IsMediaInputConstraint = __decorate([
+    ValidatorConstraint({ name: 'isMediaInput', async: false })
+], IsMediaInputConstraint);
+export { IsMediaInputConstraint };
+/**
+ * Decorator factory for MediaInput validation
+ * Use on DTO properties that accept MediaInput type
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export function IsMediaInput(validationOptions) {
+    return function (object, propertyName) {
+        registerDecorator({
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            constraints: [],
+            validator: IsMediaInputConstraint,
+        });
+    };
+}
+/**
+ * Validator constraint for MediaInput array type
+ * Validates that each item in the array is a valid MediaInput
+ */
+let IsMediaInputArrayConstraint = class IsMediaInputArrayConstraint {
+    /**
+     * Validates array of MediaInput values
+     * @param value - Array to validate
+     * @param args - Validation arguments
+     * @returns True if all items are valid MediaInput, false otherwise
+     */
+    validate(value, args) {
+        if (!value) {
+            return true; // Optional field
+        }
+        if (!Array.isArray(value)) {
+            return false;
+        }
+        const validator = new IsMediaInputConstraint();
+        return value.every(item => validator.validate(item, args));
+    }
+    defaultMessage(args) {
+        return `Property "media" must be an array of objects. Example: [{"src": "https://example.com/image.jpg", "type": "image"}]. Each item must have src (max ${MAX_MEDIA_STRING_LENGTH} characters), optional hasSpoiler boolean, and optional type string`;
+    }
+};
+IsMediaInputArrayConstraint = __decorate([
+    ValidatorConstraint({ name: 'isMediaInputArray', async: false })
+], IsMediaInputArrayConstraint);
+export { IsMediaInputArrayConstraint };
+/**
+ * Decorator factory for MediaInput array validation
+ * Use on DTO properties that accept MediaInput[] type
+ * @param validationOptions - Optional validation options
+ * @returns Property decorator
+ */
+export function IsMediaInputArray(validationOptions) {
+    return function (object, propertyName) {
+        registerDecorator({
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            constraints: [],
+            validator: IsMediaInputArrayConstraint,
+        });
+    };
+}
+//# sourceMappingURL=media-input.validator.js.map