@cuencor/backend-storage 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { StorageModule } from './lib/storage.module';
+export { StorageService } from './lib/storage.service';
+export { STORAGE_PROVIDER, IStorageProvider, UploadResult } from './lib/storage.interface';
+export { S3StorageProvider, S3StorageOptions } from './lib/s3-storage.provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+// @cuencor/backend-storage — S3-compatible object storage for Cuencor Platform
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3StorageProvider = exports.STORAGE_PROVIDER = exports.StorageService = exports.StorageModule = void 0;
+var storage_module_1 = require("./lib/storage.module");
+Object.defineProperty(exports, "StorageModule", { enumerable: true, get: function () { return storage_module_1.StorageModule; } });
+var storage_service_1 = require("./lib/storage.service");
+Object.defineProperty(exports, "StorageService", { enumerable: true, get: function () { return storage_service_1.StorageService; } });
+var storage_interface_1 = require("./lib/storage.interface");
+Object.defineProperty(exports, "STORAGE_PROVIDER", { enumerable: true, get: function () { return storage_interface_1.STORAGE_PROVIDER; } });
+var s3_storage_provider_1 = require("./lib/s3-storage.provider");
+Object.defineProperty(exports, "S3StorageProvider", { enumerable: true, get: function () { return s3_storage_provider_1.S3StorageProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;;;AAE/E,uDAAqD;AAA5C,+GAAA,aAAa,OAAA;AACtB,yDAAuD;AAA9C,iHAAA,cAAc,OAAA;AACvB,6DAA2F;AAAlF,qHAAA,gBAAgB,OAAA;AACzB,iEAAgF;AAAvE,wHAAA,iBAAiB,OAAA"}

package/dist/lib/s3-storage.provider.d.ts

@@ -0,0 +1,24 @@
+import type { IStorageProvider, UploadResult } from './storage.interface';
+export interface S3StorageOptions {
+    /** S3-compatible endpoint URL (e.g. "https://eu2.contabostorage.com") */
+    endpoint: string;
+    /** AWS region — ignored by Contabo/MinIO but required by SDK */
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucket: string;
+    /** Base public URL for object links (e.g. "https://eu2.contabostorage.com/tenantId:bucket") */
+    publicBase: string;
+    /** Use path-style URLs (required for Contabo / MinIO) */
+    forcePathStyle?: boolean;
+}
+export declare class S3StorageProvider implements IStorageProvider {
+    private readonly opts;
+    private readonly client;
+    private readonly logger;
+    constructor(opts: S3StorageOptions);
+    uploadFile(buffer: Buffer, folder: string, contentType: string, extension: string): Promise<UploadResult>;
+    getFileBuffer(key: string): Promise<Buffer>;
+    deleteFile(key: string): Promise<void>;
+}
+//# sourceMappingURL=s3-storage.provider.d.ts.map

package/dist/lib/s3-storage.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-storage.provider.d.ts","sourceRoot":"","sources":["../../src/lib/s3-storage.provider.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,iBAAkB,YAAW,gBAAgB;IAI5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAEhC,IAAI,EAAE,gBAAgB;IAY7C,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IAmBlB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAS7C"}

package/dist/lib/s3-storage.provider.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3StorageProvider = void 0;
+const common_1 = require("@nestjs/common");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const crypto_1 = require("crypto");
+class S3StorageProvider {
+    opts;
+    client;
+    logger = new common_1.Logger(S3StorageProvider.name);
+    constructor(opts) {
+        this.opts = opts;
+        this.client = new client_s3_1.S3Client({
+            endpoint: opts.endpoint,
+            region: opts.region,
+            credentials: {
+                accessKeyId: opts.accessKeyId,
+                secretAccessKey: opts.secretAccessKey,
+            },
+            forcePathStyle: opts.forcePathStyle ?? true,
+        });
+    }
+    async uploadFile(buffer, folder, contentType, extension) {
+        const key = `${folder}/${(0, crypto_1.randomUUID)()}.${extension}`;
+        await this.client.send(new client_s3_1.PutObjectCommand({
+            Bucket: this.opts.bucket,
+            Key: key,
+            Body: buffer,
+            ContentType: contentType,
+            ContentDisposition: 'inline',
+            ACL: 'public-read',
+        }));
+        const url = `${this.opts.publicBase}/${key}`;
+        this.logger.debug(`Uploaded: ${url}`);
+        return { key, url };
+    }
+    async getFileBuffer(key) {
+        const response = await this.client.send(new client_s3_1.GetObjectCommand({ Bucket: this.opts.bucket, Key: key }));
+        const stream = response.Body;
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks);
+    }
+    async deleteFile(key) {
+        try {
+            await this.client.send(new client_s3_1.DeleteObjectCommand({ Bucket: this.opts.bucket, Key: key }));
+        }
+        catch (err) {
+            this.logger.warn(`Failed to delete object: ${key}`, err);
+        }
+    }
+}
+exports.S3StorageProvider = S3StorageProvider;
+//# sourceMappingURL=s3-storage.provider.js.map

package/dist/lib/s3-storage.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-storage.provider.js","sourceRoot":"","sources":["../../src/lib/s3-storage.provider.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,kDAK4B;AAC5B,mCAAoC;AAiBpC,MAAa,iBAAiB;IAIC;IAHZ,MAAM,CAAW;IACjB,MAAM,GAAG,IAAI,eAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE7D,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAQ,CAAC;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE;gBACX,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC;YACD,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,MAAc,EACd,WAAmB,EACnB,SAAiB;QAEjB,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,IAAA,mBAAU,GAAE,IAAI,SAAS,EAAE,CAAC;QAErD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,4BAAgB,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACxB,GAAG,EAAE,GAAG;YACR,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,WAAW;YACxB,kBAAkB,EAAE,QAAQ;YAC5B,GAAG,EAAE,aAAa;SACnB,CAAC,CACH,CAAC;QAEF,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,IAAI,4BAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC7D,CAAC;QACF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAA6B,CAAC;QACtD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAA8B,CAAC,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,+BAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAChE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF;AA7DD,8CA6DC"}

package/dist/lib/storage.interface.d.ts

@@ -0,0 +1,12 @@
+export declare const STORAGE_PROVIDER = "STORAGE_PROVIDER";
+export interface UploadResult {
+    key: string;
+    url: string;
+}
+/** Common interface for any object-storage backend (Contabo, MinIO, AWS S3, etc.) */
+export interface IStorageProvider {
+    uploadFile(buffer: Buffer, folder: string, contentType: string, extension: string): Promise<UploadResult>;
+    getFileBuffer(key: string): Promise<Buffer>;
+    deleteFile(key: string): Promise<void>;
+}
+//# sourceMappingURL=storage.interface.d.ts.map

package/dist/lib/storage.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.interface.d.ts","sourceRoot":"","sources":["../../src/lib/storage.interface.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/lib/storage.interface.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORAGE_PROVIDER = void 0;
+exports.STORAGE_PROVIDER = 'STORAGE_PROVIDER';
+//# sourceMappingURL=storage.interface.js.map

package/dist/lib/storage.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.interface.js","sourceRoot":"","sources":["../../src/lib/storage.interface.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG,kBAAkB,CAAC"}

package/dist/lib/storage.module.d.ts

@@ -0,0 +1,19 @@
+import { DynamicModule } from '@nestjs/common';
+import { S3StorageOptions } from './s3-storage.provider';
+export interface StorageModuleOptions {
+    /** Use 'contabo' for Contabo S3-compatible, or pass custom S3StorageOptions */
+    provider: 'contabo' | S3StorageOptions;
+}
+export declare class StorageModule {
+    /**
+     * Register StorageModule with a provider.
+     *
+     * @example Contabo (reads env vars automatically):
+     *   StorageModule.register({ provider: 'contabo' })
+     *
+     * @example Custom S3:
+     *   StorageModule.register({ provider: { endpoint, region, accessKeyId, ... } })
+     */
+    static register(options?: StorageModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=storage.module.d.ts.map

package/dist/lib/storage.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.module.d.ts","sourceRoot":"","sources":["../../src/lib/storage.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAIvD,OAAO,EAAqB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,QAAQ,EAAE,SAAS,GAAG,gBAAgB,CAAC;CACxC;AAED,qBACa,aAAa;IACxB;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,oBAA8C,GAAG,aAAa;CA6BxF"}

package/dist/lib/storage.module.js

@@ -0,0 +1,60 @@
+"use strict";
+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 StorageModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const storage_service_1 = require("./storage.service");
+const storage_interface_1 = require("./storage.interface");
+const s3_storage_provider_1 = require("./s3-storage.provider");
+let StorageModule = StorageModule_1 = class StorageModule {
+    /**
+     * Register StorageModule with a provider.
+     *
+     * @example Contabo (reads env vars automatically):
+     *   StorageModule.register({ provider: 'contabo' })
+     *
+     * @example Custom S3:
+     *   StorageModule.register({ provider: { endpoint, region, accessKeyId, ... } })
+     */
+    static register(options = { provider: 'contabo' }) {
+        return {
+            module: StorageModule_1,
+            providers: [
+                {
+                    provide: storage_interface_1.STORAGE_PROVIDER,
+                    inject: [config_1.ConfigService],
+                    useFactory: (config) => {
+                        if (options.provider === 'contabo') {
+                            const bucket = config.getOrThrow('CONTABO_BUCKET');
+                            const tenantId = config.getOrThrow('CONTABO_TENANT_ID');
+                            return new s3_storage_provider_1.S3StorageProvider({
+                                endpoint: 'https://eu2.contabostorage.com',
+                                region: 'us-east-1',
+                                accessKeyId: config.getOrThrow('CONTABO_ID'),
+                                secretAccessKey: config.getOrThrow('CONTABO_SECRET'),
+                                bucket,
+                                publicBase: `https://eu2.contabostorage.com/${tenantId}:${bucket}`,
+                                forcePathStyle: true,
+                            });
+                        }
+                        return new s3_storage_provider_1.S3StorageProvider(options.provider);
+                    },
+                },
+                storage_service_1.StorageService,
+            ],
+            exports: [storage_service_1.StorageService],
+        };
+    }
+};
+exports.StorageModule = StorageModule;
+exports.StorageModule = StorageModule = StorageModule_1 = __decorate([
+    (0, common_1.Module)({})
+], StorageModule);
+//# sourceMappingURL=storage.module.js.map

package/dist/lib/storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.module.js","sourceRoot":"","sources":["../../src/lib/storage.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,2CAA+C;AAC/C,uDAAmD;AACnD,2DAAuD;AACvD,+DAA4E;AAQrE,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAgC,EAAE,QAAQ,EAAE,SAAS,EAAE;QACrE,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,oCAAgB;oBACzB,MAAM,EAAE,CAAC,sBAAa,CAAC;oBACvB,UAAU,EAAE,CAAC,MAAqB,EAAqB,EAAE;wBACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;4BACnC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAS,gBAAgB,CAAC,CAAC;4BAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAS,mBAAmB,CAAC,CAAC;4BAChE,OAAO,IAAI,uCAAiB,CAAC;gCAC3B,QAAQ,EAAS,gCAAgC;gCACjD,MAAM,EAAW,WAAW;gCAC5B,WAAW,EAAM,MAAM,CAAC,UAAU,CAAS,YAAY,CAAC;gCACxD,eAAe,EAAE,MAAM,CAAC,UAAU,CAAS,gBAAgB,CAAC;gCAC5D,MAAM;gCACN,UAAU,EAAO,kCAAkC,QAAQ,IAAI,MAAM,EAAE;gCACvE,cAAc,EAAG,IAAI;6BACtB,CAAC,CAAC;wBACL,CAAC;wBACD,OAAO,IAAI,uCAAiB,CAAC,OAAO,CAAC,QAA4B,CAAC,CAAC;oBACrE,CAAC;iBACF;gBACD,gCAAc;aACf;YACD,OAAO,EAAE,CAAC,gCAAc,CAAC;SAC1B,CAAC;IACJ,CAAC;CACF,CAAA;AAvCY,sCAAa;wBAAb,aAAa;IADzB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,aAAa,CAuCzB"}

package/dist/lib/storage.service.d.ts

@@ -0,0 +1,13 @@
+import { IStorageProvider, UploadResult } from './storage.interface';
+/**
+ * StorageService — thin wrapper around any IStorageProvider.
+ * Inject this service in your feature modules; swap providers without changing business code.
+ */
+export declare class StorageService {
+    private readonly provider;
+    constructor(provider: IStorageProvider);
+    uploadFile(buffer: Buffer, folder: string, contentType: string, extension: string): Promise<UploadResult>;
+    getFileBuffer(key: string): Promise<Buffer>;
+    deleteFile(key: string): Promise<void>;
+}
+//# sourceMappingURL=storage.service.d.ts.map

package/dist/lib/storage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.service.d.ts","sourceRoot":"","sources":["../../src/lib/storage.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEvF;;;GAGG;AACH,qBACa,cAAc;IAEG,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAGvE,UAAU,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IAIxB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvC"}

package/dist/lib/storage.service.js

@@ -0,0 +1,43 @@
+"use strict";
+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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageService = void 0;
+const common_1 = require("@nestjs/common");
+const storage_interface_1 = require("./storage.interface");
+/**
+ * StorageService — thin wrapper around any IStorageProvider.
+ * Inject this service in your feature modules; swap providers without changing business code.
+ */
+let StorageService = class StorageService {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    uploadFile(buffer, folder, contentType, extension) {
+        return this.provider.uploadFile(buffer, folder, contentType, extension);
+    }
+    getFileBuffer(key) {
+        return this.provider.getFileBuffer(key);
+    }
+    deleteFile(key) {
+        return this.provider.deleteFile(key);
+    }
+};
+exports.StorageService = StorageService;
+exports.StorageService = StorageService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(storage_interface_1.STORAGE_PROVIDER)),
+    __metadata("design:paramtypes", [Object])
+], StorageService);
+//# sourceMappingURL=storage.service.js.map

package/dist/lib/storage.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.service.js","sourceRoot":"","sources":["../../src/lib/storage.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AACpD,2DAAuF;AAEvF;;;GAGG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;IAEoB;IAD7C,YAC6C,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IACpE,CAAC;IAEJ,UAAU,CACR,MAAc,EACd,MAAc,EACd,WAAmB,EACnB,SAAiB;QAEjB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1E,CAAC;IAED,aAAa,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;CACF,CAAA;AArBY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,oCAAgB,CAAC,CAAA;;GAFhB,cAAc,CAqB1B"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@cuencor/backend-storage",
+  "version": "0.0.1",
+  "description": "S3-compatible object storage provider for Cuencor Platform (Contabo, MinIO, AWS S3)",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --fix"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cuencor/backend-storage"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1004.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=11.0.0",
+    "@nestjs/config": ">=4.0.0",
+    "reflect-metadata": ">=0.2.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "11.0.7",
+    "@nestjs/config": "^4.0.0",
+    "@types/node": "^20.0.0",
+    "reflect-metadata": "0.2.2",
+    "typescript": "~5.7.2",
+    "eslint": "^9.20.0",
+    "typescript-eslint": "^8.19.0",
+    "eslint-plugin-security": "^3.0.1",
+    "eslint-plugin-sonarjs": "^3.0.7"
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+// @cuencor/backend-storage — S3-compatible object storage for Cuencor Platform
+
+export { StorageModule } from './lib/storage.module';
+export { StorageService } from './lib/storage.service';
+export { STORAGE_PROVIDER, IStorageProvider, UploadResult } from './lib/storage.interface';
+export { S3StorageProvider, S3StorageOptions } from './lib/s3-storage.provider';

package/src/lib/s3-storage.provider.ts

@@ -0,0 +1,86 @@
+import { Logger } from '@nestjs/common';
+import {
+  S3Client,
+  PutObjectCommand,
+  GetObjectCommand,
+  DeleteObjectCommand,
+} from '@aws-sdk/client-s3';
+import { randomUUID } from 'crypto';
+import type { IStorageProvider, UploadResult } from './storage.interface';
+
+export interface S3StorageOptions {
+  /** S3-compatible endpoint URL (e.g. "https://eu2.contabostorage.com") */
+  endpoint: string;
+  /** AWS region — ignored by Contabo/MinIO but required by SDK */
+  region: string;
+  accessKeyId: string;
+  secretAccessKey: string;
+  bucket: string;
+  /** Base public URL for object links (e.g. "https://eu2.contabostorage.com/tenantId:bucket") */
+  publicBase: string;
+  /** Use path-style URLs (required for Contabo / MinIO) */
+  forcePathStyle?: boolean;
+}
+
+export class S3StorageProvider implements IStorageProvider {
+  private readonly client: S3Client;
+  private readonly logger = new Logger(S3StorageProvider.name);
+
+  constructor(private readonly opts: S3StorageOptions) {
+    this.client = new S3Client({
+      endpoint: opts.endpoint,
+      region: opts.region,
+      credentials: {
+        accessKeyId: opts.accessKeyId,
+        secretAccessKey: opts.secretAccessKey,
+      },
+      forcePathStyle: opts.forcePathStyle ?? true,
+    });
+  }
+
+  async uploadFile(
+    buffer: Buffer,
+    folder: string,
+    contentType: string,
+    extension: string,
+  ): Promise<UploadResult> {
+    const key = `${folder}/${randomUUID()}.${extension}`;
+
+    await this.client.send(
+      new PutObjectCommand({
+        Bucket: this.opts.bucket,
+        Key: key,
+        Body: buffer,
+        ContentType: contentType,
+        ContentDisposition: 'inline',
+        ACL: 'public-read',
+      }),
+    );
+
+    const url = `${this.opts.publicBase}/${key}`;
+    this.logger.debug(`Uploaded: ${url}`);
+    return { key, url };
+  }
+
+  async getFileBuffer(key: string): Promise<Buffer> {
+    const response = await this.client.send(
+      new GetObjectCommand({ Bucket: this.opts.bucket, Key: key }),
+    );
+    const stream = response.Body as NodeJS.ReadableStream;
+    const chunks: Buffer[] = [];
+    for await (const chunk of stream) {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk as unknown as Uint8Array));
+    }
+    return Buffer.concat(chunks);
+  }
+
+  async deleteFile(key: string): Promise<void> {
+    try {
+      await this.client.send(
+        new DeleteObjectCommand({ Bucket: this.opts.bucket, Key: key }),
+      );
+    } catch (err) {
+      this.logger.warn(`Failed to delete object: ${key}`, err);
+    }
+  }
+}

package/src/lib/storage.interface.ts

@@ -0,0 +1,20 @@
+export const STORAGE_PROVIDER = 'STORAGE_PROVIDER';
+
+export interface UploadResult {
+  key: string;
+  url: string;
+}
+
+/** Common interface for any object-storage backend (Contabo, MinIO, AWS S3, etc.) */
+export interface IStorageProvider {
+  uploadFile(
+    buffer: Buffer,
+    folder: string,
+    contentType: string,
+    extension: string,
+  ): Promise<UploadResult>;
+
+  getFileBuffer(key: string): Promise<Buffer>;
+
+  deleteFile(key: string): Promise<void>;
+}

package/src/lib/storage.module.ts

@@ -0,0 +1,52 @@
+import { DynamicModule, Module } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { StorageService } from './storage.service';
+import { STORAGE_PROVIDER } from './storage.interface';
+import { S3StorageProvider, S3StorageOptions } from './s3-storage.provider';
+
+export interface StorageModuleOptions {
+  /** Use 'contabo' for Contabo S3-compatible, or pass custom S3StorageOptions */
+  provider: 'contabo' | S3StorageOptions;
+}
+
+@Module({})
+export class StorageModule {
+  /**
+   * Register StorageModule with a provider.
+   *
+   * @example Contabo (reads env vars automatically):
+   *   StorageModule.register({ provider: 'contabo' })
+   *
+   * @example Custom S3:
+   *   StorageModule.register({ provider: { endpoint, region, accessKeyId, ... } })
+   */
+  static register(options: StorageModuleOptions = { provider: 'contabo' }): DynamicModule {
+    return {
+      module: StorageModule,
+      providers: [
+        {
+          provide: STORAGE_PROVIDER,
+          inject: [ConfigService],
+          useFactory: (config: ConfigService): S3StorageProvider => {
+            if (options.provider === 'contabo') {
+              const bucket = config.getOrThrow<string>('CONTABO_BUCKET');
+              const tenantId = config.getOrThrow<string>('CONTABO_TENANT_ID');
+              return new S3StorageProvider({
+                endpoint:        'https://eu2.contabostorage.com',
+                region:          'us-east-1',
+                accessKeyId:     config.getOrThrow<string>('CONTABO_ID'),
+                secretAccessKey: config.getOrThrow<string>('CONTABO_SECRET'),
+                bucket,
+                publicBase:      `https://eu2.contabostorage.com/${tenantId}:${bucket}`,
+                forcePathStyle:  true,
+              });
+            }
+            return new S3StorageProvider(options.provider as S3StorageOptions);
+          },
+        },
+        StorageService,
+      ],
+      exports: [StorageService],
+    };
+  }
+}

package/src/lib/storage.service.ts

@@ -0,0 +1,30 @@
+import { Inject, Injectable } from '@nestjs/common';
+import { STORAGE_PROVIDER, IStorageProvider, UploadResult } from './storage.interface';
+
+/**
+ * StorageService — thin wrapper around any IStorageProvider.
+ * Inject this service in your feature modules; swap providers without changing business code.
+ */
+@Injectable()
+export class StorageService {
+  constructor(
+    @Inject(STORAGE_PROVIDER) private readonly provider: IStorageProvider,
+  ) {}
+
+  uploadFile(
+    buffer: Buffer,
+    folder: string,
+    contentType: string,
+    extension: string,
+  ): Promise<UploadResult> {
+    return this.provider.uploadFile(buffer, folder, contentType, extension);
+  }
+
+  getFileBuffer(key: string): Promise<Buffer> {
+    return this.provider.getFileBuffer(key);
+  }
+
+  deleteFile(key: string): Promise<void> {
+    return this.provider.deleteFile(key);
+  }
+}