bozonx-social-media-posting 1.1.0

package/dist/src/app.constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Global application constants
+ */
+/**
+ * Graceful shutdown timeout in milliseconds
+ * Maximum time to wait for in-flight requests to complete before forcing shutdown
+ */
+export declare const GRACEFUL_SHUTDOWN_TIMEOUT_MS = 25000;

package/dist/src/app.constants.js

@@ -0,0 +1,9 @@
+/**
+ * Global application constants
+ */
+/**
+ * Graceful shutdown timeout in milliseconds
+ * Maximum time to wait for in-flight requests to complete before forcing shutdown
+ */
+export const GRACEFUL_SHUTDOWN_TIMEOUT_MS = 25000;
+//# sourceMappingURL=app.constants.js.map

package/dist/src/app.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.constants.js","sourceRoot":"","sources":["../../src/app.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC"}

package/dist/src/common/enums/body-format.enum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Supported body content formats for post text
+ * Used for content conversion and platform-specific formatting
+ */
+export declare enum BodyFormat {
+    /** HTML markup */
+    HTML = "html",
+    /** Markdown syntax */
+    MARKDOWN = "md",
+    /** Plain text without formatting */
+    TEXT = "text"
+}

package/dist/src/common/enums/body-format.enum.js

@@ -0,0 +1,14 @@
+/**
+ * Supported body content formats for post text
+ * Used for content conversion and platform-specific formatting
+ */
+export var BodyFormat;
+(function (BodyFormat) {
+    /** HTML markup */
+    BodyFormat["HTML"] = "html";
+    /** Markdown syntax */
+    BodyFormat["MARKDOWN"] = "md";
+    /** Plain text without formatting */
+    BodyFormat["TEXT"] = "text";
+})(BodyFormat || (BodyFormat = {}));
+//# sourceMappingURL=body-format.enum.js.map

package/dist/src/common/enums/body-format.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-format.enum.js","sourceRoot":"","sources":["../../../../src/common/enums/body-format.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,kBAAkB;IAClB,2BAAa,CAAA;IACb,sBAAsB;IACtB,6BAAe,CAAA;IACf,oCAAoC;IACpC,2BAAa,CAAA;AACf,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB"}

package/dist/src/common/enums/error-code.enum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Error codes for categorizing different types of failures
+ * Used in error responses to provide machine-readable error classification
+ */
+export declare enum ErrorCode {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    RATE_LIMIT_ERROR = "RATE_LIMIT_ERROR",
+    PLATFORM_ERROR = "PLATFORM_ERROR",
+    AUTH_ERROR = "AUTH_ERROR",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}

package/dist/src/common/enums/error-code.enum.js

@@ -0,0 +1,14 @@
+/**
+ * Error codes for categorizing different types of failures
+ * Used in error responses to provide machine-readable error classification
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ErrorCode["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+    ErrorCode["RATE_LIMIT_ERROR"] = "RATE_LIMIT_ERROR";
+    ErrorCode["PLATFORM_ERROR"] = "PLATFORM_ERROR";
+    ErrorCode["AUTH_ERROR"] = "AUTH_ERROR";
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+//# sourceMappingURL=error-code.enum.js.map

package/dist/src/common/enums/error-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-code.enum.js","sourceRoot":"","sources":["../../../../src/common/enums/error-code.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACjB,kDAAqC,CAAA;IACrC,4CAA+B,CAAA;IAC/B,kDAAqC,CAAA;IACrC,8CAAiC,CAAA;IACjC,sCAAyB,CAAA;IACzB,8CAAiC,CAAA;AACrC,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB"}

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

@@ -0,0 +1,3 @@
+export * from './post-type.enum.js';
+export * from './body-format.enum.js';
+export * from './error-code.enum.js';

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

@@ -0,0 +1,4 @@
+export * from './post-type.enum.js';
+export * from './body-format.enum.js';
+export * from './error-code.enum.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/enums/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/src/common/enums/post-type.enum.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Supported post types across different social media platforms
+ * AUTO allows the system to automatically detect the appropriate type based on content
+ */
+export declare enum PostType {
+    /** Automatically detect post type based on provided media fields */
+    AUTO = "auto",
+    /** Text-only post without media */
+    POST = "post",
+    /** Long-form article with rich formatting */
+    ARTICLE = "article",
+    /** Single image post */
+    IMAGE = "image",
+    /** Multiple images/videos in a single post */
+    ALBUM = "album",
+    /** Video post */
+    VIDEO = "video",
+    /** Short-form video (e.g., TikTok, Reels) */
+    SHORT = "short",
+    /** Audio file post */
+    AUDIO = "audio",
+    /** Document file post */
+    DOCUMENT = "document",
+    /** Story/status update (temporary content) */
+    STORY = "story",
+    /** Poll/survey post */
+    POLL = "poll"
+}

package/dist/src/common/enums/post-type.enum.js

@@ -0,0 +1,30 @@
+/**
+ * Supported post types across different social media platforms
+ * AUTO allows the system to automatically detect the appropriate type based on content
+ */
+export var PostType;
+(function (PostType) {
+    /** Automatically detect post type based on provided media fields */
+    PostType["AUTO"] = "auto";
+    /** Text-only post without media */
+    PostType["POST"] = "post";
+    /** Long-form article with rich formatting */
+    PostType["ARTICLE"] = "article";
+    /** Single image post */
+    PostType["IMAGE"] = "image";
+    /** Multiple images/videos in a single post */
+    PostType["ALBUM"] = "album";
+    /** Video post */
+    PostType["VIDEO"] = "video";
+    /** Short-form video (e.g., TikTok, Reels) */
+    PostType["SHORT"] = "short";
+    /** Audio file post */
+    PostType["AUDIO"] = "audio";
+    /** Document file post */
+    PostType["DOCUMENT"] = "document";
+    /** Story/status update (temporary content) */
+    PostType["STORY"] = "story";
+    /** Poll/survey post */
+    PostType["POLL"] = "poll";
+})(PostType || (PostType = {}));
+//# sourceMappingURL=post-type.enum.js.map

package/dist/src/common/enums/post-type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-type.enum.js","sourceRoot":"","sources":["../../../../src/common/enums/post-type.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,QAuBX;AAvBD,WAAY,QAAQ;IAClB,oEAAoE;IACpE,yBAAa,CAAA;IACb,mCAAmC;IACnC,yBAAa,CAAA;IACb,6CAA6C;IAC7C,+BAAmB,CAAA;IACnB,wBAAwB;IACxB,2BAAe,CAAA;IACf,8CAA8C;IAC9C,2BAAe,CAAA;IACf,iBAAiB;IACjB,2BAAe,CAAA;IACf,6CAA6C;IAC7C,2BAAe,CAAA;IACf,sBAAsB;IACtB,2BAAe,CAAA;IACf,yBAAyB;IACzB,iCAAqB,CAAA;IACrB,8CAA8C;IAC9C,2BAAe,CAAA;IACf,uBAAuB;IACvB,yBAAa,CAAA;AACf,CAAC,EAvBW,QAAQ,KAAR,QAAQ,QAuBnB"}

package/dist/src/common/filters/all-exceptions.filter.d.ts

@@ -0,0 +1,13 @@
+import { type ArgumentsHost, type ExceptionFilter } from '@nestjs/common';
+import { PinoLogger } from 'nestjs-pino';
+/**
+ * Global exception filter that catches all exceptions
+ * and formats them in a consistent way for Fastify responses
+ */
+export declare class AllExceptionsFilter implements ExceptionFilter {
+    private readonly logger;
+    constructor(logger: PinoLogger);
+    catch(exception: unknown, host: ArgumentsHost): void;
+    private extractMessage;
+    private buildErrorResponse;
+}

package/dist/src/common/filters/all-exceptions.filter.js

@@ -0,0 +1,103 @@
+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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AllExceptionsFilter_1;
+import { Catch, HttpException, HttpStatus, Inject, } from '@nestjs/common';
+import { PinoLogger } from 'nestjs-pino';
+/**
+ * Global exception filter that catches all exceptions
+ * and formats them in a consistent way for Fastify responses
+ */
+let AllExceptionsFilter = AllExceptionsFilter_1 = class AllExceptionsFilter {
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+        logger.setContext(AllExceptionsFilter_1.name);
+    }
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        const request = ctx.getRequest();
+        // Preserve statusCode from non-HttpException errors (e.g., Fastify plugins)
+        const status = exception instanceof HttpException
+            ? exception.getStatus()
+            : typeof exception?.statusCode === 'number'
+                ? exception.statusCode
+                : HttpStatus.INTERNAL_SERVER_ERROR;
+        const message = this.extractMessage(exception);
+        const errorResponse = this.buildErrorResponse(exception);
+        const logContext = {
+            status,
+            method: request.method,
+            url: request.url,
+            requestId: request.id,
+            err: exception,
+        };
+        // Log error for internal tracking
+        if (status >= 500) {
+            this.logger.error(logContext, message);
+        }
+        else {
+            this.logger.warn(logContext, message);
+        }
+        void response.status(status).send({
+            statusCode: status,
+            timestamp: new Date().toISOString(),
+            path: request.url,
+            method: request.method,
+            message,
+            error: errorResponse,
+        });
+    }
+    extractMessage(exception) {
+        if (exception instanceof HttpException) {
+            const response = exception.getResponse();
+            if (typeof response === 'string') {
+                return response;
+            }
+            if (typeof response === 'object' && response !== null && 'message' in response) {
+                const msg = response.message;
+                if (Array.isArray(msg)) {
+                    return msg.join(', ');
+                }
+                if (typeof msg === 'string') {
+                    return msg;
+                }
+            }
+            return exception.message;
+        }
+        if (exception instanceof Error) {
+            return exception.message;
+        }
+        return 'Internal server error';
+    }
+    buildErrorResponse(exception) {
+        if (exception instanceof HttpException) {
+            const response = exception.getResponse();
+            if (typeof response === 'object' && response !== null) {
+                return response;
+            }
+            return exception.name;
+        }
+        if (exception instanceof Error) {
+            return exception.name;
+        }
+        return 'UnknownError';
+    }
+};
+AllExceptionsFilter = AllExceptionsFilter_1 = __decorate([
+    Catch(),
+    __param(0, Inject(PinoLogger)),
+    __metadata("design:paramtypes", [PinoLogger])
+], AllExceptionsFilter);
+export { AllExceptionsFilter };
+//# sourceMappingURL=all-exceptions.filter.js.map

package/dist/src/common/filters/all-exceptions.filter.js.map

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

package/dist/src/common/helpers/media-input.helper.d.ts

@@ -0,0 +1,73 @@
+import { MediaInput, MediaInputObject, MediaType } from '../types/media-input.type.js';
+import { InputFile } from 'grammy';
+/**
+ * Helper class for working with MediaInput
+ */
+export declare class MediaInputHelper {
+    /**
+     * Check if a string is a valid URL
+     * @param str - String to check
+     * @returns True if string is a valid URL
+     */
+    private static isValidUrl;
+    /**
+     * Type guard to check if MediaInput is an object with src property
+     * @param input - MediaInput to check
+     * @returns True if input is a MediaInputObject
+     */
+    static isObject(input: MediaInput): input is MediaInputObject;
+    /**
+     * Extract URL from MediaInput
+     * Checks if the src value is a valid URL
+     * @param input - MediaInput to extract URL from
+     * @returns URL string if available, undefined otherwise
+     */
+    static getUrl(input: MediaInput): string | undefined;
+    /**
+     * Extract Telegram file_id from MediaInput
+     * Available when src is not a valid URL
+     * @param input - MediaInput to extract file_id from
+     * @returns Telegram file_id if available, undefined otherwise
+     */
+    static getFileId(input: MediaInput): string | undefined;
+    /**
+     * Extract hasSpoiler flag from MediaInput
+     * Used for Telegram spoiler animation feature
+     * @param input - MediaInput to extract flag from
+     * @returns True if spoiler is enabled, false otherwise (defaults to false)
+     */
+    static getHasSpoiler(input: MediaInput): boolean;
+    /**
+     * Extract explicit media type from MediaInput
+     * Used in media arrays to override auto-detection by URL extension
+     * @param input - MediaInput to extract type from
+     * @returns MediaType if specified, undefined otherwise
+     */
+    static getType(input: MediaInput): MediaType | undefined;
+    /**
+     * Convert MediaInput to Telegram-compatible format
+     * Prioritizes file_id over URL for better performance and reliability
+     * @param input - MediaInput to convert
+     * @returns Telegram file_id string or URL string
+     * @throws Error if src is missing or invalid
+     */
+    static toTelegramInput(input: MediaInput): string | InputFile;
+    /**
+     * Check if input has valid MediaInput structure
+     * @param input - Input to check
+     * @returns True if input is an object with src
+     */
+    static isValidShape(input: any): boolean;
+    /**
+     * Check if MediaInput array is not empty and contains valid items
+     * @param input - Optional array of MediaInput
+     * @returns True if array exists and has at least one valid element
+     */
+    static isNotEmpty(input?: MediaInput[]): boolean;
+    /**
+     * Check if MediaInput is defined, not null, and has valid shape
+     * @param input - Optional MediaInput to check
+     * @returns True if input is defined, not null, and valid
+     */
+    static isDefined(input?: MediaInput): boolean;
+}

package/dist/src/common/helpers/media-input.helper.js

@@ -0,0 +1,122 @@
+import { BadRequestException } from '@nestjs/common';
+/**
+ * Helper class for working with MediaInput
+ */
+export class MediaInputHelper {
+    /**
+     * Check if a string is a valid URL
+     * @param str - String to check
+     * @returns True if string is a valid URL
+     */
+    static isValidUrl(str) {
+        try {
+            new URL(str);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Type guard to check if MediaInput is an object with src property
+     * @param input - MediaInput to check
+     * @returns True if input is a MediaInputObject
+     */
+    static isObject(input) {
+        return typeof input === 'object' && input !== null;
+    }
+    /**
+     * Extract URL from MediaInput
+     * Checks if the src value is a valid URL
+     * @param input - MediaInput to extract URL from
+     * @returns URL string if available, undefined otherwise
+     */
+    static getUrl(input) {
+        if (this.isObject(input)) {
+            return this.isValidUrl(input.src) ? input.src : undefined;
+        }
+        return undefined;
+    }
+    /**
+     * Extract Telegram file_id from MediaInput
+     * Available when src is not a valid URL
+     * @param input - MediaInput to extract file_id from
+     * @returns Telegram file_id if available, undefined otherwise
+     */
+    static getFileId(input) {
+        if (this.isObject(input)) {
+            return this.isValidUrl(input.src) ? undefined : input.src;
+        }
+        return undefined;
+    }
+    /**
+     * Extract hasSpoiler flag from MediaInput
+     * Used for Telegram spoiler animation feature
+     * @param input - MediaInput to extract flag from
+     * @returns True if spoiler is enabled, false otherwise (defaults to false)
+     */
+    static getHasSpoiler(input) {
+        if (this.isObject(input)) {
+            return input.hasSpoiler ?? false;
+        }
+        return false;
+    }
+    /**
+     * Extract explicit media type from MediaInput
+     * Used in media arrays to override auto-detection by URL extension
+     * @param input - MediaInput to extract type from
+     * @returns MediaType if specified, undefined otherwise
+     */
+    static getType(input) {
+        if (this.isObject(input)) {
+            return input.type;
+        }
+        return undefined;
+    }
+    /**
+     * Convert MediaInput to Telegram-compatible format
+     * Prioritizes file_id over URL for better performance and reliability
+     * @param input - MediaInput to convert
+     * @returns Telegram file_id string or URL string
+     * @throws Error if src is missing or invalid
+     */
+    static toTelegramInput(input) {
+        const fileId = this.getFileId(input);
+        if (fileId) {
+            return fileId;
+        }
+        const url = this.getUrl(input);
+        if (url) {
+            return url;
+        }
+        throw new BadRequestException('MediaInput must be either a string or an object with src property');
+    }
+    /**
+     * Check if input has valid MediaInput structure
+     * @param input - Input to check
+     * @returns True if input is an object with src
+     */
+    static isValidShape(input) {
+        if (typeof input === 'object' && input !== null) {
+            return typeof input.src === 'string' && input.src.length > 0;
+        }
+        return false;
+    }
+    /**
+     * Check if MediaInput array is not empty and contains valid items
+     * @param input - Optional array of MediaInput
+     * @returns True if array exists and has at least one valid element
+     */
+    static isNotEmpty(input) {
+        return Array.isArray(input) && input.some(item => this.isValidShape(item));
+    }
+    /**
+     * Check if MediaInput is defined, not null, and has valid shape
+     * @param input - Optional MediaInput to check
+     * @returns True if input is defined, not null, and valid
+     */
+    static isDefined(input) {
+        return input !== undefined && input !== null && this.isValidShape(input);
+    }
+}
+//# sourceMappingURL=media-input.helper.js.map

package/dist/src/common/helpers/media-input.helper.js.map

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

package/dist/src/common/interceptors/shutdown.interceptor.d.ts

@@ -0,0 +1,12 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { ShutdownService } from '../services/shutdown.service.js';
+/**
+ * Interceptor that rejects new requests during shutdown
+ * and tracks in-flight requests for graceful shutdown
+ */
+export declare class ShutdownInterceptor implements NestInterceptor {
+    private readonly shutdownService;
+    constructor(shutdownService: ShutdownService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}

package/dist/src/common/interceptors/shutdown.interceptor.js

@@ -0,0 +1,41 @@
+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 { Injectable, ServiceUnavailableException, } from '@nestjs/common';
+import { throwError } from 'rxjs';
+import { tap, catchError } from 'rxjs/operators';
+import { ShutdownService } from '../services/shutdown.service.js';
+/**
+ * Interceptor that rejects new requests during shutdown
+ * and tracks in-flight requests for graceful shutdown
+ */
+let ShutdownInterceptor = class ShutdownInterceptor {
+    shutdownService;
+    constructor(shutdownService) {
+        this.shutdownService = shutdownService;
+    }
+    intercept(context, next) {
+        if (this.shutdownService.shuttingDown) {
+            throw new ServiceUnavailableException('Server is shutting down');
+        }
+        this.shutdownService.trackRequest();
+        return next.handle().pipe(tap(() => {
+            this.shutdownService.untrackRequest();
+        }), catchError(err => {
+            this.shutdownService.untrackRequest();
+            return throwError(() => err);
+        }));
+    }
+};
+ShutdownInterceptor = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ShutdownService])
+], ShutdownInterceptor);
+export { ShutdownInterceptor };
+//# sourceMappingURL=shutdown.interceptor.js.map

package/dist/src/common/interceptors/shutdown.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.interceptor.js","sourceRoot":"","sources":["../../../../src/common/interceptors/shutdown.interceptor.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACL,UAAU,EAIV,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAc,UAAU,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE;;;GAGG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IACD;IAA7B,YAA6B,eAAgC;QAAhC,oBAAe,GAAf,eAAe,CAAiB;IAAG,CAAC;IAEjE,SAAS,CAAC,OAAyB,EAAE,IAAiB;QACpD,IAAI,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;YACtC,MAAM,IAAI,2BAA2B,CAAC,yBAAyB,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;QAEpC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CACvB,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC;QACxC,CAAC,CAAC,EACF,UAAU,CAAC,GAAG,CAAC,EAAE;YACf,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC;YACtC,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF,CAAA;AApBY,mBAAmB;IAD/B,UAAU,EAAE;qCAEmC,eAAe;GADlD,mBAAmB,CAoB/B"}

package/dist/src/common/interfaces/logger.interface.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Logger interface for library mode
+ * Allows users to provide their own logger implementation
+ */
+export interface ILogger {
+    /**
+     * Log debug message
+     * @param message - Message to log
+     * @param context - Optional context/source of the log
+     */
+    debug(message: string, context?: string): void;
+    /**
+     * Log informational message
+     * @param message - Message to log
+     * @param context - Optional context/source of the log
+     */
+    log(message: string, context?: string): void;
+    /**
+     * Log warning message
+     * @param message - Message to log
+     * @param context - Optional context/source of the log
+     */
+    warn(message: string, context?: string): void;
+    /**
+     * Log error message
+     * @param message - Message to log
+     * @param trace - Optional stack trace
+     * @param context - Optional context/source of the log
+     */
+    error(message: string, trace?: string, context?: string): void;
+}
+/**
+ * Simple console logger implementation
+ * Used as default logger in library mode
+ */
+export declare class ConsoleLogger implements ILogger {
+    private readonly logLevel;
+    constructor(logLevel?: 'debug' | 'info' | 'warn' | 'error');
+    private shouldLog;
+    debug(message: string, context?: string): void;
+    log(message: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    error(message: string, trace?: string, context?: string): void;
+}

package/dist/src/common/interfaces/logger.interface.js

@@ -0,0 +1,44 @@
+/**
+ * Simple console logger implementation
+ * Used as default logger in library mode
+ */
+export class ConsoleLogger {
+    logLevel;
+    constructor(logLevel = 'warn') {
+        this.logLevel = logLevel;
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        const currentLevelIndex = levels.indexOf(this.logLevel);
+        const messageLevelIndex = levels.indexOf(level);
+        return messageLevelIndex >= currentLevelIndex;
+    }
+    debug(message, context) {
+        if (this.shouldLog('debug')) {
+            const prefix = context ? `[${context}]` : '';
+            console.debug(`${prefix} ${message}`);
+        }
+    }
+    log(message, context) {
+        if (this.shouldLog('info')) {
+            const prefix = context ? `[${context}]` : '';
+            console.log(`${prefix} ${message}`);
+        }
+    }
+    warn(message, context) {
+        if (this.shouldLog('warn')) {
+            const prefix = context ? `[${context}]` : '';
+            console.warn(`${prefix} ${message}`);
+        }
+    }
+    error(message, trace, context) {
+        if (this.shouldLog('error')) {
+            const prefix = context ? `[${context}]` : '';
+            console.error(`${prefix} ${message}`);
+            if (trace) {
+                console.error(trace);
+            }
+        }
+    }
+}
+//# sourceMappingURL=logger.interface.js.map

package/dist/src/common/interfaces/logger.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/logger.interface.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,WAAgD,MAAM;QAAtD,aAAQ,GAAR,QAAQ,CAA8C;IAAG,CAAC;IAE/E,SAAS,CAAC,KAA0C;QAC1D,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,iBAAiB,IAAI,iBAAiB,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAgB;QACrC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,OAAgB;QACnC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAgB;QACpC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAc,EAAE,OAAgB;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;YACtC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,2 @@
+export declare class ShutdownModule {
+}