bozonx-social-media-posting 1.1.0

package/dist/src/modules/media/media.service.d.ts

@@ -0,0 +1,15 @@
+export declare class MediaService {
+    /**
+     * Validate a single media URL
+     * Ensures the URL is well-formed and uses HTTP/HTTPS protocol
+     * @param url - URL to validate
+     * @throws BadRequestException if URL is invalid or uses unsupported protocol
+     */
+    validateMediaUrl(url: string): void;
+    /**
+     * Validate multiple media URLs
+     * @param urls - Array of URLs to validate
+     * @throws BadRequestException if any URL is invalid
+     */
+    validateMediaUrls(urls: string[]): void;
+}

package/dist/src/modules/media/media.service.js

@@ -0,0 +1,49 @@
+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 { Injectable, BadRequestException } from '@nestjs/common';
+let MediaService = class MediaService {
+    /**
+     * Validate a single media URL
+     * Ensures the URL is well-formed and uses HTTP/HTTPS protocol
+     * @param url - URL to validate
+     * @throws BadRequestException if URL is invalid or uses unsupported protocol
+     */
+    validateMediaUrl(url) {
+        if (!url) {
+            return;
+        }
+        try {
+            const parsedUrl = new URL(url);
+            // Only HTTP and HTTPS protocols are allowed
+            if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
+                throw new BadRequestException(`Invalid media URL protocol: ${parsedUrl.protocol}. Only HTTP and HTTPS are allowed.`);
+            }
+        }
+        catch (error) {
+            if (error instanceof BadRequestException) {
+                throw error;
+            }
+            throw new BadRequestException(`Invalid media URL format: ${url}`);
+        }
+    }
+    /**
+     * Validate multiple media URLs
+     * @param urls - Array of URLs to validate
+     * @throws BadRequestException if any URL is invalid
+     */
+    validateMediaUrls(urls) {
+        if (!urls || urls.length === 0) {
+            return;
+        }
+        urls.forEach(url => this.validateMediaUrl(url));
+    }
+};
+MediaService = __decorate([
+    Injectable()
+], MediaService);
+export { MediaService };
+//# sourceMappingURL=media.service.js.map

package/dist/src/modules/media/media.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.service.js","sourceRoot":"","sources":["../../../../src/modules/media/media.service.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,IAAM,YAAY,GAAlB,MAAM,YAAY;IACvB;;;;;OAKG;IACH,gBAAgB,CAAC,GAAW;QAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAE/B,4CAA4C;YAC5C,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,mBAAmB,CAC3B,+BAA+B,SAAS,CAAC,QAAQ,oCAAoC,CACtF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,mBAAmB,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,IAAc;QAC9B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;CACF,CAAA;AAzCY,YAAY;IADxB,UAAU,EAAE;GACA,YAAY,CAyCxB"}

package/dist/src/modules/platforms/base/auth-validator-registry.service.d.ts

@@ -0,0 +1,25 @@
+import { IAuthValidator } from './auth-validator.interface.js';
+/**
+ * Registry for provider-specific auth validators
+ */
+export declare class AuthValidatorRegistry {
+    private readonly validators;
+    /**
+     * Register an auth validator
+     * @param validator - Auth validator instance
+     */
+    register(validator: IAuthValidator): void;
+    /**
+     * Validate auth object for a specific provider
+     * @param platform - Platform name
+     * @param auth - Auth object to validate
+     * @throws BadRequestException if validation fails
+     */
+    validate(platform: string, auth: Record<string, any>): void;
+    /**
+     * Check if validator exists for platform
+     * @param platform - Platform name
+     * @returns True if validator is registered
+     */
+    has(platform: string): boolean;
+}

package/dist/src/modules/platforms/base/auth-validator-registry.service.js

@@ -0,0 +1,50 @@
+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 { Injectable, BadRequestException } from '@nestjs/common';
+/**
+ * Registry for provider-specific auth validators
+ */
+let AuthValidatorRegistry = class AuthValidatorRegistry {
+    validators = new Map();
+    /**
+     * Register an auth validator
+     * @param validator - Auth validator instance
+     */
+    register(validator) {
+        this.validators.set(validator.providerName.toLowerCase(), validator);
+    }
+    /**
+     * Validate auth object for a specific provider
+     * @param platform - Platform name
+     * @param auth - Auth object to validate
+     * @throws BadRequestException if validation fails
+     */
+    validate(platform, auth) {
+        const validator = this.validators.get(platform.toLowerCase());
+        if (!validator) {
+            // No validator registered - skip validation
+            return;
+        }
+        const errors = validator.validate(auth);
+        if (errors.length > 0) {
+            throw new BadRequestException(errors.join('; '));
+        }
+    }
+    /**
+     * Check if validator exists for platform
+     * @param platform - Platform name
+     * @returns True if validator is registered
+     */
+    has(platform) {
+        return this.validators.has(platform.toLowerCase());
+    }
+};
+AuthValidatorRegistry = __decorate([
+    Injectable()
+], AuthValidatorRegistry);
+export { AuthValidatorRegistry };
+//# sourceMappingURL=auth-validator-registry.service.js.map

package/dist/src/modules/platforms/base/auth-validator-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-validator-registry.service.js","sourceRoot":"","sources":["../../../../../src/modules/platforms/base/auth-validator-registry.service.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGjE;;GAEG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACf,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEhE;;;OAGG;IACH,QAAQ,CAAC,SAAyB;QAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAgB,EAAE,IAAyB;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,4CAA4C;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;CACF,CAAA;AAtCY,qBAAqB;IADjC,UAAU,EAAE;GACA,qBAAqB,CAsCjC"}

package/dist/src/modules/platforms/base/auth-validator.interface.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Interface for provider-specific auth validation
+ * Each provider implements its own validation logic
+ */
+export interface IAuthValidator {
+    /**
+     * Provider name this validator is for
+     */
+    readonly providerName: string;
+    /**
+     * Validate auth object for the provider
+     * @param auth - Auth object to validate
+     * @returns Array of error messages (empty if valid)
+     */
+    validate(auth: Record<string, any>): string[];
+}

package/dist/src/modules/platforms/base/auth-validator.interface.js

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

package/dist/src/modules/platforms/base/auth-validator.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-validator.interface.js","sourceRoot":"","sources":["../../../../../src/modules/platforms/base/auth-validator.interface.ts"],"names":[],"mappings":""}

package/dist/src/modules/platforms/base/index.d.ts

@@ -0,0 +1,4 @@
+export * from './platform.interface.js';
+export * from './platform-registry.service.js';
+export * from './auth-validator.interface.js';
+export * from './auth-validator-registry.service.js';

package/dist/src/modules/platforms/base/index.js

@@ -0,0 +1,5 @@
+export * from './platform.interface.js';
+export * from './platform-registry.service.js';
+export * from './auth-validator.interface.js';
+export * from './auth-validator-registry.service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/modules/platforms/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/platforms/base/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC"}

package/dist/src/modules/platforms/base/platform-registry.service.d.ts

@@ -0,0 +1,31 @@
+import { IPlatform } from './platform.interface.js';
+/**
+ * Registry for managing platform instances
+ * Simplifies adding new platforms and eliminates switch-case duplication
+ */
+export declare class PlatformRegistry {
+    private readonly platforms;
+    /**
+     * Register a platform instance
+     * @param platform - Platform instance to register
+     */
+    register(platform: IPlatform): void;
+    /**
+     * Get platform by name
+     * @param platformName - Platform name (e.g., 'telegram')
+     * @returns Platform instance
+     * @throws BadRequestException if platform is not found
+     */
+    get(platformName: string): IPlatform;
+    /**
+     * Check if platform exists
+     * @param platformName - Platform name
+     * @returns True if platform is registered
+     */
+    has(platformName: string): boolean;
+    /**
+     * Get all registered platform names
+     * @returns Array of platform names
+     */
+    getRegisteredPlatforms(): string[];
+}

package/dist/src/modules/platforms/base/platform-registry.service.js

@@ -0,0 +1,54 @@
+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 { Injectable, BadRequestException } from '@nestjs/common';
+/**
+ * Registry for managing platform instances
+ * Simplifies adding new platforms and eliminates switch-case duplication
+ */
+let PlatformRegistry = class PlatformRegistry {
+    platforms = new Map();
+    /**
+     * Register a platform instance
+     * @param platform - Platform instance to register
+     */
+    register(platform) {
+        this.platforms.set(platform.name.toLowerCase(), platform);
+    }
+    /**
+     * Get platform by name
+     * @param platformName - Platform name (e.g., 'telegram')
+     * @returns Platform instance
+     * @throws BadRequestException if platform is not found
+     */
+    get(platformName) {
+        const platform = this.platforms.get(platformName.toLowerCase());
+        if (!platform) {
+            throw new BadRequestException(`Platform "${platformName}" is not supported`);
+        }
+        return platform;
+    }
+    /**
+     * Check if platform exists
+     * @param platformName - Platform name
+     * @returns True if platform is registered
+     */
+    has(platformName) {
+        return this.platforms.has(platformName.toLowerCase());
+    }
+    /**
+     * Get all registered platform names
+     * @returns Array of platform names
+     */
+    getRegisteredPlatforms() {
+        return Array.from(this.platforms.keys());
+    }
+};
+PlatformRegistry = __decorate([
+    Injectable()
+], PlatformRegistry);
+export { PlatformRegistry };
+//# sourceMappingURL=platform-registry.service.js.map

package/dist/src/modules/platforms/base/platform-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-registry.service.js","sourceRoot":"","sources":["../../../../../src/modules/platforms/base/platform-registry.service.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGjE;;;GAGG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACV,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE1D;;;OAGG;IACH,QAAQ,CAAC,QAAmB;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,YAAoB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,mBAAmB,CAAC,aAAa,YAAY,oBAAoB,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,YAAoB;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF,CAAA;AAzCY,gBAAgB;IAD5B,UAAU,EAAE;GACA,gBAAgB,CAyC5B"}

package/dist/src/modules/platforms/base/platform.interface.d.ts

@@ -0,0 +1,39 @@
+import type { PostType } from '../../../common/enums/index.js';
+import type { PostRequestDto, PreviewResponseDto, PreviewErrorResponseDto } from '../../post/dto/index.js';
+/**
+ * Response from platform after successful publication
+ */
+export interface PlatformPublishResponse {
+    /** Platform-specific post ID */
+    postId: string;
+    /** Public URL to the post (if available) */
+    url?: string;
+    /** Raw response from platform API */
+    raw?: Record<string, any>;
+}
+/**
+ * Platform interface that all social media platforms must implement
+ * Defines the contract for publishing and previewing posts
+ */
+export interface IPlatform {
+    /** Platform name (e.g., 'telegram') */
+    readonly name: string;
+    /** List of supported post types */
+    readonly supportedTypes: PostType[];
+    /** Whether the platform supports cover image with other media (e.g. video cover) */
+    readonly supportsCoverWithMedia?: boolean;
+    /**
+     * Publish a post to the platform
+     * @param request - Post request data
+     * @param accountConfig - Account configuration
+     * @returns Publication result with post ID and URL
+     */
+    publish(request: PostRequestDto, accountConfig: any, abortSignal?: AbortSignal): Promise<PlatformPublishResponse>;
+    /**
+     * Preview a post without publishing
+     * @param request - Post request data
+     * @param accountConfig - Account configuration
+     * @returns Preview result with validation and conversion details
+     */
+    preview(request: PostRequestDto, accountConfig: any): Promise<PreviewResponseDto | PreviewErrorResponseDto>;
+}

package/dist/src/modules/platforms/base/platform.interface.js

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

package/dist/src/modules/platforms/base/platform.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.interface.js","sourceRoot":"","sources":["../../../../../src/modules/platforms/base/platform.interface.ts"],"names":[],"mappings":""}

package/dist/src/modules/platforms/platforms.module.d.ts

@@ -0,0 +1,13 @@
+import { OnModuleInit } from '@nestjs/common';
+import { TelegramPlatform } from './telegram/telegram.platform.js';
+import { TelegramAuthValidator } from './telegram/telegram-auth.validator.js';
+import { PlatformRegistry } from './base/platform-registry.service.js';
+import { AuthValidatorRegistry } from './base/auth-validator-registry.service.js';
+export declare class PlatformsModule implements OnModuleInit {
+    private readonly platformRegistry;
+    private readonly authValidatorRegistry;
+    private readonly telegramPlatform;
+    private readonly telegramAuthValidator;
+    constructor(platformRegistry: PlatformRegistry, authValidatorRegistry: AuthValidatorRegistry, telegramPlatform: TelegramPlatform, telegramAuthValidator: TelegramAuthValidator);
+    onModuleInit(): void;
+}

package/dist/src/modules/platforms/platforms.module.js

@@ -0,0 +1,59 @@
+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);
+};
+import { Module } from '@nestjs/common';
+import { TelegramPlatform } from './telegram/telegram.platform.js';
+import { MediaModule } from '../media/media.module.js';
+import { TelegramTypeDetector } from './telegram/telegram-type-detector.service.js';
+import { TelegramAuthValidator } from './telegram/telegram-auth.validator.js';
+import { PlatformRegistry } from './base/platform-registry.service.js';
+import { AuthValidatorRegistry } from './base/auth-validator-registry.service.js';
+let PlatformsModule = class PlatformsModule {
+    platformRegistry;
+    authValidatorRegistry;
+    telegramPlatform;
+    telegramAuthValidator;
+    constructor(platformRegistry, authValidatorRegistry, telegramPlatform, telegramAuthValidator) {
+        this.platformRegistry = platformRegistry;
+        this.authValidatorRegistry = authValidatorRegistry;
+        this.telegramPlatform = telegramPlatform;
+        this.telegramAuthValidator = telegramAuthValidator;
+    }
+    onModuleInit() {
+        // Register platforms
+        this.platformRegistry.register(this.telegramPlatform);
+        // Register auth validators
+        this.authValidatorRegistry.register(this.telegramAuthValidator);
+    }
+};
+PlatformsModule = __decorate([
+    Module({
+        imports: [MediaModule],
+        providers: [
+            PlatformRegistry,
+            AuthValidatorRegistry,
+            TelegramPlatform,
+            TelegramTypeDetector,
+            TelegramAuthValidator,
+        ],
+        exports: [
+            PlatformRegistry,
+            AuthValidatorRegistry,
+            TelegramPlatform,
+            TelegramTypeDetector,
+            MediaModule,
+        ],
+    }),
+    __metadata("design:paramtypes", [PlatformRegistry,
+        AuthValidatorRegistry,
+        TelegramPlatform,
+        TelegramAuthValidator])
+], PlatformsModule);
+export { PlatformsModule };
+//# sourceMappingURL=platforms.module.js.map

package/dist/src/modules/platforms/platforms.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.module.js","sourceRoot":"","sources":["../../../../src/modules/platforms/platforms.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAmB3E,IAAM,eAAe,GAArB,MAAM,eAAe;IAEP;IACA;IACA;IACA;IAJnB,YACmB,gBAAkC,EAClC,qBAA4C,EAC5C,gBAAkC,EAClC,qBAA4C;QAH5C,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,0BAAqB,GAArB,qBAAqB,CAAuB;IAC5D,CAAC;IAEJ,YAAY;QACV,qBAAqB;QACrB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAEtD,2BAA2B;QAC3B,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClE,CAAC;CACF,CAAA;AAfY,eAAe;IAjB3B,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,SAAS,EAAE;YACT,gBAAgB;YAChB,qBAAqB;YACrB,gBAAgB;YAChB,oBAAoB;YACpB,qBAAqB;SACtB;QACD,OAAO,EAAE;YACP,gBAAgB;YAChB,qBAAqB;YACrB,gBAAgB;YAChB,oBAAoB;YACpB,WAAW;SACZ;KACF,CAAC;qCAGqC,gBAAgB;QACX,qBAAqB;QAC1B,gBAAgB;QACX,qBAAqB;GALpD,eAAe,CAe3B"}

package/dist/src/modules/platforms/telegram/telegram-auth.validator.d.ts

@@ -0,0 +1,19 @@
+import { IAuthValidator } from '../base/auth-validator.interface.js';
+/**
+ * Telegram-specific auth validator
+ * Validates apiKey presence and format
+ */
+export declare class TelegramAuthValidator implements IAuthValidator {
+    readonly providerName = "telegram";
+    /**
+     * Validate Telegram auth object
+     * @param auth - Auth object with apiKey
+     * @returns Array of error messages (empty if valid)
+     */
+    validate(auth: Record<string, any>): string[];
+    /**
+     * Check if apiKey (bot token) has valid format
+     * Telegram bot tokens have format: 123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
+     */
+    private isValidBotToken;
+}

package/dist/src/modules/platforms/telegram/telegram-auth.validator.js

@@ -0,0 +1,51 @@
+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 { Injectable } from '@nestjs/common';
+/**
+ * Telegram-specific auth validator
+ * Validates apiKey presence and format
+ */
+let TelegramAuthValidator = class TelegramAuthValidator {
+    providerName = 'telegram';
+    /**
+     * Validate Telegram auth object
+     * @param auth - Auth object with apiKey
+     * @returns Array of error messages (empty if valid)
+     */
+    validate(auth) {
+        const errors = [];
+        if (!auth) {
+            errors.push('Auth object is required for Telegram');
+            return errors;
+        }
+        // Validate apiKey
+        if (!auth.apiKey) {
+            errors.push("Field 'apiKey' is required for Telegram auth");
+        }
+        else if (typeof auth.apiKey !== 'string') {
+            errors.push("Field 'apiKey' must be a string");
+        }
+        else if (!this.isValidBotToken(auth.apiKey)) {
+            errors.push("Field 'apiKey' has invalid format (expected: 123456789:ABC-DEF...)");
+        }
+        return errors;
+    }
+    /**
+     * Check if apiKey (bot token) has valid format
+     * Telegram bot tokens have format: 123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
+     */
+    isValidBotToken(token) {
+        // Basic format check: number:alphanumeric-string
+        const tokenRegex = /^\d+:[A-Za-z0-9_-]+$/;
+        return tokenRegex.test(token);
+    }
+};
+TelegramAuthValidator = __decorate([
+    Injectable()
+], TelegramAuthValidator);
+export { TelegramAuthValidator };
+//# sourceMappingURL=telegram-auth.validator.js.map

package/dist/src/modules/platforms/telegram/telegram-auth.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-auth.validator.js","sourceRoot":"","sources":["../../../../../src/modules/platforms/telegram/telegram-auth.validator.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C;;;GAGG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACvB,YAAY,GAAG,UAAU,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,IAAyB;QAChC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,kBAAkB;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACpF,CAAC;QAID,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,KAAa;QACnC,iDAAiD;QACjD,MAAM,UAAU,GAAG,sBAAsB,CAAC;QAC1C,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF,CAAA;AAvCY,qBAAqB;IADjC,UAAU,EAAE;GACA,qBAAqB,CAuCjC"}

package/dist/src/modules/platforms/telegram/telegram-type-detector.service.d.ts

@@ -0,0 +1,18 @@
+import { PostRequestDto } from '../../post/dto/index.js';
+import { PostType } from '../../../common/enums/index.js';
+/**
+ * Service for determining message type for Telegram
+ */
+export declare class TelegramTypeDetector {
+    /**
+     * Determine Telegram message type based on request data
+     * Priority order:
+     * 1. media[] -> ALBUM
+     * 2. document -> DOCUMENT
+     * 3. audio -> AUDIO
+     * 4. video -> VIDEO
+     * 5. cover -> IMAGE
+     * 6. no media -> POST
+     */
+    detectType(request: PostRequestDto): PostType;
+}

package/dist/src/modules/platforms/telegram/telegram-type-detector.service.js

@@ -0,0 +1,47 @@
+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 { Injectable } from '@nestjs/common';
+import { PostType } from '../../../common/enums/index.js';
+import { MediaInputHelper } from '../../../common/helpers/media-input.helper.js';
+import { MediaPriorityValidator } from '../../../common/validators/media-priority.validator.js';
+/**
+ * Service for determining message type for Telegram
+ */
+let TelegramTypeDetector = class TelegramTypeDetector {
+    /**
+     * Determine Telegram message type based on request data
+     * Priority order:
+     * 1. media[] -> ALBUM
+     * 2. document -> DOCUMENT
+     * 3. audio -> AUDIO
+     * 4. video -> VIDEO
+     * 5. cover -> IMAGE
+     * 6. no media -> POST
+     */
+    detectType(request) {
+        // If type is explicitly set and not AUTO, return it
+        if (request.type && request.type !== PostType.AUTO) {
+            return request.type;
+        }
+        // Priority 1-4: Check primary media fields (ALBUM, DOCUMENT, AUDIO, VIDEO)
+        const primaryType = MediaPriorityValidator.detectPrimaryMediaField(request);
+        if (primaryType) {
+            return primaryType;
+        }
+        // Priority 5: cover -> IMAGE
+        if (MediaInputHelper.isDefined(request.cover)) {
+            return PostType.IMAGE;
+        }
+        // Priority 6: no media -> POST
+        return PostType.POST;
+    }
+};
+TelegramTypeDetector = __decorate([
+    Injectable()
+], TelegramTypeDetector);
+export { TelegramTypeDetector };
+//# sourceMappingURL=telegram-type-detector.service.js.map

package/dist/src/modules/platforms/telegram/telegram-type-detector.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-type-detector.service.js","sourceRoot":"","sources":["../../../../../src/modules/platforms/telegram/telegram-type-detector.service.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG;;GAEG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAuB;QAChC,oDAAoD;QACpD,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnD,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;QAED,2EAA2E;QAC3E,MAAM,WAAW,GAAG,sBAAsB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC5E,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,6BAA6B;QAC7B,IAAI,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC;QACxB,CAAC;QAED,+BAA+B;QAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF,CAAA;AA/BY,oBAAoB;IADhC,UAAU,EAAE;GACA,oBAAoB,CA+BhC"}

package/dist/src/modules/platforms/telegram/telegram.platform.d.ts

@@ -0,0 +1,58 @@
+import { IPlatform, PlatformPublishResponse } from '../base/platform.interface.js';
+import { PostType } from '../../../common/enums/index.js';
+import { PostRequestDto, PreviewResponseDto, PreviewErrorResponseDto } from '../../post/dto/index.js';
+import { MediaService } from '../../media/media.service.js';
+import { TelegramTypeDetector } from './telegram-type-detector.service.js';
+import type { AccountConfig } from '../../app-config/interfaces/app-config.interface.js';
+export interface TelegramAccountConfig extends AccountConfig {
+    /** Whether to disable notifications for this account by default */
+    disableNotification?: boolean;
+}
+export declare class TelegramPlatform implements IPlatform {
+    private readonly mediaService;
+    private readonly typeDetector;
+    readonly name = "telegram";
+    readonly supportedTypes: PostType[];
+    readonly supportsCoverWithMedia = false;
+    private readonly logger;
+    private readonly MAX_MEDIA_GROUP_SIZE;
+    constructor(mediaService: MediaService, typeDetector: TelegramTypeDetector);
+    publish(request: PostRequestDto, accountConfig: TelegramAccountConfig, abortSignal?: AbortSignal): Promise<PlatformPublishResponse>;
+    preview(request: PostRequestDto, accountConfig: TelegramAccountConfig): Promise<PreviewResponseDto | PreviewErrorResponseDto>;
+    private validateRequest;
+    /**
+     * Prepares message data for sending to Telegram.
+     * Maps bodyFormat to parse_mode without converting the body content.
+     * Body is sent as-is to Telegram API.
+     *
+     * Standard formats (text, html, md) are mapped to Telegram parse_mode.
+     * Custom values (e.g., MarkdownV2) are passed as-is.
+     * If parse_mode is specified in options, it overrides bodyFormat mapping.
+     */
+    private prepareMessageData;
+    /**
+     * Resolve Telegram chat identifier from request and account configuration.
+     *
+     * Priority:
+     * 1. request.channelId
+     * 2. accountConfig.channelId (from config.yaml)
+     * 3. accountConfig.auth.chatId (legacy, for backward compatibility)
+     */
+    private resolveChatId;
+    private sendMessage;
+    private sendPhoto;
+    private sendVideo;
+    private sendAudio;
+    private sendDocument;
+    private sendMediaGroup;
+    /**
+     * Map MediaType to Telegram media group type
+     * Falls back to URL extension detection if no explicit type provided
+     */
+    private mapMediaTypeToTelegram;
+    private getRequiredFieldsErrors;
+    private getMediaUrlErrors;
+    private getIgnoredFieldsWarnings;
+    private getIgnoredMediaWarnings;
+    private buildPostUrl;
+}