@baasix/baasix 0.1.0

package/dist/services/StatsService.js

@@ -0,0 +1,40 @@
+import ReportService from "./ReportService.js";
+class StatsService {
+    accountability;
+    constructor(params = {}) {
+        this.accountability = params?.accountability;
+    }
+    async generateStats(statsQueries) {
+        if (!Array.isArray(statsQueries) || statsQueries.length === 0) {
+            throw new Error("statsQueries must be a non-empty array");
+        }
+        const results = {};
+        // Process stats queries sequentially - fail fast on permission errors
+        for (const statsQuery of statsQueries) {
+            const { name, query, collection } = statsQuery;
+            if (!name) {
+                throw new Error('Each stats query must have a "name" property');
+            }
+            if (!query) {
+                throw new Error('Each stats query must have a "query" property');
+            }
+            if (!collection) {
+                throw new Error('Each stats query must have a "collection" property');
+            }
+            // Create a new ReportService instance for each collection
+            // Don't catch errors - let permission errors propagate up
+            const reportService = new ReportService(collection, {
+                accountability: this.accountability,
+            });
+            const result = await reportService.generateReport(query);
+            results[name] = result;
+        }
+        return {
+            data: results,
+            totalStats: statsQueries.length,
+            successfulStats: statsQueries.length,
+        };
+    }
+}
+export default StatsService;
+//# sourceMappingURL=StatsService.js.map

package/dist/services/StatsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatsService.js","sourceRoot":"","sources":["../../baasix/services/StatsService.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAG/C,MAAM,YAAY;IACR,cAAc,CAA6B;IAEnD,YAAY,SAA8C,EAAE;QAC1D,IAAI,CAAC,cAAc,GAAG,MAAM,EAAE,cAAc,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,YAA0B;QAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,OAAO,GAAwB,EAAE,CAAC;QAExC,sEAAsE;QACtE,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;YAE/C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YAED,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACxE,CAAC;YAED,0DAA0D;YAC1D,0DAA0D;YAC1D,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,UAAU,EAAE;gBAClD,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACzB,CAAC;QAED,OAAO;YACL,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,YAAY,CAAC,MAAM;YAC/B,eAAe,EAAE,YAAY,CAAC,MAAM;SACrC,CAAC;IACJ,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/services/StorageService.d.ts

@@ -0,0 +1,20 @@
+import type { StorageProvider } from '../types/index.js';
+declare class StorageService {
+    private providers;
+    constructor();
+    initialize(): void;
+    initializeProvider(service: string): void;
+    initializeLocalStorage(service: string, upperService: string): void;
+    initializeS3Storage(service: string, upperService: string): void;
+    getProvider(service: string): StorageProvider;
+    saveFile(service: string, filePath: string, fileContent: Buffer | Uint8Array): Promise<string>;
+    getFile(service: string, filePath: string): Promise<any>;
+    deleteFile(service: string, filePath: string): Promise<void>;
+    getPublicUrl(service: string, filePath: string): Promise<string>;
+}
+declare global {
+    var __baasix_storageService: StorageService | undefined;
+}
+declare const storageService: StorageService;
+export default storageService;
+//# sourceMappingURL=StorageService.d.ts.map

package/dist/services/StorageService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../baasix/services/StorageService.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,cAAM,cAAc;IAClB,OAAO,CAAC,SAAS,CAAuC;;IAMxD,UAAU,IAAI,IAAI;IAalB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBzC,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAqCnE,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAqEhE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAQvC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9F,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAKxD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKvE;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,uBAAuB,EAAE,cAAc,GAAG,SAAS,CAAC;CACzD;AAOD,QAAA,MAAM,cAAc,gBAAqC,CAAC;AAC1D,eAAe,cAAc,CAAC"}

package/dist/services/StorageService.js

@@ -0,0 +1,164 @@
+import env from "../utils/env.js";
+import fs from "fs/promises";
+import path from "path";
+import { S3Client, PutObjectCommand, GetObjectCommand, DeleteObjectCommand } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+import { existsSync, mkdirSync } from "fs";
+import { getProjectPath } from "../utils/dirname.js";
+class StorageService {
+    providers = {};
+    constructor() {
+        console.info("Initializing Storage Service");
+    }
+    initialize() {
+        const servicesEnabled = env.get("STORAGE_SERVICES_ENABLED")?.split(",") || [];
+        if (servicesEnabled.length === 0) {
+            console.warn("No storage services enabled. Check your STORAGE_SERVICES_ENABLED environment variable.");
+            return;
+        }
+        servicesEnabled.forEach((service) => this.initializeProvider(service.trim()));
+        console.info("Storage Service Initialization Complete");
+    }
+    initializeProvider(service) {
+        const upperService = service.toUpperCase();
+        const driver = env.get(`${upperService}_STORAGE_DRIVER`);
+        if (!driver) {
+            console.warn(`Storage driver not specified for ${service}. Skipping.`);
+            return;
+        }
+        switch (driver) {
+            case "LOCAL":
+                this.initializeLocalStorage(service, upperService);
+                break;
+            case "S3":
+                this.initializeS3Storage(service, upperService);
+                break;
+            default:
+                console.warn(`Unknown storage driver '${driver}' for ${service}. Skipping.`);
+        }
+    }
+    initializeLocalStorage(service, upperService) {
+        const storagePath = env.get(`${upperService}_STORAGE_PATH`);
+        if (!storagePath) {
+            throw new Error(`${upperService}_STORAGE_PATH is not defined`);
+        }
+        if (!existsSync(storagePath)) {
+            mkdirSync(storagePath, { recursive: true });
+        }
+        const basePath = path.resolve(getProjectPath(storagePath));
+        this.providers[service] = {
+            driver: "LOCAL",
+            basePath,
+            async saveFile(filePath, fileContent) {
+                const fullPath = path.join(basePath, filePath);
+                await fs.mkdir(path.dirname(fullPath), { recursive: true });
+                await fs.writeFile(fullPath, fileContent);
+                return filePath;
+            },
+            async getFile(filePath) {
+                const fullPath = path.join(basePath, filePath);
+                return fs.readFile(fullPath);
+            },
+            async deleteFile(filePath) {
+                const fullPath = path.join(basePath, filePath);
+                await fs.unlink(fullPath);
+            },
+            getPublicUrl(filePath) {
+                return `/storage/${service}/${filePath}`;
+            },
+        };
+        console.info(`Loaded LOCAL Storage Config for: ${service}`);
+    }
+    initializeS3Storage(service, upperService) {
+        const requiredEnvVars = [
+            `${upperService}_STORAGE_ACCESS_KEY_ID`,
+            `${upperService}_STORAGE_SECRET_ACCESS_KEY`,
+            `${upperService}_STORAGE_REGION`,
+            `${upperService}_STORAGE_BUCKET`,
+            `${upperService}_STORAGE_ENDPOINT`,
+        ];
+        requiredEnvVars.forEach((envVar) => {
+            if (!env.get(envVar)) {
+                throw new Error(`${envVar} is not defined`);
+            }
+        });
+        const s3Client = new S3Client({
+            region: env.get(`${upperService}_STORAGE_REGION`),
+            credentials: {
+                accessKeyId: env.get(`${upperService}_STORAGE_ACCESS_KEY_ID`),
+                secretAccessKey: env.get(`${upperService}_STORAGE_SECRET_ACCESS_KEY`),
+            },
+            endpoint: "https://" + env.get(`${upperService}_STORAGE_ENDPOINT`),
+        });
+        const bucketName = env.get(`${upperService}_STORAGE_BUCKET`);
+        this.providers[service] = {
+            driver: "S3",
+            s3Client,
+            bucketName,
+            async saveFile(filePath, fileContent) {
+                const command = new PutObjectCommand({
+                    Bucket: bucketName,
+                    Key: filePath,
+                    Body: fileContent,
+                });
+                await s3Client.send(command);
+                return filePath;
+            },
+            async getFile(filePath) {
+                const command = new GetObjectCommand({
+                    Bucket: bucketName,
+                    Key: filePath,
+                });
+                const response = await s3Client.send(command);
+                return response.Body;
+            },
+            async deleteFile(filePath) {
+                const command = new DeleteObjectCommand({
+                    Bucket: bucketName,
+                    Key: filePath,
+                });
+                await s3Client.send(command);
+            },
+            async getPublicUrl(filePath) {
+                const command = new GetObjectCommand({
+                    Bucket: bucketName,
+                    Key: filePath,
+                });
+                const expiration = 3600; // 1 hour
+                return getSignedUrl(s3Client, command, { expiresIn: expiration });
+            },
+        };
+        console.info(`Loaded S3 Storage Config for: ${service}`);
+    }
+    getProvider(service) {
+        const provider = this.providers[service];
+        if (!provider) {
+            throw new Error(`Storage provider '${service}' not found`);
+        }
+        return provider;
+    }
+    async saveFile(service, filePath, fileContent) {
+        const provider = this.getProvider(service);
+        return provider.saveFile(filePath, fileContent);
+    }
+    async getFile(service, filePath) {
+        const provider = this.getProvider(service);
+        return provider.getFile(filePath);
+    }
+    async deleteFile(service, filePath) {
+        const provider = this.getProvider(service);
+        return provider.deleteFile(filePath);
+    }
+    async getPublicUrl(service, filePath) {
+        const provider = this.getProvider(service);
+        const result = provider.getPublicUrl(filePath);
+        return result instanceof Promise ? await result : result;
+    }
+}
+// Create singleton instance only if it doesn't exist
+if (!globalThis.__baasix_storageService) {
+    globalThis.__baasix_storageService = new StorageService();
+}
+const storageService = globalThis.__baasix_storageService;
+export default storageService;
+//# sourceMappingURL=StorageService.js.map

package/dist/services/StorageService.js.map

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

package/dist/services/TasksService.d.ts

@@ -0,0 +1,74 @@
+import type { Task } from '../types/index.js';
+declare class TasksService {
+    private cache;
+    private cacheKey;
+    private taskRunningKey;
+    private refreshInterval;
+    private refreshIntervalId;
+    private initialized;
+    private redisClient;
+    private useTaskRedis;
+    private instanceId;
+    private lockRenewalInterval;
+    private static readonly LOCK_TTL_SECONDS;
+    private static readonly LOCK_RENEWAL_INTERVAL;
+    init(): Promise<void>;
+    ensureInitialized(): Promise<void>;
+    refreshCache(): Promise<void>;
+    getNotStartedTasks(): Promise<Task[]>;
+    setTaskRunning(isRunning: boolean): Promise<void>;
+    isTaskRunning(): Promise<boolean>;
+    /**
+     * Try to acquire a distributed lock for task processing
+     * This ensures only one instance processes tasks at a time
+     *
+     * In multi-instance mode (TASK_REDIS_ENABLED=true):
+     *   Uses Redis SETNX for atomic lock acquisition
+     *
+     * In single-instance mode:
+     *   Falls back to cache-based locking
+     *
+     * @param lockTimeout - Lock expiration time in seconds (default: 60 seconds)
+     * @returns True if lock acquired, false otherwise
+     */
+    tryAcquireLock(lockTimeout?: number): Promise<boolean>;
+    /**
+     * Start automatic lock renewal to prevent expiry during long-running tasks
+     */
+    private startLockRenewal;
+    /**
+     * Stop lock renewal interval
+     */
+    private stopLockRenewal;
+    /**
+     * Release the distributed lock
+     * Only releases if the current instance owns the lock
+     * @returns True if lock released, false otherwise
+     */
+    releaseLock(): Promise<boolean>;
+    startPeriodicRefresh(): void;
+    stopPeriodicRefresh(): void;
+    registerHooks(): void;
+    /**
+     * Wait for any running task to complete (with timeout)
+     */
+    waitForTaskCompletion(timeoutMs?: number): Promise<void>;
+    /**
+     * Cleanup method for graceful shutdown
+     */
+    shutdown(timeoutMs?: number): Promise<void>;
+    /**
+     * Method to manually trigger cache refresh (useful for testing or manual operations)
+     */
+    forceRefresh(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): Promise<Record<string, any>>;
+}
+declare global {
+    var __baasix_tasksService: TasksService | undefined;
+}
+declare const tasksService: TasksService;
+export default tasksService;
+//# sourceMappingURL=TasksService.d.ts.map

package/dist/services/TasksService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TasksService.d.ts","sourceRoot":"","sources":["../../baasix/services/TasksService.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAI9C,cAAM,YAAY;IAChB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,WAAW,CAAkB;IAGrC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAM;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAEhD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDrB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B7B,kBAAkB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAuBrC,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBvC;;;;;;;;;;;;OAYG;IACG,cAAc,CAAC,WAAW,GAAE,MAAsC,GAAG,OAAO,CAAC,OAAO,CAAC;IA+C3F;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA4CrC,oBAAoB,IAAI,IAAI;IAc5B,mBAAmB,IAAI,IAAI;IAQ3B,aAAa,IAAI,IAAI;IAuBrB;;OAEG;IACG,qBAAqB,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBrE;;OAEG;IACG,QAAQ,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CA0CpD;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,qBAAqB,EAAE,YAAY,GAAG,SAAS,CAAC;CACrD;AAOD,QAAA,MAAM,YAAY,cAAmC,CAAC;AAEtD,eAAe,YAAY,CAAC"}