node-server-engine 1.8.0 → 1.9.0

package/dist/entities/AWSS3/AWSS3.types.d.ts

@@ -0,0 +1,78 @@
+import { Readable } from 'stream';
+/** AWS S3 initialization configuration */
+export interface AWSS3Config {
+    /** AWS Region (e.g., 'us-east-1') */
+    region?: string;
+    /** AWS Access Key ID */
+    accessKeyId?: string;
+    /** AWS Secret Access Key */
+    secretAccessKey?: string;
+    /** AWS Session Token (for temporary credentials) */
+    sessionToken?: string;
+    /** Custom endpoint (useful for S3-compatible services like MinIO, LocalStack) */
+    endpoint?: string;
+    /** Force path style (required for some S3-compatible services) */
+    forcePathStyle?: boolean;
+}
+/** Options to set where an uploaded file is stored in the S3 bucket */
+export interface S3UploadDestinationOptions {
+    /** Directory of the bucket in which the file is stored. Defaults to the root directory */
+    directory?: string;
+    /** Name under which the file is stored. If specified, the file is stored with that name. Otherwise random name generation is done */
+    fileName?: string;
+    /** When using random file name generation (ie: fileName is undefined). We use the MIME type to determine which is the best extension to apply to the file */
+    mime?: string;
+    /** When using random file name generation (ie: fileName is undefined), use this parameter to skip adding an extension to the file */
+    noExtension?: boolean;
+}
+/** Options of the S3 file uploader */
+export interface S3UploaderOptions {
+    /** Maximum size of the file (ex: 2MB) */
+    maxSize?: string;
+}
+/** Object representing a file that has been uploaded to S3 */
+export interface S3UploadedFile {
+    /** Bucket in which the file has been uploaded */
+    Bucket: string;
+    /** Key (path) of the stored object */
+    Key: string;
+    /** ETag of the uploaded file */
+    ETag?: string;
+    /** Location URL of the uploaded file */
+    Location?: string;
+    /** Server-side encryption method */
+    ServerSideEncryption?: string;
+    /** Version ID (if versioning is enabled) */
+    VersionId?: string;
+}
+/** Return type for a file download */
+export interface S3GetResponse {
+    /** The file raw binary content */
+    data: Buffer;
+    /** The file's metadata */
+    metadata: S3FileMetadata;
+}
+/** Return type for a file streaming fetching */
+export interface S3DownloadResponse {
+    /** A readable stream with the file's content */
+    stream: Readable;
+    /** The file's metadata */
+    metadata: S3FileMetadata;
+}
+/** S3 file metadata */
+export interface S3FileMetadata {
+    /** Content type of the file */
+    ContentType?: string;
+    /** Content length in bytes */
+    ContentLength?: number;
+    /** Last modified date */
+    LastModified?: Date;
+    /** ETag */
+    ETag?: string;
+    /** Metadata key-value pairs */
+    Metadata?: Record<string, string>;
+    /** Server-side encryption */
+    ServerSideEncryption?: string;
+    /** Version ID */
+    VersionId?: string;
+}

package/dist/entities/AWSS3/AWSS3.types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=AWSS3.types.js.map

package/dist/entities/AWSS3/AWSS3.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AWSS3.types.js","names":[],"sources":["../../../src/entities/AWSS3/AWSS3.types.ts"],"sourcesContent":["import { Readable } from 'stream';\n\n/** AWS S3 initialization configuration */\nexport interface AWSS3Config {\n  /** AWS Region (e.g., 'us-east-1') */\n  region?: string;\n  /** AWS Access Key ID */\n  accessKeyId?: string;\n  /** AWS Secret Access Key */\n  secretAccessKey?: string;\n  /** AWS Session Token (for temporary credentials) */\n  sessionToken?: string;\n  /** Custom endpoint (useful for S3-compatible services like MinIO, LocalStack) */\n  endpoint?: string;\n  /** Force path style (required for some S3-compatible services) */\n  forcePathStyle?: boolean;\n}\n\n/** Options to set where an uploaded file is stored in the S3 bucket */\nexport interface S3UploadDestinationOptions {\n  /** Directory of the bucket in which the file is stored. Defaults to the root directory */\n  directory?: string;\n  /** Name under which the file is stored. If specified, the file is stored with that name. Otherwise random name generation is done */\n  fileName?: string;\n  /** When using random file name generation (ie: fileName is undefined). We use the MIME type to determine which is the best extension to apply to the file */\n  mime?: string;\n  /** When using random file name generation (ie: fileName is undefined), use this parameter to skip adding an extension to the file */\n  noExtension?: boolean;\n}\n\n/** Options of the S3 file uploader */\nexport interface S3UploaderOptions {\n  /** Maximum size of the file (ex: 2MB) */\n  maxSize?: string;\n}\n\n/** Object representing a file that has been uploaded to S3 */\nexport interface S3UploadedFile {\n  /** Bucket in which the file has been uploaded */\n  Bucket: string;\n  /** Key (path) of the stored object */\n  Key: string;\n  /** ETag of the uploaded file */\n  ETag?: string;\n  /** Location URL of the uploaded file */\n  Location?: string;\n  /** Server-side encryption method */\n  ServerSideEncryption?: string;\n  /** Version ID (if versioning is enabled) */\n  VersionId?: string;\n}\n\n/** Return type for a file download */\nexport interface S3GetResponse {\n  /** The file raw binary content */\n  data: Buffer;\n  /** The file's metadata */\n  metadata: S3FileMetadata;\n}\n\n/** Return type for a file streaming fetching */\nexport interface S3DownloadResponse {\n  /** A readable stream with the file's content */\n  stream: Readable;\n  /** The file's metadata */\n  metadata: S3FileMetadata;\n}\n\n/** S3 file metadata */\nexport interface S3FileMetadata {\n  /** Content type of the file */\n  ContentType?: string;\n  /** Content length in bytes */\n  ContentLength?: number;\n  /** Last modified date */\n  LastModified?: Date;\n  /** ETag */\n  ETag?: string;\n  /** Metadata key-value pairs */\n  Metadata?: Record<string, string>;\n  /** Server-side encryption */\n  ServerSideEncryption?: string;\n  /** Version ID */\n  VersionId?: string;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/entities/AWSS3/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AWSS3';
+export * from './AWSS3.types';

package/dist/entities/{Storage → AWSS3}/index.js

@@ -3,25 +3,25 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _Storage = require("./Storage");
-Object.keys(_Storage).forEach(function (key) {
+var _AWSS = require("./AWSS3");
+Object.keys(_AWSS).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _Storage[key]) return;
+  if (key in exports && exports[key] === _AWSS[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function () {
-      return _Storage[key];
+      return _AWSS[key];
     }
   });
 });
-var _Storage2 = require("./Storage.types");
-Object.keys(_Storage2).forEach(function (key) {
+var _AWSS2 = require("./AWSS3.types");
+Object.keys(_AWSS2).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _Storage2[key]) return;
+  if (key in exports && exports[key] === _AWSS2[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function () {
-      return _Storage2[key];
+      return _AWSS2[key];
     }
   });
 });

package/dist/entities/AWSS3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_AWSS","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_AWSS2"],"sources":["../../../src/entities/AWSS3/index.ts"],"sourcesContent":["export * from './AWSS3';\nexport * from './AWSS3.types';\n"],"mappings":";;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,KAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,KAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,KAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,MAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,MAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,MAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,MAAA,CAAAL,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/dist/entities/ElasticSearch/ElasticSearch.d.ts

@@ -1,8 +1,13 @@
+import { Client } from '@elastic/elasticsearch';
 export declare const ElasticSearch: {
     /**
      * Init function that should be called on server startup to establish the connection
      */
     init(): Promise<void>;
+    /**
+     * Get the ElasticSearch client (for advanced use cases)
+     */
+    getClient(): Client | undefined;
     /**
      * Migration function called during the init process
      * Manages the database structure

package/dist/entities/ElasticSearch/ElasticSearch.js

@@ -13,6 +13,8 @@ var _LifecycleController = require("../LifecycleController");
 var _utils = require("../../utils");
 var _checkEnvironment = require("../../utils/checkEnvironment");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+const namespace = 'engine:elasticsearch';
+
 /** Elastic search client */
 let client;
 const ElasticSearch = exports.ElasticSearch = {
@@ -27,77 +29,158 @@ const ElasticSearch = exports.ElasticSearch = {
       ELASTIC_SEARCH_MIGRATION_PATH: _utils.envAssert.isString()
     });
     if (!process.env.ELASTIC_SEARCH_HOST) throw new _EngineError.EngineError({
-      message: 'ElasticSearch Hosts not set in environment'
+      message: 'ElasticSearch Host not set in environment'
+    });
+    (0, _utils.reportDebug)({
+      namespace,
+      message: 'Initializing ElasticSearch client',
+      data: {
+        host: process.env.ELASTIC_SEARCH_HOST
+      }
     });
-    client = new _elasticsearch.Client({
+    const config = {
       node: process.env.ELASTIC_SEARCH_HOST,
       auth: {
         username: process.env.ELASTIC_SEARCH_USERNAME,
         password: process.env.ELASTIC_SEARCH_PASSWORD
-      }
-    });
+      },
+      maxRetries: 3,
+      requestTimeout: 30000,
+      sniffOnStart: false
+    };
+
+    // Add TLS configuration if TLS_CA is provided
+    if (process.env.TLS_CA) {
+      config.tls = {
+        ca: process.env.TLS_CA,
+        rejectUnauthorized: process.env.NODE_ENV === 'production'
+      };
+      (0, _utils.reportDebug)({
+        namespace,
+        message: 'TLS enabled for ElasticSearch connection'
+      });
+    }
+    client = new _elasticsearch.Client(config);
+
+    // Verify connection
+    try {
+      await client.ping();
+      (0, _utils.reportDebug)({
+        namespace,
+        message: 'ElasticSearch connection established'
+      });
+    } catch (error) {
+      throw new _EngineError.EngineError({
+        message: 'Failed to connect to ElasticSearch',
+        data: {
+          error: error.message
+        }
+      });
+    }
+
     // In test environment flush the database before running migrations
-    if (process.env.NODE_ENV === 'test') await client.indices.delete({
-      index: '*'
-    });
+    if (process.env.NODE_ENV === 'test') {
+      (0, _utils.reportDebug)({
+        namespace,
+        message: 'Test environment detected, flushing all indices'
+      });
+      await client.indices.delete({
+        index: '*'
+      });
+    }
     await this.migrate();
     _LifecycleController.LifecycleController.register(this);
+    (0, _utils.reportInfo)({
+      message: 'ElasticSearch initialized successfully'
+    });
+  },
+  /**
+   * Get the ElasticSearch client (for advanced use cases)
+   */
+  getClient() {
+    return client;
   },
   /**
    * Migration function called during the init process
    * Manages the database structure
    */
   async migrate() {
-    if (!client) throw new _EngineError.EngineError('ElasticSearch was not initialized');
+    if (!client) throw new _EngineError.EngineError({
+      message: 'ElasticSearch was not initialized'
+    });
+    (0, _utils.reportDebug)({
+      namespace,
+      message: 'Starting ElasticSearch migrations'
+    });
     const migrationPath = _path.default.resolve(process.env.ELASTIC_SEARCH_MIGRATION_PATH);
-    const files = (0, _fs.readdirSync)(`${migrationPath}`);
+    let files;
+    try {
+      files = (0, _fs.readdirSync)(migrationPath).filter(f => f.endsWith('.ts') || f.endsWith('.js'));
+    } catch (error) {
+      throw new _EngineError.EngineError({
+        message: 'Failed to read migration directory',
+        data: {
+          path: migrationPath,
+          error: error.message
+        }
+      });
+    }
     const indexExists = await client.indices.exists({
       index: 'migrations'
     });
     const ran = [];
     for (const file of files) {
       if (indexExists) {
-        const {
-          hits: {
-            total
-          }
-        } = await client.search({
+        const result = await client.search({
           index: 'migrations',
-          body: {
-            query: {
-              match: {
-                file
-              }
+          query: {
+            match: {
+              file
             }
           }
         });
-        let tot = 0;
-        if (typeof total === 'number') {
-          tot = total;
-        } else {
-          tot = total?.value ?? 0;
+        const total = typeof result.hits.total === 'number' ? result.hits.total : result.hits.total?.value ?? 0;
+        if (total > 0) {
+          (0, _utils.reportDebug)({
+            namespace,
+            message: `Skipping migration ${file} (already ran)`
+          });
+          continue;
         }
-        if (tot > 0) continue;
       }
+      (0, _utils.reportDebug)({
+        namespace,
+        message: `Running migration: ${file}`
+      });
       ran.push(file);
-      const migration = await (specifier => new Promise(r => r(specifier)).then(s => _interopRequireWildcard(require(s))))(`${migrationPath}/${file}`);
       try {
+        const migration = await (specifier => new Promise(r => r(specifier)).then(s => _interopRequireWildcard(require(s))))(`${migrationPath}/${file}`);
         await migration.migrate(client);
+        await client.index({
+          index: 'migrations',
+          id: file,
+          document: {
+            file,
+            ranAt: new Date().toISOString()
+          }
+        });
+        (0, _utils.reportDebug)({
+          namespace,
+          message: `Successfully ran migration: ${file}`
+        });
       } catch (error) {
-        (0, _utils.reportError)(error);
-        process.exit(1);
+        (0, _utils.reportError)(new _EngineError.EngineError({
+          message: `Migration failed: ${file}`,
+          data: {
+            error: error.message,
+            stack: error.stack
+          }
+        }));
+        throw error;
       }
-      await client.create({
-        index: 'migrations',
-        id: file,
-        body: {
-          file,
-          ranAt: new Date()
-        }
-      });
     }
     (0, _utils.reportInfo)({
-      message: `ElasticSearch: ran ${ran.length} migrations`,
+      message: `ElasticSearch: ran ${ran.length} migration(s)`,
       data: {
         files: ran
       }
@@ -107,7 +190,23 @@ const ElasticSearch = exports.ElasticSearch = {
    * Shutdown function that should be called on server stop to close the connection
    */
   async shutdown() {
-    if (client) await client.close();
+    if (client) {
+      try {
+        await client.close();
+        (0, _utils.reportDebug)({
+          namespace,
+          message: 'ElasticSearch client disconnected'
+        });
+      } catch (error) {
+        (0, _utils.reportError)(new _EngineError.EngineError({
+          message: 'Error during ElasticSearch shutdown',
+          data: {
+            error: error.message
+          }
+        }));
+      }
+      client = undefined;
+    }
   }
 };
 //# sourceMappingURL=ElasticSearch.js.map

package/dist/entities/ElasticSearch/ElasticSearch.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElasticSearch.js","names":["_fs","require","_path","_interopRequireDefault","_elasticsearch","_EngineError","_LifecycleController","_utils","_checkEnvironment","_interopRequireWildcard","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","client","ElasticSearch","exports","init","checkEnvironment","ELASTIC_SEARCH_HOST","envAssert","isString","ELASTIC_SEARCH_USERNAME","ELASTIC_SEARCH_PASSWORD","ELASTIC_SEARCH_MIGRATION_PATH","process","env","EngineError","message","Client","node","auth","username","password","NODE_ENV","indices","delete","index","migrate","LifecycleController","register","migrationPath","path","resolve","files","readdirSync","indexExists","exists","ran","file","hits","total","search","body","query","match","tot","value","push","migration","specifier","Promise","then","s","error","reportError","exit","create","id","ranAt","Date","reportInfo","length","data","shutdown","close"],"sources":["../../../src/entities/ElasticSearch/ElasticSearch.ts"],"sourcesContent":["import { readdirSync } from 'fs';\nimport path from 'path';\nimport { Client } from '@elastic/elasticsearch';\nimport { ElasticSearchMigration } from './ElasticSearch.types';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { envAssert, reportError, reportInfo } from 'utils';\nimport { checkEnvironment } from 'utils/checkEnvironment';\n\n/** Elastic search client */\nlet client: undefined | Client;\n\nexport const ElasticSearch = {\n  /**\n   * Init function that should be called on server startup to establish the connection\n   */\n  async init(): Promise<void> {\n    checkEnvironment({\n      ELASTIC_SEARCH_HOST: envAssert.isString(),\n      ELASTIC_SEARCH_USERNAME: envAssert.isString(),\n      ELASTIC_SEARCH_PASSWORD: envAssert.isString(),\n      ELASTIC_SEARCH_MIGRATION_PATH: envAssert.isString()\n    });\n\n    if (!process.env.ELASTIC_SEARCH_HOST)\n      throw new EngineError({\n        message: 'ElasticSearch Hosts not set in environment'\n      });\n\n    client = new Client({\n      node: process.env.ELASTIC_SEARCH_HOST,\n      auth: {\n        username: process.env.ELASTIC_SEARCH_USERNAME as string,\n        password: process.env.ELASTIC_SEARCH_PASSWORD as string\n      }\n    });\n    // In test environment flush the database before running migrations\n    if (process.env.NODE_ENV === 'test')\n      await client.indices.delete({ index: '*' });\n    await this.migrate();\n    LifecycleController.register(this);\n  },\n\n  /**\n   * Migration function called during the init process\n   * Manages the database structure\n   */\n  async migrate(): Promise<void> {\n    if (!client) throw new EngineError('ElasticSearch was not initialized');\n    const migrationPath = path.resolve(\n      process.env.ELASTIC_SEARCH_MIGRATION_PATH as string\n    );\n    const files = readdirSync(`${migrationPath}`);\n    const indexExists = await client.indices.exists({\n      index: 'migrations'\n    });\n    const ran = [];\n    for (const file of files) {\n      if (indexExists) {\n        const {\n          hits: { total }\n        } = await client.search({\n          index: 'migrations',\n          body: { query: { match: { file } } }\n        });\n        let tot = 0;\n        if (typeof total === 'number') {\n          tot = total;\n        } else {\n          tot = total?.value ?? 0;\n        }\n        if (tot > 0) continue;\n      }\n      ran.push(file);\n      const migration = (await import(\n        `${migrationPath}/${file}`\n      )) as ElasticSearchMigration;\n      try {\n        await migration.migrate(client);\n      } catch (error) {\n        reportError(error);\n        process.exit(1);\n      }\n\n      await client.create({\n        index: 'migrations',\n        id: file,\n        body: { file, ranAt: new Date() }\n      });\n    }\n    reportInfo({\n      message: `ElasticSearch: ran ${ran.length} migrations`,\n      data: { files: ran }\n    });\n  },\n\n  /**\n   * Shutdown function that should be called on server stop to close the connection\n   */\n  async shutdown(): Promise<void> {\n    if (client) await client.close();\n  }\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ElasticSearch.js","names":["_fs","require","_path","_interopRequireDefault","_elasticsearch","_EngineError","_LifecycleController","_utils","_checkEnvironment","_interopRequireWildcard","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","namespace","client","ElasticSearch","exports","init","checkEnvironment","ELASTIC_SEARCH_HOST","envAssert","isString","ELASTIC_SEARCH_USERNAME","ELASTIC_SEARCH_PASSWORD","ELASTIC_SEARCH_MIGRATION_PATH","process","env","EngineError","message","reportDebug","data","host","config","node","auth","username","password","maxRetries","requestTimeout","sniffOnStart","TLS_CA","tls","ca","rejectUnauthorized","NODE_ENV","Client","ping","error","indices","delete","index","migrate","LifecycleController","register","reportInfo","getClient","migrationPath","path","resolve","files","readdirSync","filter","endsWith","indexExists","exists","ran","file","result","search","query","match","total","hits","value","push","migration","specifier","Promise","then","s","id","document","ranAt","Date","toISOString","reportError","stack","length","shutdown","close","undefined"],"sources":["../../../src/entities/ElasticSearch/ElasticSearch.ts"],"sourcesContent":["import { readdirSync } from 'fs';\nimport path from 'path';\nimport { Client } from '@elastic/elasticsearch';\nimport { ElasticSearchMigration } from './ElasticSearch.types';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { envAssert, reportError, reportInfo, reportDebug } from 'utils';\nimport { checkEnvironment } from 'utils/checkEnvironment';\n\nconst namespace = 'engine:elasticsearch';\n\n/** Elastic search client */\nlet client: undefined | Client;\n\nexport const ElasticSearch = {\n  /**\n   * Init function that should be called on server startup to establish the connection\n   */\n  async init(): Promise<void> {\n    checkEnvironment({\n      ELASTIC_SEARCH_HOST: envAssert.isString(),\n      ELASTIC_SEARCH_USERNAME: envAssert.isString(),\n      ELASTIC_SEARCH_PASSWORD: envAssert.isString(),\n      ELASTIC_SEARCH_MIGRATION_PATH: envAssert.isString()\n    });\n\n    if (!process.env.ELASTIC_SEARCH_HOST)\n      throw new EngineError({\n        message: 'ElasticSearch Host not set in environment'\n      });\n\n    reportDebug({\n      namespace,\n      message: 'Initializing ElasticSearch client',\n      data: { host: process.env.ELASTIC_SEARCH_HOST }\n    });\n\n    const config: any = {\n      node: process.env.ELASTIC_SEARCH_HOST,\n      auth: {\n        username: process.env.ELASTIC_SEARCH_USERNAME as string,\n        password: process.env.ELASTIC_SEARCH_PASSWORD as string\n      },\n      maxRetries: 3,\n      requestTimeout: 30000,\n      sniffOnStart: false\n    };\n\n    // Add TLS configuration if TLS_CA is provided\n    if (process.env.TLS_CA) {\n      config.tls = {\n        ca: process.env.TLS_CA,\n        rejectUnauthorized: process.env.NODE_ENV === 'production'\n      };\n      reportDebug({\n        namespace,\n        message: 'TLS enabled for ElasticSearch connection'\n      });\n    }\n\n    client = new Client(config);\n\n    // Verify connection\n    try {\n      await client.ping();\n      reportDebug({\n        namespace,\n        message: 'ElasticSearch connection established'\n      });\n    } catch (error) {\n      throw new EngineError({\n        message: 'Failed to connect to ElasticSearch',\n        data: { error: (error as Error).message }\n      });\n    }\n\n    // In test environment flush the database before running migrations\n    if (process.env.NODE_ENV === 'test') {\n      reportDebug({\n        namespace,\n        message: 'Test environment detected, flushing all indices'\n      });\n      await client.indices.delete({ index: '*' });\n    }\n\n    await this.migrate();\n    LifecycleController.register(this);\n\n    reportInfo({ message: 'ElasticSearch initialized successfully' });\n  },\n\n  /**\n   * Get the ElasticSearch client (for advanced use cases)\n   */\n  getClient(): Client | undefined {\n    return client;\n  },\n\n  /**\n   * Migration function called during the init process\n   * Manages the database structure\n   */\n  async migrate(): Promise<void> {\n    if (!client) throw new EngineError({ message: 'ElasticSearch was not initialized' });\n\n    reportDebug({\n      namespace,\n      message: 'Starting ElasticSearch migrations'\n    });\n\n    const migrationPath = path.resolve(\n      process.env.ELASTIC_SEARCH_MIGRATION_PATH as string\n    );\n\n    let files: string[];\n    try {\n      files = readdirSync(migrationPath).filter(\n        f => f.endsWith('.ts') || f.endsWith('.js')\n      );\n    } catch (error) {\n      throw new EngineError({\n        message: 'Failed to read migration directory',\n        data: { path: migrationPath, error: (error as Error).message }\n      });\n    }\n\n    const indexExists = await client.indices.exists({\n      index: 'migrations'\n    });\n\n    const ran: string[] = [];\n\n    for (const file of files) {\n      if (indexExists) {\n        const result = await client.search({\n          index: 'migrations',\n          query: { match: { file } }\n        });\n\n        const total = typeof result.hits.total === 'number'\n          ? result.hits.total\n          : result.hits.total?.value ?? 0;\n\n        if (total > 0) {\n          reportDebug({\n            namespace,\n            message: `Skipping migration ${file} (already ran)`\n          });\n          continue;\n        }\n      }\n\n      reportDebug({\n        namespace,\n        message: `Running migration: ${file}`\n      });\n\n      ran.push(file);\n\n      try {\n        const migration = (await import(\n          `${migrationPath}/${file}`\n        )) as ElasticSearchMigration;\n\n        await migration.migrate(client);\n\n        await client.index({\n          index: 'migrations',\n          id: file,\n          document: { file, ranAt: new Date().toISOString() }\n        });\n\n        reportDebug({\n          namespace,\n          message: `Successfully ran migration: ${file}`\n        });\n      } catch (error) {\n        reportError(\n          new EngineError({\n            message: `Migration failed: ${file}`,\n            data: { error: (error as Error).message, stack: (error as Error).stack }\n          })\n        );\n        throw error;\n      }\n    }\n\n    reportInfo({\n      message: `ElasticSearch: ran ${ran.length} migration(s)`,\n      data: { files: ran }\n    });\n  },\n\n  /**\n   * Shutdown function that should be called on server stop to close the connection\n   */\n  async shutdown(): Promise<void> {\n    if (client) {\n      try {\n        await client.close();\n        reportDebug({\n          namespace,\n          message: 'ElasticSearch client disconnected'\n        });\n      } catch (error) {\n        reportError(\n          new EngineError({\n            message: 'Error during ElasticSearch shutdown',\n            data: { error: (error as Error).message }\n          })\n        );\n      }\n      client = undefined;\n    }\n  }\n};\n"],"mappings":"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","ignoreList":[]}

package/dist/entities/GoogleCloudStorage/GoogleCloudStorage.d.ts

@@ -0,0 +1,141 @@
+import { Readable } from 'stream';
+import { Storage as CloudStorage, CreateWriteStreamOptions } from '@google-cloud/storage';
+import { UploadDestinationOptions, StorageUploadedFile, UploaderOptions, StorageGetResponse, StorageDownloadResponse, GoogleCloudStorageConfig } from './GoogleCloudStorage.types';
+/**
+ * Generic Google Cloud Storage wrapper for easy file operations
+ * Provides methods for uploading, downloading, streaming, and deleting files
+ *
+ * @example
+ * ```typescript
+ * // Initialize with custom configuration
+ * GoogleCloudStorage.init({
+ *   projectId: 'my-project',
+ *   keyFilename: '/path/to/keyfile.json'
+ * });
+ *
+ * // Upload a file
+ * const result = await GoogleCloudStorage.upload(
+ *   fileStream,
+ *   'my-bucket',
+ *   { directory: 'uploads', mime: 'image/png' }
+ * );
+ *
+ * // Download a file
+ * const { data, metadata } = await GoogleCloudStorage.get('my-bucket', 'uploads/file.png');
+ *
+ * // Delete a file
+ * await GoogleCloudStorage.delete('my-bucket', 'uploads/file.png');
+ * ```
+ */
+export declare const GoogleCloudStorage: {
+    cloudStorage: CloudStorage | null;
+    /**
+     * Initialize Google Cloud Storage with configuration
+     * Call this method before using any other methods
+     * @param config - Google Cloud Storage configuration options
+     */
+    init(config?: GoogleCloudStorageConfig): void;
+    /**
+     * Get the Cloud Storage instance (auto-initializes if needed)
+     * @private
+     */
+    getStorageInstance(): CloudStorage;
+    /**
+     * Upload a file to Google Cloud Storage
+     * @param readStream - Readable stream of the file content
+     * @param bucket - Bucket name where the file should be stored
+     * @param destinationOptions - Options for file destination (directory, fileName, etc.)
+     * @param storageOptions - Google Cloud Storage write stream options
+     * @param uploaderOptions - Additional options like maxSize
+     * @returns Promise with file metadata
+     *
+     * @example
+     * ```typescript
+     * const fileStream = fs.createReadStream('photo.jpg');
+     * const result = await GoogleCloudStorage.upload(
+     *   fileStream,
+     *   'my-bucket',
+     *   { directory: 'photos', mime: 'image/jpeg' },
+     *   { metadata: { contentType: 'image/jpeg' } },
+     *   { maxSize: '5MB' }
+     * );
+     * console.log(result.name); // photos/uuid.jpeg
+     * ```
+     */
+    upload(readStream: Readable, bucket: string, destinationOptions?: UploadDestinationOptions, storageOptions?: CreateWriteStreamOptions, uploaderOptions?: UploaderOptions): Promise<StorageUploadedFile>;
+    /**
+     * Download a file from Google Cloud Storage and return its content as Buffer
+     * @param bucket - Bucket name
+     * @param path - File path in the bucket
+     * @returns Promise with file data and metadata
+     *
+     * @example
+     * ```typescript
+     * const { data, metadata } = await GoogleCloudStorage.get('my-bucket', 'photos/image.jpg');
+     * console.log(metadata.size); // File size in bytes
+     * console.log(data); // Buffer with file content
+     * ```
+     */
+    get(bucket: string, path: string): Promise<StorageGetResponse>;
+    /**
+     * Get a readable stream for a file from Google Cloud Storage
+     * Use this for large files or when you need to stream the content
+     * @param bucket - Bucket name
+     * @param path - File path in the bucket
+     * @returns Promise with readable stream and metadata
+     *
+     * @example
+     * ```typescript
+     * const { stream, metadata } = await GoogleCloudStorage.download('my-bucket', 'videos/video.mp4');
+     * stream.pipe(res); // Stream to HTTP response
+     * ```
+     */
+    download(bucket: string, path: string): Promise<StorageDownloadResponse>;
+    /**
+     * Get a readable stream for a file (without fetching metadata)
+     * Use this when you don't need metadata and want faster streaming
+     * @param bucket - Bucket name
+     * @param path - File path in the bucket
+     * @returns Readable stream
+     *
+     * @example
+     * ```typescript
+     * const stream = GoogleCloudStorage.getFileStream('my-bucket', 'audio/song.mp3');
+     * stream.pipe(res); // Direct streaming without metadata fetch
+     * ```
+     */
+    getFileStream(bucket: string, path: string): Readable;
+    /**
+     * Delete a file from Google Cloud Storage
+     * @param bucket - Bucket name
+     * @param path - File path in the bucket
+     * @returns Promise that resolves when deletion is complete
+     *
+     * @example
+     * ```typescript
+     * await GoogleCloudStorage.delete('my-bucket', 'temp/old-file.txt');
+     * ```
+     */
+    delete(bucket: string, path: string): Promise<void>;
+    /**
+     * Generate a random file path with optional directory and extension
+     * Useful for creating unique file names
+     * @param options - Options for file destination generation
+     * @returns Generated file path
+     *
+     * @example
+     * ```typescript
+     * // Generate UUID only
+     * const path1 = GoogleCloudStorage.generateFileDestination();
+     * // 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
+     *
+     * // With directory and MIME type
+     * const path2 = GoogleCloudStorage.generateFileDestination({
+     *   directory: 'uploads/images',
+     *   mime: 'image/jpeg'
+     * });
+     * // 'uploads/images/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpeg'
+     * ```
+     */
+    generateFileDestination(options?: UploadDestinationOptions): string;
+};