@venturialstd/backblaze 0.0.1 → 0.0.3

package/README.md

@@ -24,11 +24,16 @@ yarn add @venturialstd/backblaze
 
 ## Basic usage
 
+All bucket and object methods accept **DTOs** (e.g. `CreateBucketDto`, `PutObjectDto`, `ListObjectsDto`). When the API returns an error (4xx/5xx), the client throws **`BackblazeS3Error`** with the Backblaze/S3 `Code`, `Message`, and `statusCode` so the error message is visible to callers.
+
 ```ts
 import {
   BackblazeModule,
   BackblazeBucketService,
   BackblazeObjectService,
+  CreateBucketDto,
+  PutObjectDto,
+  ListObjectsDto,
   BucketAcl,
   ContentType,
 } from '@venturialstd/backblaze';
@@ -46,29 +51,55 @@ export class MyService {
   ) {}
 
   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 createBucket(dto: CreateBucketDto) {
+    await this.bucketService.createBucket(
+      { ...dto, acl: dto.acl ?? BucketAcl.Private },
+    );
   }
 
   async upload(bucketName: string, key: string, body: Buffer) {
-    await this.objectService.putObject(bucketName, key, body, {
+    await this.objectService.putObject({
+      bucketName,
+      key,
+      body,
       contentType: ContentType.ApplicationJson,
     });
   }
 
   async download(bucketName: string, key: string) {
-    return this.objectService.getObject(bucketName, key);
+    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 });
+    return this.objectService.listObjectsV2({
+      bucketName,
+      prefix,
+      maxKeys: 1000,
+    });
+  }
+}
+```
+
+### Error handling
+
+On 4xx/5xx the client throws **`BackblazeS3Error`** with the parsed S3 `Code`, `Message`, and `statusCode`. Use it for programmatic handling:
+
+```ts
+import { BackblazeS3Error, BackblazeS3ErrorCode } from '@venturialstd/backblaze';
+
+try {
+  await this.objectService.getObject({ bucketName: 'b', key: 'k' });
+} catch (err) {
+  if (err instanceof BackblazeS3Error) {
+    console.error(err.message); // Backblaze/S3 error message
+    if (err.isNotFound) { /* ... */ }
+    if (err.isAccessDenied) { /* ... */ }
   }
+  throw err;
 }
 ```
 
@@ -97,7 +128,8 @@ await this.bucketService.listBuckets({
 
 - 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.
+- **DTOs**: All operations use DTOs (`CreateBucketDto`, `DeleteBucketDto`, `HeadBucketDto`, `PutObjectDto`, `GetObjectDto`, `DeleteObjectDto`, `HeadObjectDto`, `ListObjectsDto`). Enums: `BucketAcl`, `ContentType`, `BackblazeRegion`. Normalized results: `listBuckets()`, `listObjectsV2()`. Raw: `listBucketsRaw()`, `listObjectsV2Raw()`.
+- **Errors**: On API errors the client throws `BackblazeS3Error` with the Backblaze/S3 message and code so the error is visible (e.g. in exception filters). Use `BackblazeS3ErrorCode` for known codes.
 - Developed and maintained by Venturial.
 
 ## License

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

@@ -12,6 +12,7 @@ export declare class BackblazeClient {
         headers: Record<string, string>;
         status: number;
     }>;
+    private getResponseBody;
     private getConfig;
 }
 //# sourceMappingURL=backblaze.client.d.ts.map

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

@@ -1 +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"}
+{"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;AAQhE,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;IA8D9E,OAAO,CAAC,eAAe;YAOT,SAAS;CAiCxB"}

package/dist/client/backblaze.client.js

@@ -50,6 +50,7 @@ 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 backblaze_s3_error_1 = require("../errors/backblaze-s3.error");
 const s3_xml_util_1 = require("../utils/s3-xml.util");
 let BackblazeClient = class BackblazeClient {
     httpService;
@@ -91,17 +92,36 @@ let BackblazeClient = class BackblazeClient {
         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')) {
+            if (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}`);
+            const axiosErr = err;
+            const status = axiosErr?.response?.status;
+            const urlForLog = axiosErr?.config?.url ?? url;
+            const body = this.getResponseBody(axiosErr);
+            const payload = body ? (0, s3_xml_util_1.parseS3ErrorXml)(body) : undefined;
+            const code = payload?.Code ?? (status === 404 ? 'NotFound' : status ? 'HttpError' : 'NetworkError');
+            const message = payload?.Message ??
+                (status != null ? `Request failed with status code ${status}` : err.message);
+            this.logger?.error(`Backblaze S3 request error: ${method} ${urlForLog} - ${code}: ${message}`);
+            if (status != null) {
+                throw new backblaze_s3_error_1.BackblazeS3Error(code, message, status, (payload ?? {}));
+            }
             throw err;
         }
     }
+    getResponseBody(err) {
+        const data = err.response?.data;
+        if (typeof data === 'string')
+            return data;
+        if (Buffer.isBuffer(data))
+            return data.toString('utf8');
+        return undefined;
+    }
     async getConfig(options) {
         const region = options?.region ??
             (await this.settings.get(backblaze_settings_constants_1.BACKBLAZE_SETTING_KEYS.GENERAL_REGION)) ??
@@ -113,11 +133,13 @@ let BackblazeClient = class BackblazeClient {
         if (!accessKeyId || !secretAccessKey) {
             throw new Error('Backblaze credentials not provided');
         }
-        const baseUrl = backblaze_constant_1.BACKBLAZE_ENDPOINT_PATTERN.replace('{region}', region);
+        const defaultBaseUrl = backblaze_constant_1.BACKBLAZE_ENDPOINT_PATTERN.replace('{region}', region);
+        const baseUrlRaw = (await this.settings.get(backblaze_settings_constants_1.BACKBLAZE_SETTING_KEYS.GENERAL_BASE_URL)) ?? defaultBaseUrl;
+        const baseUrl = baseUrlRaw.endsWith('/') ? baseUrlRaw.slice(0, -1) : baseUrlRaw;
         const host = baseUrl.replace(/^https?:\/\//, '').replace(/\/$/, '');
         return {
             host,
-            baseUrl: baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl,
+            baseUrl,
             region,
             credentials: { accessKeyId, secretAccessKey },
         };

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

@@ -1 +1 @@
-{"version":3,"file":"backblaze.client.js","sourceRoot":"","sources":["../../src/client/backblaze.client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backblaze.client.js","sourceRoot":"","sources":["../../src/client/backblaze.client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAA4C;AAC5C,2CAA4C;AAC5C,6CAAgE;AAChE,+BAAsC;AACtC,2CAA6B;AAG7B,wEAA6E;AAC7E,4FAAmF;AACnF,qEAAqF;AAKrF,sDAAuE;AAGhE,IAAM,eAAe,GAArB,MAAM,eAAe;IAEP;IACA;IACA;IAHnB,YACmB,WAAwB,EACxB,MAAiB,EACjB,QAAyB;QAFzB,gBAAW,GAAX,WAAW,CAAa;QACxB,WAAM,GAAN,MAAM,CAAW;QACjB,aAAQ,GAAR,QAAQ,CAAiB;IACzC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAI,MAAiC;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,IAAS,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,MAA8B;QAE9B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;QACpF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAE7E,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAChE,MAAM,GAAG,GAAiB;YACxB,IAAI;YACJ,IAAI,EAAE,cAAc,IAAI,GAAG;YAC3B,MAAM;YACN,OAAO,EAAE,IAAI;YACb,MAAM;YACN,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE;YACvB,IAAI,EAAE,IAA0B;SACjC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAE5B,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,cAAc,IAAI,GAAG,EAAE,CAAC;QACjD,MAAM,WAAW,GAMb;YACF,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAW;YACxC,GAAG;YACH,OAAO,EAAE,GAAG,CAAC,OAAiC;YAC9C,YAAY,EAAE,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;SACzG,CAAC;QACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,WAAW,CAAC,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAc,EAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;YAC7E,IAAI,IAAI,GAAY,QAAQ,CAAC,IAAI,CAAC;YAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAK,IAAe,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5E,IAAI,GAAG,IAAA,4BAAc,EAAC,IAAc,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,4BAA4B,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAiC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QAChG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,GAA0B,CAAC;YAC5C,MAAM,MAAM,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;YAC1C,MAAM,SAAS,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,6BAAe,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACzD,MAAM,IAAI,GACP,OAAO,EAAE,IAAe,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;YACrG,MAAM,OAAO,GACV,OAAO,EAAE,OAAkB;gBAC5B,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAC1F,IAAI,CAAC,MAAM,EAAE,KAAK,CAChB,+BAA+B,MAAM,IAAI,SAAS,MAAM,IAAI,KAAK,OAAO,EAAE,CAC3E,CAAC;YACF,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,qCAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,OAAO,IAAI,EAAE,CAAmB,CAAC,CAAC;YACvF,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,GAAwB;QAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC;QAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,OAA0B;QAMhD,MAAM,MAAM,GACV,OAAO,EAAE,MAAM;YACf,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,qDAAsB,CAAC,cAAc,CAAC,CAAC;YAChE,aAAa,CAAC;QAChB,MAAM,WAAW,GACf,OAAO,EAAE,WAAW,EAAE,WAAW;YACjC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,qDAAsB,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC1E,MAAM,eAAe,GACnB,OAAO,EAAE,WAAW,EAAE,eAAe;YACrC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,qDAAsB,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAE9E,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,cAAc,GAAG,+CAA0B,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC9E,MAAM,UAAU,GACd,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,qDAAsB,CAAC,gBAAgB,CAAC,CAAC,IAAI,cAAc,CAAC;QACvF,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAChF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,IAAI;YACJ,OAAO;YACP,MAAM;YACN,WAAW,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE;SAC9C,CAAC;IACJ,CAAC;CACF,CAAA;AApHY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;qCAGqB,mBAAW;QAChB,gBAAS;QACP,sBAAe;GAJjC,eAAe,CAoH3B"}

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

@@ -1,4 +1,5 @@
 export declare const BACKBLAZE_SETTING_KEYS: {
+    readonly GENERAL_BASE_URL: "GLOBAL:BACKBLAZE:GENERAL:BASE_URL";
     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";

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

@@ -1 +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"}
+{"version":3,"file":"backblaze.settings.constants.d.ts","sourceRoot":"","sources":["../../src/constants/backblaze.settings.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC"}

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BACKBLAZE_SETTING_KEYS = void 0;
 exports.BACKBLAZE_SETTING_KEYS = {
+    GENERAL_BASE_URL: 'GLOBAL:BACKBLAZE:GENERAL:BASE_URL',
     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',

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

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

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

@@ -2,5 +2,7 @@ import { BucketAcl } from '../enums/backblaze.enums';
 export declare class CreateBucketDto {
     bucketName: string;
     acl?: BucketAcl;
+    /** Region for CreateBucketConfiguration XML. If omitted, client region is used. */
+    region?: string;
 }
 //# sourceMappingURL=create-bucket.dto.d.ts.map

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

@@ -1 +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"}
+{"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;IAEhB,mFAAmF;IAGnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -15,6 +15,8 @@ const backblaze_enums_1 = require("../enums/backblaze.enums");
 class CreateBucketDto {
     bucketName;
     acl;
+    /** Region for CreateBucketConfiguration XML. If omitted, client region is used. */
+    region;
 }
 exports.CreateBucketDto = CreateBucketDto;
 __decorate([
@@ -26,4 +28,9 @@ __decorate([
     (0, class_validator_1.IsIn)(Object.values(backblaze_enums_1.BucketAcl)),
     __metadata("design:type", String)
 ], CreateBucketDto.prototype, "acl", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateBucketDto.prototype, "region", void 0);
 //# sourceMappingURL=create-bucket.dto.js.map

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

@@ -1 +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"}
+{"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;IAEhB,mFAAmF;IAGnF,MAAM,CAAU;CACjB;AAZD,0CAYC;AAVC;IADC,IAAA,0BAAQ,GAAE;;mDACS;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,sBAAI,EAAC,MAAM,CAAC,MAAM,CAAC,2BAAS,CAAC,CAAC;;4CACf;AAKhB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;+CACK"}

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

@@ -0,0 +1,4 @@
+export declare class DeleteBucketDto {
+    bucketName: string;
+}
+//# sourceMappingURL=delete-bucket.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-bucket.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/delete-bucket.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,eAAe;IAE1B,UAAU,EAAG,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,22 @@
+"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.DeleteBucketDto = void 0;
+const class_validator_1 = require("class-validator");
+class DeleteBucketDto {
+    bucketName;
+}
+exports.DeleteBucketDto = DeleteBucketDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DeleteBucketDto.prototype, "bucketName", void 0);
+//# sourceMappingURL=delete-bucket.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-bucket.dto.js","sourceRoot":"","sources":["../../src/dtos/delete-bucket.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA2C;AAE3C,MAAa,eAAe;IAE1B,UAAU,CAAU;CACrB;AAHD,0CAGC;AADC;IADC,IAAA,0BAAQ,GAAE;;mDACS"}

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

@@ -0,0 +1,6 @@
+export declare class DeleteObjectDto {
+    bucketName: string;
+    key: string;
+    versionId?: string;
+}
+//# sourceMappingURL=delete-object.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-object.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/delete-object.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,eAAe;IAE1B,UAAU,EAAG,MAAM,CAAC;IAGpB,GAAG,EAAG,MAAM,CAAC;IAIb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,33 @@
+"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.DeleteObjectDto = void 0;
+const class_validator_1 = require("class-validator");
+class DeleteObjectDto {
+    bucketName;
+    key;
+    versionId;
+}
+exports.DeleteObjectDto = DeleteObjectDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DeleteObjectDto.prototype, "bucketName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DeleteObjectDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DeleteObjectDto.prototype, "versionId", void 0);
+//# sourceMappingURL=delete-object.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-object.dto.js","sourceRoot":"","sources":["../../src/dtos/delete-object.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AAEvD,MAAa,eAAe;IAE1B,UAAU,CAAU;IAGpB,GAAG,CAAU;IAIb,SAAS,CAAU;CACpB;AAVD,0CAUC;AARC;IADC,IAAA,0BAAQ,GAAE;;mDACS;AAGpB;IADC,IAAA,0BAAQ,GAAE;;4CACE;AAIb;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kDACQ"}

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

@@ -0,0 +1,6 @@
+export declare class GetObjectDto {
+    bucketName: string;
+    key: string;
+    versionId?: string;
+}
+//# sourceMappingURL=get-object.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-object.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/get-object.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAEvB,UAAU,EAAG,MAAM,CAAC;IAGpB,GAAG,EAAG,MAAM,CAAC;IAIb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,33 @@
+"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.GetObjectDto = void 0;
+const class_validator_1 = require("class-validator");
+class GetObjectDto {
+    bucketName;
+    key;
+    versionId;
+}
+exports.GetObjectDto = GetObjectDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GetObjectDto.prototype, "bucketName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GetObjectDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GetObjectDto.prototype, "versionId", void 0);
+//# sourceMappingURL=get-object.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-object.dto.js","sourceRoot":"","sources":["../../src/dtos/get-object.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AAEvD,MAAa,YAAY;IAEvB,UAAU,CAAU;IAGpB,GAAG,CAAU;IAIb,SAAS,CAAU;CACpB;AAVD,oCAUC;AARC;IADC,IAAA,0BAAQ,GAAE;;gDACS;AAGpB;IADC,IAAA,0BAAQ,GAAE;;yCACE;AAIb;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;+CACQ"}

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

@@ -0,0 +1,4 @@
+export declare class HeadBucketDto {
+    bucketName: string;
+}
+//# sourceMappingURL=head-bucket.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"head-bucket.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/head-bucket.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IAExB,UAAU,EAAG,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,22 @@
+"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.HeadBucketDto = void 0;
+const class_validator_1 = require("class-validator");
+class HeadBucketDto {
+    bucketName;
+}
+exports.HeadBucketDto = HeadBucketDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], HeadBucketDto.prototype, "bucketName", void 0);
+//# sourceMappingURL=head-bucket.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"head-bucket.dto.js","sourceRoot":"","sources":["../../src/dtos/head-bucket.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA2C;AAE3C,MAAa,aAAa;IAExB,UAAU,CAAU;CACrB;AAHD,sCAGC;AADC;IADC,IAAA,0BAAQ,GAAE;;iDACS"}

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

@@ -0,0 +1,6 @@
+export declare class HeadObjectDto {
+    bucketName: string;
+    key: string;
+    versionId?: string;
+}
+//# sourceMappingURL=head-object.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"head-object.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/head-object.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IAExB,UAAU,EAAG,MAAM,CAAC;IAGpB,GAAG,EAAG,MAAM,CAAC;IAIb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,33 @@
+"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.HeadObjectDto = void 0;
+const class_validator_1 = require("class-validator");
+class HeadObjectDto {
+    bucketName;
+    key;
+    versionId;
+}
+exports.HeadObjectDto = HeadObjectDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], HeadObjectDto.prototype, "bucketName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], HeadObjectDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], HeadObjectDto.prototype, "versionId", void 0);
+//# sourceMappingURL=head-object.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"head-object.dto.js","sourceRoot":"","sources":["../../src/dtos/head-object.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AAEvD,MAAa,aAAa;IAExB,UAAU,CAAU;IAGpB,GAAG,CAAU;IAIb,SAAS,CAAU;CACpB;AAVD,sCAUC;AARC;IADC,IAAA,0BAAQ,GAAE;;iDACS;AAGpB;IADC,IAAA,0BAAQ,GAAE;;0CACE;AAIb;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;gDACQ"}

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

@@ -1,5 +1,5 @@
 export declare class ListObjectsDto {
-    bucket: string;
+    bucketName: string;
     prefix?: string;
     delimiter?: string;
     maxKeys?: number;

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

@@ -1 +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"}
+{"version":3,"file":"list-objects.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/list-objects.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IAEzB,UAAU,EAAG,MAAM,CAAC;IAIpB,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

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListObjectsDto = void 0;
 const class_validator_1 = require("class-validator");
 class ListObjectsDto {
-    bucket;
+    bucketName;
     prefix;
     delimiter;
     maxKeys;
@@ -23,7 +23,7 @@ exports.ListObjectsDto = ListObjectsDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], ListObjectsDto.prototype, "bucket", void 0);
+], ListObjectsDto.prototype, "bucketName", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),

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

@@ -1 +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"}
+{"version":3,"file":"list-objects.dto.js","sourceRoot":"","sources":["../../src/dtos/list-objects.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAiE;AAEjE,MAAa,cAAc;IAEzB,UAAU,CAAU;IAIpB,MAAM,CAAU;IAIhB,SAAS,CAAU;IAKnB,OAAO,CAAU;IAIjB,iBAAiB,CAAU;IAI3B,UAAU,CAAU;CACrB;AAxBD,wCAwBC;AAtBC;IADC,IAAA,0BAAQ,GAAE;;kDACS;AAIpB;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

@@ -1,5 +1,5 @@
 export declare class PutObjectDto {
-    bucket: string;
+    bucketName: string;
     key: string;
     /** Body: Buffer, Uint8Array, Blob, string, or ReadableStream */
     body?: Buffer | Uint8Array | Blob | string | ReadableStream;

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

@@ -1 +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"}
+{"version":3,"file":"put-object.dto.d.ts","sourceRoot":"","sources":["../../src/dtos/put-object.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAEvB,UAAU,EAAG,MAAM,CAAC;IAGpB,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

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PutObjectDto = void 0;
 const class_validator_1 = require("class-validator");
 class PutObjectDto {
-    bucket;
+    bucketName;
     key;
     /** Body: Buffer, Uint8Array, Blob, string, or ReadableStream */
     body;
@@ -26,7 +26,7 @@ exports.PutObjectDto = PutObjectDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], PutObjectDto.prototype, "bucket", void 0);
+], PutObjectDto.prototype, "bucketName", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

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

@@ -1 +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"}
+{"version":3,"file":"put-object.dto.js","sourceRoot":"","sources":["../../src/dtos/put-object.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AAEvD,MAAa,YAAY;IAEvB,UAAU,CAAU;IAGpB,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;;gDACS;AAGpB;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"}

package/dist/errors/backblaze-s3.error.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Structured S3 error payload as returned by Backblaze B2 / S3-Compatible API (parsed from XML).
+ */
+export interface S3ErrorPayload {
+    Code?: string;
+    Message?: string;
+    Resource?: string;
+    RequestId?: string;
+    HostId?: string;
+    Key?: string;
+    BucketName?: string;
+    [key: string]: unknown;
+}
+/**
+ * Thrown when the S3-Compatible API returns an error (4xx/5xx).
+ * Exposes the S3 error Code, Message, HTTP status, and optional details for programmatic handling.
+ */
+export declare class BackblazeS3Error extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly requestId?: string;
+    readonly resource?: string;
+    readonly key?: string;
+    readonly bucketName?: string;
+    readonly details: S3ErrorPayload;
+    constructor(code: string, message: string, statusCode: number, details?: S3ErrorPayload);
+    /** Whether this is a "not found" type error (NoSuchKey, NoSuchBucket). */
+    get isNotFound(): boolean;
+    /** Whether this is an access denied / forbidden error. */
+    get isAccessDenied(): boolean;
+}
+/** Common S3 error codes for type-safe checks. */
+export declare const BackblazeS3ErrorCode: {
+    readonly AccessDenied: "AccessDenied";
+    readonly BucketAlreadyExists: "BucketAlreadyExists";
+    readonly BucketAlreadyOwnedByYou: "BucketAlreadyOwnedByYou";
+    readonly InvalidBucketName: "InvalidBucketName";
+    readonly NoSuchBucket: "NoSuchBucket";
+    readonly NoSuchKey: "NoSuchKey";
+    readonly NotFound: "404";
+    readonly PreconditionFailed: "PreconditionFailed";
+    readonly RequestTimeout: "RequestTimeout";
+    readonly ServiceUnavailable: "ServiceUnavailable";
+    readonly InternalError: "InternalError";
+};
+export type BackblazeS3ErrorCodeType = (typeof BackblazeS3ErrorCode)[keyof typeof BackblazeS3ErrorCode];
+//# sourceMappingURL=backblaze-s3.error.d.ts.map

package/dist/errors/backblaze-s3.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-s3.error.d.ts","sourceRoot":"","sources":["../../src/errors/backblaze-s3.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAG/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAmB;IAc9B,0EAA0E;IAC1E,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,0DAA0D;IAC1D,IAAI,cAAc,IAAI,OAAO,CAE5B;CACF;AAED,kDAAkD;AAClD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAYvB,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC"}