@venturialstd/backblaze 0.0.1

package/README.md

@@ -0,0 +1,105 @@
+# @venturialstd/backblaze
+
+**Backblaze B2** client using the **S3-Compatible API** (no AWS SDK). Authentication via **AWS Signature Version 4** using the `aws4` library. Intended for use across multiple projects that need Backblaze storage.
+
+## Features
+
+- **Authentication**: AWS Sig v4 (Application Key = access key + secret).
+- **Buckets**: List Buckets (GET /), Create Bucket (PUT /bucket-name), Delete Bucket (DELETE /bucket-name), Head Bucket (HEAD /bucket-name).
+- **Objects**: Put Object, Get Object, Delete Object, List Objects V2, Head Object.
+- Credentials from **SettingsModule** or per-request via `BackblazeOptions` (includes `region`).
+- S3 XML responses parsed to JSON (ListBuckets, ListObjectsV2).
+
+## Requirements
+
+- Backblaze B2 Application Key (S3-compatible).
+- Configure in settings: `GLOBAL:BACKBLAZE:GENERAL:REGION`, `GLOBAL:BACKBLAZE:GENERAL:ACCESS_KEY_ID`, `GLOBAL:BACKBLAZE:GENERAL:SECRET_ACCESS_KEY`.
+
+## Installation
+
+```bash
+npm install @venturialstd/backblaze
+yarn add @venturialstd/backblaze
+```
+
+## Basic usage
+
+```ts
+import {
+  BackblazeModule,
+  BackblazeBucketService,
+  BackblazeObjectService,
+  BucketAcl,
+  ContentType,
+} from '@venturialstd/backblaze';
+
+@Module({
+  imports: [BackblazeModule],
+})
+export class AppModule {}
+
+@Injectable()
+export class MyService {
+  constructor(
+    private readonly bucketService: BackblazeBucketService,
+    private readonly objectService: BackblazeObjectService,
+  ) {}
+
+  async listBuckets() {
+    // Returns { buckets: Array<{ name, creationDate }>, owner? }
+    const { buckets } = await this.bucketService.listBuckets();
+    return buckets;
+  }
+
+  async createBucket(name: string) {
+    await this.bucketService.createBucket(name, { acl: BucketAcl.Private });
+  }
+
+  async upload(bucketName: string, key: string, body: Buffer) {
+    await this.objectService.putObject(bucketName, key, body, {
+      contentType: ContentType.ApplicationJson,
+    });
+  }
+
+  async download(bucketName: string, key: string) {
+    return this.objectService.getObject(bucketName, key);
+  }
+
+  async listObjects(bucketName: string, prefix?: string) {
+    // Returns { objects, isTruncated, keyCount, nextContinuationToken?, prefix? }
+    return this.objectService.listObjectsV2(bucketName, { prefix, maxKeys: 1000 });
+  }
+}
+```
+
+### Per-request options
+
+```ts
+await this.bucketService.listBuckets({
+  region: 'us-west-004',
+  credentials: { accessKeyId: '...', secretAccessKey: '...' },
+});
+```
+
+## S3-Compatible API (official documentation)
+
+- **List Buckets**: GET `https://s3.<region>.backblazeb2.com/`
+- **Create Bucket**: PUT `https://s3.<region>.backblazeb2.com/<bucket-name>` (optional: CreateBucketConfiguration XML body, header `x-amz-acl`: private | public-read)
+- **Delete Bucket**: DELETE `https://s3.<region>.backblazeb2.com/<bucket-name>`
+- **Head Bucket**: HEAD `https://s3.<region>.backblazeb2.com/<bucket-name>`
+- **Put Object**: PUT `https://s3.<region>.backblazeb2.com/<bucket>/<key>` (body = file)
+- **Get Object**: GET `https://s3.<region>.backblazeb2.com/<bucket>/<key>`
+- **Delete Object**: DELETE `https://s3.<region>.backblazeb2.com/<bucket>/<key>`
+- **List Objects V2**: GET `https://s3.<region>.backblazeb2.com/<bucket>?list-type=2&prefix=...&max-keys=...`
+- **Head Object**: HEAD `https://s3.<region>.backblazeb2.com/<bucket>/<key>`
+
+## Notes
+
+- The AWS SDK is not used; requests are signed with `aws4` and sent with `HttpService`.
+- Backblaze only supports "private" and "public-read" ACLs at bucket level.
+- **Developer-friendly API**: use `BucketAcl`, `ContentType`, and `BackblazeRegion` enums; options are typed (`CreateBucketOptions`, `PutObjectOptions`, etc.); `listBuckets()` and `listObjectsV2()` return normalized results (`ListBucketsResult`, `ListObjectsV2Result`). Use `listBucketsRaw()` and `listObjectsV2Raw()` when you need the raw S3 response.
+- Developed and maintained by Venturial.
+
+## License
+
+MIT

package/dist/backblaze.module.d.ts

@@ -0,0 +1,3 @@
+export declare class BackblazeModule {
+}
+//# sourceMappingURL=backblaze.module.d.ts.map

package/dist/backblaze.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.module.d.ts","sourceRoot":"","sources":["../src/backblaze.module.ts"],"names":[],"mappings":"AAQA,qBAKa,eAAe;CAAG"}

package/dist/backblaze.module.js

@@ -0,0 +1,26 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackblazeModule = void 0;
+const axios_1 = require("@nestjs/axios");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@venturialstd/core");
+const backblaze_client_1 = require("./client/backblaze.client");
+const backblaze_bucket_service_1 = require("./services/backblaze-bucket.service");
+const backblaze_object_service_1 = require("./services/backblaze-object.service");
+let BackblazeModule = class BackblazeModule {
+};
+exports.BackblazeModule = BackblazeModule;
+exports.BackblazeModule = BackblazeModule = __decorate([
+    (0, common_1.Module)({
+        imports: [axios_1.HttpModule, core_1.AppLoggerModule, core_1.SettingsModule],
+        providers: [backblaze_client_1.BackblazeClient, backblaze_bucket_service_1.BackblazeBucketService, backblaze_object_service_1.BackblazeObjectService],
+        exports: [backblaze_bucket_service_1.BackblazeBucketService, backblaze_object_service_1.BackblazeObjectService],
+    })
+], BackblazeModule);
+//# sourceMappingURL=backblaze.module.js.map

package/dist/backblaze.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.module.js","sourceRoot":"","sources":["../src/backblaze.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,yCAA2C;AAC3C,2CAAwC;AACxC,6CAAqE;AAErE,gEAA4D;AAC5D,kFAA6E;AAC7E,kFAA6E;AAOtE,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAL3B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,kBAAU,EAAE,sBAAe,EAAE,qBAAc,CAAC;QACtD,SAAS,EAAE,CAAC,kCAAe,EAAE,iDAAsB,EAAE,iDAAsB,CAAC;QAC5E,OAAO,EAAE,CAAC,iDAAsB,EAAE,iDAAsB,CAAC;KAC1D,CAAC;GACW,eAAe,CAAG"}

package/dist/client/backblaze.client.d.ts

@@ -0,0 +1,17 @@
+import { HttpService } from '@nestjs/axios';
+import { AppLogger, SettingsService } from '@venturialstd/core';
+import type { BackblazeRequestParams } from '../interfaces/backblaze-credentials.interface';
+export declare class BackblazeClient {
+    private readonly httpService;
+    private readonly logger;
+    private readonly settings;
+    constructor(httpService: HttpService, logger: AppLogger, settings: SettingsService);
+    request<T>(params: BackblazeRequestParams<T>): Promise<T>;
+    requestWithResponse(params: BackblazeRequestParams): Promise<{
+        data: unknown;
+        headers: Record<string, string>;
+        status: number;
+    }>;
+    private getConfig;
+}
+//# sourceMappingURL=backblaze.client.d.ts.map

package/dist/client/backblaze.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.client.d.ts","sourceRoot":"","sources":["../../src/client/backblaze.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMhE,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,+CAA+C,CAAC;AAGvD,qBACa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,eAAe;IAGtC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKzD,mBAAmB,CACvB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;YA+ChE,SAAS;CA8BxB"}

package/dist/client/backblaze.client.js

@@ -0,0 +1,133 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackblazeClient = void 0;
+const axios_1 = require("@nestjs/axios");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@venturialstd/core");
+const rxjs_1 = require("rxjs");
+const aws4 = __importStar(require("aws4"));
+const backblaze_constant_1 = require("../constants/backblaze.constant");
+const backblaze_settings_constants_1 = require("../constants/backblaze.settings.constants");
+const s3_xml_util_1 = require("../utils/s3-xml.util");
+let BackblazeClient = class BackblazeClient {
+    httpService;
+    logger;
+    settings;
+    constructor(httpService, logger, settings) {
+        this.httpService = httpService;
+        this.logger = logger;
+        this.settings = settings;
+    }
+    async request(params) {
+        const result = await this.requestWithResponse(params);
+        return result.data;
+    }
+    async requestWithResponse(params) {
+        const { options, method, path, body, headers = {}, responseType = 'json' } = params;
+        const { host, baseUrl, region, credentials } = await this.getConfig(options);
+        const pathNormalized = path.startsWith('/') ? path : `/${path}`;
+        const req = {
+            host,
+            path: pathNormalized || '/',
+            method,
+            service: 's3',
+            region,
+            headers: { ...headers },
+            body: body,
+        };
+        aws4.sign(req, credentials);
+        const url = `${baseUrl}${pathNormalized || '/'}`;
+        const axiosConfig = {
+            method: (req.method ?? method),
+            url,
+            headers: req.headers,
+            responseType: responseType === 'arraybuffer' ? 'arraybuffer' : responseType === 'text' ? 'text' : 'json',
+        };
+        if (body !== undefined) {
+            axiosConfig.data = typeof body === 'string' ? body : body;
+        }
+        try {
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.request(axiosConfig));
+            let data = response.data;
+            if (responseType === 'json' && typeof data === 'string' && data.trim().startsWith('<?xml')) {
+                data = (0, s3_xml_util_1.parseXmlToJson)(data);
+            }
+            this.logger?.log(`Backblaze S3 request OK: ${method} ${url}`);
+            return { data, headers: response.headers, status: response.status };
+        }
+        catch (err) {
+            this.logger.error(`Backblaze S3 request error: ${method} ${url} - ${err}`);
+            throw err;
+        }
+    }
+    async getConfig(options) {
+        const region = options?.region ??
+            (await this.settings.get(backblaze_settings_constants_1.BACKBLAZE_SETTING_KEYS.GENERAL_REGION)) ??
+            'us-west-004';
+        const accessKeyId = options?.credentials?.accessKeyId ??
+            (await this.settings.get(backblaze_settings_constants_1.BACKBLAZE_SETTING_KEYS.GENERAL_ACCESS_KEY_ID));
+        const secretAccessKey = options?.credentials?.secretAccessKey ??
+            (await this.settings.get(backblaze_settings_constants_1.BACKBLAZE_SETTING_KEYS.GENERAL_SECRET_ACCESS_KEY));
+        if (!accessKeyId || !secretAccessKey) {
+            throw new Error('Backblaze credentials not provided');
+        }
+        const baseUrl = backblaze_constant_1.BACKBLAZE_ENDPOINT_PATTERN.replace('{region}', region);
+        const host = baseUrl.replace(/^https?:\/\//, '').replace(/\/$/, '');
+        return {
+            host,
+            baseUrl: baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl,
+            region,
+            credentials: { accessKeyId, secretAccessKey },
+        };
+    }
+};
+exports.BackblazeClient = BackblazeClient;
+exports.BackblazeClient = BackblazeClient = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [axios_1.HttpService,
+        core_1.AppLogger,
+        core_1.SettingsService])
+], BackblazeClient);
+//# sourceMappingURL=backblaze.client.js.map

package/dist/client/backblaze.client.js.map

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

package/dist/constants/backblaze-client.constant.d.ts

@@ -0,0 +1,8 @@
+export declare enum BACKBLAZE_HTTP_METHOD {
+    GET = "GET",
+    PUT = "PUT",
+    POST = "POST",
+    DELETE = "DELETE",
+    HEAD = "HEAD"
+}
+//# sourceMappingURL=backblaze-client.constant.d.ts.map

package/dist/constants/backblaze-client.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-client.constant.d.ts","sourceRoot":"","sources":["../../src/constants/backblaze-client.constant.ts"],"names":[],"mappings":"AAAA,oBAAY,qBAAqB;IAC/B,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;CACd"}

package/dist/constants/backblaze-client.constant.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKBLAZE_HTTP_METHOD = void 0;
+var BACKBLAZE_HTTP_METHOD;
+(function (BACKBLAZE_HTTP_METHOD) {
+    BACKBLAZE_HTTP_METHOD["GET"] = "GET";
+    BACKBLAZE_HTTP_METHOD["PUT"] = "PUT";
+    BACKBLAZE_HTTP_METHOD["POST"] = "POST";
+    BACKBLAZE_HTTP_METHOD["DELETE"] = "DELETE";
+    BACKBLAZE_HTTP_METHOD["HEAD"] = "HEAD";
+})(BACKBLAZE_HTTP_METHOD || (exports.BACKBLAZE_HTTP_METHOD = BACKBLAZE_HTTP_METHOD = {}));
+//# sourceMappingURL=backblaze-client.constant.js.map

package/dist/constants/backblaze-client.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-client.constant.js","sourceRoot":"","sources":["../../src/constants/backblaze-client.constant.ts"],"names":[],"mappings":";;;AAAA,IAAY,qBAMX;AAND,WAAY,qBAAqB;IAC/B,oCAAW,CAAA;IACX,oCAAW,CAAA;IACX,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,sCAAa,CAAA;AACf,CAAC,EANW,qBAAqB,qCAArB,qBAAqB,QAMhC"}

package/dist/constants/backblaze.constant.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Endpoint base for Backblaze B2 S3-Compatible API.
+ * Format: https://s3.<region>.backblazeb2.com
+ */
+export declare const BACKBLAZE_ENDPOINT_PATTERN = "https://s3.{region}.backblazeb2.com";
+/**
+ * Backblaze-specific headers (e.g. Live Read for multipart).
+ */
+export declare const BACKBLAZE_HEADERS: {
+    readonly LIVE_READ_ENABLED: "x-backblaze-live-read-enabled";
+};
+/**
+ * Encryption for SSE-B2 (Backblaze-managed keys).
+ */
+export declare const BACKBLAZE_SSE_ALGORITHM: {
+    readonly AES256: "AES256";
+};
+/**
+ * Supported Object Lock modes.
+ */
+export declare const BACKBLAZE_OBJECT_LOCK_MODE: {
+    readonly GOVERNANCE: "GOVERNANCE";
+    readonly COMPLIANCE: "COMPLIANCE";
+};
+//# sourceMappingURL=backblaze.constant.d.ts.map

package/dist/constants/backblaze.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.constant.d.ts","sourceRoot":"","sources":["../../src/constants/backblaze.constant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,0BAA0B,wCAAwC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;CAEpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB;;CAE1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC"}

package/dist/constants/backblaze.constant.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKBLAZE_OBJECT_LOCK_MODE = exports.BACKBLAZE_SSE_ALGORITHM = exports.BACKBLAZE_HEADERS = exports.BACKBLAZE_ENDPOINT_PATTERN = void 0;
+/**
+ * Endpoint base for Backblaze B2 S3-Compatible API.
+ * Format: https://s3.<region>.backblazeb2.com
+ */
+exports.BACKBLAZE_ENDPOINT_PATTERN = 'https://s3.{region}.backblazeb2.com';
+/**
+ * Backblaze-specific headers (e.g. Live Read for multipart).
+ */
+exports.BACKBLAZE_HEADERS = {
+    LIVE_READ_ENABLED: 'x-backblaze-live-read-enabled',
+};
+/**
+ * Encryption for SSE-B2 (Backblaze-managed keys).
+ */
+exports.BACKBLAZE_SSE_ALGORITHM = {
+    AES256: 'AES256',
+};
+/**
+ * Supported Object Lock modes.
+ */
+exports.BACKBLAZE_OBJECT_LOCK_MODE = {
+    GOVERNANCE: 'GOVERNANCE',
+    COMPLIANCE: 'COMPLIANCE',
+};
+//# sourceMappingURL=backblaze.constant.js.map

package/dist/constants/backblaze.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.constant.js","sourceRoot":"","sources":["../../src/constants/backblaze.constant.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,0BAA0B,GAAG,qCAAqC,CAAC;AAEhF;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,iBAAiB,EAAE,+BAA+B;CAC1C,CAAC;AAEX;;GAEG;AACU,QAAA,uBAAuB,GAAG;IACrC,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX;;GAEG;AACU,QAAA,0BAA0B,GAAG;IACxC,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;CAChB,CAAC"}

package/dist/constants/backblaze.settings.constants.d.ts

@@ -0,0 +1,6 @@
+export declare const BACKBLAZE_SETTING_KEYS: {
+    readonly GENERAL_REGION: "GLOBAL:BACKBLAZE:GENERAL:REGION";
+    readonly GENERAL_ACCESS_KEY_ID: "GLOBAL:BACKBLAZE:GENERAL:ACCESS_KEY_ID";
+    readonly GENERAL_SECRET_ACCESS_KEY: "GLOBAL:BACKBLAZE:GENERAL:SECRET_ACCESS_KEY";
+};
+//# sourceMappingURL=backblaze.settings.constants.d.ts.map

package/dist/constants/backblaze.settings.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.settings.constants.d.ts","sourceRoot":"","sources":["../../src/constants/backblaze.settings.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC"}

package/dist/constants/backblaze.settings.constants.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKBLAZE_SETTING_KEYS = void 0;
+exports.BACKBLAZE_SETTING_KEYS = {
+    GENERAL_REGION: 'GLOBAL:BACKBLAZE:GENERAL:REGION',
+    GENERAL_ACCESS_KEY_ID: 'GLOBAL:BACKBLAZE:GENERAL:ACCESS_KEY_ID',
+    GENERAL_SECRET_ACCESS_KEY: 'GLOBAL:BACKBLAZE:GENERAL:SECRET_ACCESS_KEY',
+};
+//# sourceMappingURL=backblaze.settings.constants.js.map

package/dist/constants/backblaze.settings.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.settings.constants.js","sourceRoot":"","sources":["../../src/constants/backblaze.settings.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,sBAAsB,GAAG;IACpC,cAAc,EAAE,iCAAiC;IACjD,qBAAqB,EAAE,wCAAwC;IAC/D,yBAAyB,EAAE,4CAA4C;CAC/D,CAAC"}

package/dist/dtos/create-bucket.dto.d.ts

@@ -0,0 +1,6 @@
+import { BucketAcl } from '../enums/backblaze.enums';
+export declare class CreateBucketDto {
+    bucketName: string;
+    acl?: BucketAcl;
+}
+//# sourceMappingURL=create-bucket.dto.d.ts.map

package/dist/dtos/create-bucket.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bucket.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/create-bucket.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,eAAe;IAE1B,UAAU,EAAG,MAAM,CAAC;IAIpB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB"}

package/dist/dtos/create-bucket.dto.js

@@ -0,0 +1,29 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateBucketDto = void 0;
+const class_validator_1 = require("class-validator");
+const backblaze_enums_1 = require("../enums/backblaze.enums");
+class CreateBucketDto {
+    bucketName;
+    acl;
+}
+exports.CreateBucketDto = CreateBucketDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateBucketDto.prototype, "bucketName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(Object.values(backblaze_enums_1.BucketAcl)),
+    __metadata("design:type", String)
+], CreateBucketDto.prototype, "acl", void 0);
+//# sourceMappingURL=create-bucket.dto.js.map

package/dist/dtos/create-bucket.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bucket.dto.js","sourceRoot":"","sources":["../../src/dtos/create-bucket.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA6D;AAE7D,8DAAqD;AAErD,MAAa,eAAe;IAE1B,UAAU,CAAU;IAIpB,GAAG,CAAa;CACjB;AAPD,0CAOC;AALC;IADC,IAAA,0BAAQ,GAAE;;mDACS;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,sBAAI,EAAC,MAAM,CAAC,MAAM,CAAC,2BAAS,CAAC,CAAC;;4CACf"}

package/dist/dtos/list-objects.dto.d.ts

@@ -0,0 +1,9 @@
+export declare class ListObjectsDto {
+    bucket: string;
+    prefix?: string;
+    delimiter?: string;
+    maxKeys?: number;
+    continuationToken?: string;
+    startAfter?: string;
+}
+//# sourceMappingURL=list-objects.dto.d.ts.map

package/dist/dtos/list-objects.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-objects.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/list-objects.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IAEzB,MAAM,EAAG,MAAM,CAAC;IAIhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAIhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAI3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/dtos/list-objects.dto.js

@@ -0,0 +1,53 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListObjectsDto = void 0;
+const class_validator_1 = require("class-validator");
+class ListObjectsDto {
+    bucket;
+    prefix;
+    delimiter;
+    maxKeys;
+    continuationToken;
+    startAfter;
+}
+exports.ListObjectsDto = ListObjectsDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListObjectsDto.prototype, "bucket", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListObjectsDto.prototype, "prefix", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListObjectsDto.prototype, "delimiter", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(1000),
+    __metadata("design:type", Number)
+], ListObjectsDto.prototype, "maxKeys", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListObjectsDto.prototype, "continuationToken", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListObjectsDto.prototype, "startAfter", void 0);
+//# sourceMappingURL=list-objects.dto.js.map

package/dist/dtos/list-objects.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-objects.dto.js","sourceRoot":"","sources":["../../src/dtos/list-objects.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAiE;AAEjE,MAAa,cAAc;IAEzB,MAAM,CAAU;IAIhB,MAAM,CAAU;IAIhB,SAAS,CAAU;IAKnB,OAAO,CAAU;IAIjB,iBAAiB,CAAU;IAI3B,UAAU,CAAU;CACrB;AAxBD,wCAwBC;AAtBC;IADC,IAAA,0BAAQ,GAAE;;8CACK;AAIhB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;8CACK;AAIhB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;iDACQ;AAKnB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,qBAAG,EAAC,CAAC,CAAC;IACN,IAAA,qBAAG,EAAC,IAAI,CAAC;;+CACO;AAIjB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;yDACgB;AAI3B;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kDACS"}

package/dist/dtos/put-object.dto.d.ts

@@ -0,0 +1,12 @@
+export declare class PutObjectDto {
+    bucket: string;
+    key: string;
+    /** Body: Buffer, Uint8Array, Blob, string, or ReadableStream */
+    body?: Buffer | Uint8Array | Blob | string | ReadableStream;
+    contentType?: string;
+    cacheControl?: string;
+    contentDisposition?: string;
+    contentEncoding?: string;
+    metadata?: Record<string, string>;
+}
+//# sourceMappingURL=put-object.dto.d.ts.map

package/dist/dtos/put-object.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-object.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/put-object.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAEvB,MAAM,EAAG,MAAM,CAAC;IAGhB,GAAG,EAAG,MAAM,CAAC;IAEb,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,cAAc,CAAC;IAI5D,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,YAAY,CAAC,EAAE,MAAM,CAAC;IAItB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAI5B,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC"}

package/dist/dtos/put-object.dto.js

@@ -0,0 +1,58 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PutObjectDto = void 0;
+const class_validator_1 = require("class-validator");
+class PutObjectDto {
+    bucket;
+    key;
+    /** Body: Buffer, Uint8Array, Blob, string, or ReadableStream */
+    body;
+    contentType;
+    cacheControl;
+    contentDisposition;
+    contentEncoding;
+    metadata;
+}
+exports.PutObjectDto = PutObjectDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PutObjectDto.prototype, "bucket", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PutObjectDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PutObjectDto.prototype, "contentType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PutObjectDto.prototype, "cacheControl", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PutObjectDto.prototype, "contentDisposition", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PutObjectDto.prototype, "contentEncoding", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], PutObjectDto.prototype, "metadata", void 0);
+//# sourceMappingURL=put-object.dto.js.map

package/dist/dtos/put-object.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-object.dto.js","sourceRoot":"","sources":["../../src/dtos/put-object.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AAEvD,MAAa,YAAY;IAEvB,MAAM,CAAU;IAGhB,GAAG,CAAU;IAEb,gEAAgE;IAChE,IAAI,CAAwD;IAI5D,WAAW,CAAU;IAIrB,YAAY,CAAU;IAItB,kBAAkB,CAAU;IAI5B,eAAe,CAAU;IAGzB,QAAQ,CAA0B;CACnC;AA5BD,oCA4BC;AA1BC;IADC,IAAA,0BAAQ,GAAE;;4CACK;AAGhB;IADC,IAAA,0BAAQ,GAAE;;yCACE;AAOb;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;iDACU;AAIrB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kDACW;AAItB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;wDACiB;AAI5B;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;qDACc;AAGzB;IADC,IAAA,4BAAU,GAAE;;8CACqB"}