fiberx-backend-toolkit 0.1.12 → 0.1.14

package/dist/config/constants.d.ts

@@ -83,6 +83,13 @@ export declare const FILE_UPLOAD_ENV_KEYS: {
     IMAGE_MIME_TYPES: string;
     VIDEO_MIME_TYPES: string;
     DOCUMENT_MIME_TYPES: string;
+    LOCAL_STORAGE_BASE_DIR: string;
+    LOCAL_STORAGE_PUBLIC_URL: string;
+    GCS_PROJECT_ID: string;
+    GCS_BUCKET_NAME: string;
+    GCS_CLIENT_EMAIL: string;
+    GCS_PRIVATE_KEY: string;
+    STORAGE_DRIVER_NAME: string;
 };
 export declare const FILE_UPLOAD_ALLOWED_MIME_TYPES: {
     image: string[];

package/dist/config/constants.js

@@ -133,7 +133,14 @@ exports.FILE_UPLOAD_ENV_KEYS = {
     DOCUMENT_MAX_SIZE: "FILE_UPLOAD_DOCUMENT_MAX_SIZE",
     IMAGE_MIME_TYPES: "FILE_UPLOAD_IMAGE_MIME_TYPES",
     VIDEO_MIME_TYPES: "FILE_UPLOAD_VIDEO_MIME_TYPES",
-    DOCUMENT_MIME_TYPES: "FILE_UPLOAD_DOCUMENT_MIME_TYPES"
+    DOCUMENT_MIME_TYPES: "FILE_UPLOAD_DOCUMENT_MIME_TYPES",
+    LOCAL_STORAGE_BASE_DIR: "FILE_UPLOAD_LOCAL_STORAGE_BASE_DIR",
+    LOCAL_STORAGE_PUBLIC_URL: "FILE_UPLOAD_LOCAL_STORAGE_PUBLIC_URL",
+    GCS_PROJECT_ID: "FILE_UPLOAD_GCS_PROJECT_ID",
+    GCS_BUCKET_NAME: "FILE_UPLOAD_GCS_BUCKET_NAME",
+    GCS_CLIENT_EMAIL: "FILE_UPLOAD_GCS_CLIENT_EMAIL",
+    GCS_PRIVATE_KEY: "FILE_UPLOAD_GCS_PRIVATE_KEY",
+    STORAGE_DRIVER_NAME: "FILE_UPLOAD_STORAGE_DRIVER_NAME"
 };
 exports.FILE_UPLOAD_ALLOWED_MIME_TYPES = {
     image: ["image/png", "image/jpeg", "image/webp"],

package/dist/storage/main.d.ts

@@ -2,4 +2,5 @@ import BaseStorageDriver from "./drivers/base_storage_driver";
 import GCSStorageDriver from "./drivers/gcs_storage_driver";
 import LocalStorageDriver from "./drivers/local_storage_driver";
 import FileUploadProcessor from "./processors/file_upload_processor";
-export { BaseStorageDriver, GCSStorageDriver, LocalStorageDriver, FileUploadProcessor, };
+import StorageDriverUtil from "./utils/storage_driver_util";
+export { BaseStorageDriver, GCSStorageDriver, LocalStorageDriver, FileUploadProcessor, StorageDriverUtil };

package/dist/storage/main.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileUploadProcessor = exports.LocalStorageDriver = exports.GCSStorageDriver = exports.BaseStorageDriver = void 0;
+exports.StorageDriverUtil = exports.FileUploadProcessor = exports.LocalStorageDriver = exports.GCSStorageDriver = exports.BaseStorageDriver = void 0;
 const base_storage_driver_1 = __importDefault(require("./drivers/base_storage_driver"));
 exports.BaseStorageDriver = base_storage_driver_1.default;
 const gcs_storage_driver_1 = __importDefault(require("./drivers/gcs_storage_driver"));
@@ -12,3 +12,5 @@ const local_storage_driver_1 = __importDefault(require("./drivers/local_storage_
 exports.LocalStorageDriver = local_storage_driver_1.default;
 const file_upload_processor_1 = __importDefault(require("./processors/file_upload_processor"));
 exports.FileUploadProcessor = file_upload_processor_1.default;
+const storage_driver_util_1 = __importDefault(require("./utils/storage_driver_util"));
+exports.StorageDriverUtil = storage_driver_util_1.default;

package/dist/storage/utils/storage_driver_util.d.ts

@@ -0,0 +1,27 @@
+import BaseStorageDriver from "../../storage/drivers/base_storage_driver";
+declare class StorageDriverUtil {
+    private static instance;
+    private static logger;
+    private static env_manager;
+    /**
+     * Get initialized storage driver (singleton)
+     */
+    static getDriver(): Promise<BaseStorageDriver>;
+    /**
+     * Resolve driver synchronously based on env
+     */
+    static getDriverSync(): BaseStorageDriver;
+    /**
+     * Initialize driver based on environment
+     */
+    private static initializeDriver;
+    /**
+     * Local driver (development)
+     */
+    private static initLocalDriver;
+    /**
+     * GCS driver (staging/production)
+     */
+    private static initGCSDriver;
+}
+export default StorageDriverUtil;

package/dist/storage/utils/storage_driver_util.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const main_1 = require("../../utils/main");
+const constants_1 = require("../../config/constants");
+const gcs_storage_driver_1 = __importDefault(require("../../storage/drivers/gcs_storage_driver"));
+const local_storage_driver_1 = __importDefault(require("../../storage/drivers/local_storage_driver"));
+class StorageDriverUtil {
+    static instance = null;
+    static logger = new main_1.LoggerUtil("storage_driver_util");
+    static env_manager = main_1.EnvManagerUtil.getInstance();
+    /**
+     * Get initialized storage driver (singleton)
+     */
+    static async getDriver() {
+        if (this.instance) {
+            return this.instance;
+        }
+        const driver = await this.initializeDriver();
+        this.instance = driver;
+        return driver;
+    }
+    /**
+     * Resolve driver synchronously based on env
+     */
+    static getDriverSync() {
+        if (this.instance) {
+            return this.instance;
+        }
+        throw new Error("Storage driver not initialized yet. Call getDriver() first to initialize.");
+    }
+    /**
+     * Initialize driver based on environment
+     */
+    static async initializeDriver() {
+        try {
+            if (main_1.InputValidatorUtil.isDevelopment()) {
+                return await StorageDriverUtil.initLocalDriver();
+            }
+            if (main_1.InputValidatorUtil.isLive()) {
+                const driver_type = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.STORAGE_DRIVER_NAME, "");
+                switch (driver_type?.toLowerCase()) {
+                    case "local": return StorageDriverUtil.initLocalDriver();
+                    case "gcs": return await StorageDriverUtil.initGCSDriver();
+                    default: throw new Error(`Unsupported storage driver type '${driver_type}' in live environment`);
+                }
+            }
+            throw new Error("Unsupported environment for storage driver");
+        }
+        catch (error) {
+            this.logger.error("Failed to initialize storage driver", { error });
+            throw error;
+        }
+    }
+    /**
+     * Local driver (development)
+     */
+    static async initLocalDriver() {
+        const base_dir = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.LOCAL_STORAGE_BASE_DIR, "");
+        const public_base_url = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.LOCAL_STORAGE_PUBLIC_URL, "");
+        if (!base_dir) {
+            throw new Error("LOCAL_STORAGE_BASE_DIR is required for local storage");
+        }
+        const config = {
+            type: "local",
+            base_dir,
+            public_base_url
+        };
+        const driver = new local_storage_driver_1.default();
+        await driver.initialize(config);
+        this.logger.info("Initialized Local Storage Driver");
+        return driver;
+    }
+    /**
+     * GCS driver (staging/production)
+     */
+    static async initGCSDriver() {
+        const project_id = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_PROJECT_ID, "");
+        const bucket_name = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_BUCKET_NAME, "");
+        ;
+        const client_email = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_CLIENT_EMAIL, "");
+        ;
+        const private_key = StorageDriverUtil.env_manager.getEnvVar(constants_1.FILE_UPLOAD_ENV_KEYS.GCS_PRIVATE_KEY, "");
+        ;
+        if (!project_id || !bucket_name || !client_email || !private_key) {
+            throw new Error("Missing required GCS environment variables");
+        }
+        const credentials = {
+            client_email,
+            private_key: private_key.replace(/\\n/g, "\n")
+        };
+        const config = {
+            type: "gcs",
+            project_id,
+            bucket_name,
+            credentials
+        };
+        const driver = new gcs_storage_driver_1.default();
+        await driver.initialize(config);
+        this.logger.info("Initialized GCS Storage Driver");
+        return driver;
+    }
+}
+exports.default = StorageDriverUtil;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fiberx-backend-toolkit",
-    "version": "0.1.12",
+    "version": "0.1.14",
     "description": "A TypeScript backend toolkit providing shared domain logic, infrastructure helpers, and utilities for FiberX server-side applications and services.",
     "type": "commonjs",
     "main": "./dist/index.js",