@venturialstd/backblaze 0.0.1 → 0.0.2

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;CA8BxB"}

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)) ??

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":"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"}

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"}

package/dist/errors/backblaze-s3.error.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackblazeS3ErrorCode = exports.BackblazeS3Error = void 0;
+/**
+ * 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.
+ */
+class BackblazeS3Error extends Error {
+    code;
+    statusCode;
+    requestId;
+    resource;
+    key;
+    bucketName;
+    details;
+    constructor(code, message, statusCode, details = {}) {
+        super(message);
+        this.name = 'BackblazeS3Error';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.requestId = details.RequestId;
+        this.resource = details.Resource;
+        this.key = details.Key;
+        this.bucketName = details.BucketName;
+        this.details = details;
+        Object.setPrototypeOf(this, BackblazeS3Error.prototype);
+    }
+    /** Whether this is a "not found" type error (NoSuchKey, NoSuchBucket). */
+    get isNotFound() {
+        return this.code === 'NoSuchKey' || this.code === 'NoSuchBucket' || this.code === '404';
+    }
+    /** Whether this is an access denied / forbidden error. */
+    get isAccessDenied() {
+        return this.code === 'AccessDenied' || this.code === '403';
+    }
+}
+exports.BackblazeS3Error = BackblazeS3Error;
+/** Common S3 error codes for type-safe checks. */
+exports.BackblazeS3ErrorCode = {
+    AccessDenied: 'AccessDenied',
+    BucketAlreadyExists: 'BucketAlreadyExists',
+    BucketAlreadyOwnedByYou: 'BucketAlreadyOwnedByYou',
+    InvalidBucketName: 'InvalidBucketName',
+    NoSuchBucket: 'NoSuchBucket',
+    NoSuchKey: 'NoSuchKey',
+    NotFound: '404',
+    PreconditionFailed: 'PreconditionFailed',
+    RequestTimeout: 'RequestTimeout',
+    ServiceUnavailable: 'ServiceUnavailable',
+    InternalError: 'InternalError',
+};
+//# sourceMappingURL=backblaze-s3.error.js.map

package/dist/errors/backblaze-s3.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-s3.error.js","sourceRoot":"","sources":["../../src/errors/backblaze-s3.error.ts"],"names":[],"mappings":";;;AAcA;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,SAAS,CAAU;IACnB,QAAQ,CAAU;IAClB,GAAG,CAAU;IACb,UAAU,CAAU;IACpB,OAAO,CAAiB;IAEjC,YACE,IAAY,EACZ,OAAe,EACf,UAAkB,EAClB,UAA0B,EAAE;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAA+B,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAA8B,CAAC;QACvD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAyB,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAgC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,0EAA0E;IAC1E,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;IAC1F,CAAC;IAED,0DAA0D;IAC1D,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;IAC7D,CAAC;CACF;AApCD,4CAoCC;AAED,kDAAkD;AACrC,QAAA,oBAAoB,GAAG;IAClC,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,uBAAuB,EAAE,yBAAyB;IAClD,iBAAiB,EAAE,mBAAmB;IACtC,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,KAAK;IACf,kBAAkB,EAAE,oBAAoB;IACxC,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,eAAe;CACtB,CAAC"}

package/dist/index.d.ts

@@ -3,9 +3,15 @@ export * from './constants/backblaze-client.constant';
 export * from './constants/backblaze.constant';
 export * from './constants/backblaze.settings.constants';
 export * from './dtos/create-bucket.dto';
+export * from './dtos/delete-bucket.dto';
+export * from './dtos/delete-object.dto';
+export * from './dtos/get-object.dto';
+export * from './dtos/head-bucket.dto';
+export * from './dtos/head-object.dto';
 export * from './dtos/list-objects.dto';
 export * from './dtos/put-object.dto';
 export * from './enums/backblaze.enums';
+export * from './errors/backblaze-s3.error';
 export * from './interfaces/backblaze-credentials.interface';
 export * from './interfaces/backblaze-service.interface';
 export * from './backblaze.module';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -19,9 +19,15 @@ __exportStar(require("./constants/backblaze-client.constant"), exports);
 __exportStar(require("./constants/backblaze.constant"), exports);
 __exportStar(require("./constants/backblaze.settings.constants"), exports);
 __exportStar(require("./dtos/create-bucket.dto"), exports);
+__exportStar(require("./dtos/delete-bucket.dto"), exports);
+__exportStar(require("./dtos/delete-object.dto"), exports);
+__exportStar(require("./dtos/get-object.dto"), exports);
+__exportStar(require("./dtos/head-bucket.dto"), exports);
+__exportStar(require("./dtos/head-object.dto"), exports);
 __exportStar(require("./dtos/list-objects.dto"), exports);
 __exportStar(require("./dtos/put-object.dto"), exports);
 __exportStar(require("./enums/backblaze.enums"), exports);
+__exportStar(require("./errors/backblaze-s3.error"), exports);
 __exportStar(require("./interfaces/backblaze-credentials.interface"), exports);
 __exportStar(require("./interfaces/backblaze-service.interface"), exports);
 __exportStar(require("./backblaze.module"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,wEAAsD;AACtD,iEAA+C;AAC/C,2EAAyD;AACzD,2DAAyC;AACzC,0DAAwC;AACxC,wDAAsC;AACtC,0DAAwC;AACxC,+EAA6D;AAC7D,2EAAyD;AACzD,qDAAmC;AACnC,sEAAoD;AACpD,sEAAoD;AACpD,gEAA8C;AAC9C,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,wEAAsD;AACtD,iEAA+C;AAC/C,2EAAyD;AACzD,2DAAyC;AACzC,2DAAyC;AACzC,2DAAyC;AACzC,wDAAsC;AACtC,yDAAuC;AACvC,yDAAuC;AACvC,0DAAwC;AACxC,wDAAsC;AACtC,0DAAwC;AACxC,8DAA4C;AAC5C,+EAA6D;AAC7D,2EAAyD;AACzD,qDAAmC;AACnC,sEAAoD;AACpD,sEAAoD;AACpD,gEAA8C;AAC9C,sDAAoC"}

package/dist/services/backblaze-bucket.service.d.ts

@@ -1,6 +1,9 @@
 import { BackblazeClient } from '../client/backblaze.client';
+import type { CreateBucketDto } from '../dtos/create-bucket.dto';
+import type { DeleteBucketDto } from '../dtos/delete-bucket.dto';
+import type { HeadBucketDto } from '../dtos/head-bucket.dto';
 import { BackblazeOptions } from '../interfaces/backblaze-credentials.interface';
-import type { CreateBucketOptions, ListBucketsResult } from '../interfaces/backblaze-service.interface';
+import type { ListBucketsResult } from '../interfaces/backblaze-service.interface';
 /** Bucket as returned by S3 ListBuckets (parsed XML). */
 export interface S3Bucket {
     Name: string;
@@ -30,17 +33,17 @@ export declare class BackblazeBucketService {
      */
     listBucketsRaw(options?: BackblazeOptions): Promise<S3ListBucketsResponse>;
     /**
-     * Creates a bucket. Use BucketAcl enum for the acl option.
+     * Creates a bucket. Use CreateBucketDto with bucketName, optional acl and region.
      */
-    createBucket(bucketName: string, options?: CreateBucketOptions): Promise<void>;
+    createBucket(dto: CreateBucketDto, options?: BackblazeOptions): Promise<void>;
     /**
-     * Deletes a bucket. The bucket must be empty.
+     * Deletes a bucket. The bucket must be empty. Use DeleteBucketDto.
      */
-    deleteBucket(bucketName: string, options?: BackblazeOptions): Promise<void>;
+    deleteBucket(dto: DeleteBucketDto, options?: BackblazeOptions): Promise<void>;
     /**
-     * Checks if a bucket exists (HEAD request). Throws if the bucket does not exist.
+     * Checks if a bucket exists (HEAD request). Throws if the bucket does not exist. Use HeadBucketDto.
      */
-    headBucket(bucketName: string, options?: BackblazeOptions): Promise<void>;
+    headBucket(dto: HeadBucketDto, options?: BackblazeOptions): Promise<void>;
     private normalizeListBucketsResponse;
 }
 //# sourceMappingURL=backblaze-bucket.service.d.ts.map

package/dist/services/backblaze-bucket.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backblaze-bucket.service.d.ts","sourceRoot":"","sources":["../../src/services/backblaze-bucket.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAIxG,yDAAyD;AACzD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,sBAAsB,CAAC,EAAE;QACvB,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAA;SAAE,CAAC;QAC7C,KAAK,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC;CACH;AAED,qBACa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAWnE;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAS1E;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9E;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3E;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IASzE,OAAO,CAAC,4BAA4B;CAerC"}
+{"version":3,"file":"backblaze-bucket.service.d.ts","sourceRoot":"","sources":["../../src/services/backblaze-bucket.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,yDAAyD;AACzD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,sBAAsB,CAAC,EAAE;QACvB,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAA;SAAE,CAAC;QAC7C,KAAK,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC;CACH;AAED,qBACa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD;;OAEG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAWnE;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAS1E;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7E;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7E;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IASzE,OAAO,CAAC,4BAA4B;CAerC"}

package/dist/services/backblaze-bucket.service.js

@@ -44,42 +44,42 @@ let BackblazeBucketService = class BackblazeBucketService {
         });
     }
     /**
-     * Creates a bucket. Use BucketAcl enum for the acl option.
+     * Creates a bucket. Use CreateBucketDto with bucketName, optional acl and region.
      */
-    createBucket(bucketName, options) {
-        const region = options?.region;
+    createBucket(dto, options) {
+        const region = dto.region ?? options?.region;
         const body = region ? (0, s3_xml_util_1.createBucketConfigurationXml)(region) : undefined;
         const headers = {};
-        if (options?.acl != null)
-            headers['x-amz-acl'] = options.acl;
+        if (dto.acl != null)
+            headers['x-amz-acl'] = dto.acl;
         return this.client.request({
             options,
             method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.PUT,
-            path: `/${encodeURIComponent(bucketName)}`,
+            path: `/${encodeURIComponent(dto.bucketName)}`,
             body,
             headers: Object.keys(headers).length ? headers : undefined,
             responseType: 'text',
         });
     }
     /**
-     * Deletes a bucket. The bucket must be empty.
+     * Deletes a bucket. The bucket must be empty. Use DeleteBucketDto.
      */
-    deleteBucket(bucketName, options) {
+    deleteBucket(dto, options) {
         return this.client.request({
             options,
             method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.DELETE,
-            path: `/${encodeURIComponent(bucketName)}`,
+            path: `/${encodeURIComponent(dto.bucketName)}`,
             responseType: 'text',
         });
     }
     /**
-     * Checks if a bucket exists (HEAD request). Throws if the bucket does not exist.
+     * Checks if a bucket exists (HEAD request). Throws if the bucket does not exist. Use HeadBucketDto.
      */
-    headBucket(bucketName, options) {
+    headBucket(dto, options) {
         return this.client.request({
             options,
             method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.HEAD,
-            path: `/${encodeURIComponent(bucketName)}`,
+            path: `/${encodeURIComponent(dto.bucketName)}`,
             responseType: 'text',
         });
     }

package/dist/services/backblaze-bucket.service.js.map

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

package/dist/services/backblaze-object.service.d.ts

@@ -1,6 +1,11 @@
 import { BackblazeClient } from '../client/backblaze.client';
+import type { DeleteObjectDto } from '../dtos/delete-object.dto';
+import type { GetObjectDto } from '../dtos/get-object.dto';
+import type { HeadObjectDto } from '../dtos/head-object.dto';
+import type { ListObjectsDto } from '../dtos/list-objects.dto';
+import type { PutObjectDto } from '../dtos/put-object.dto';
 import { BackblazeOptions } from '../interfaces/backblaze-credentials.interface';
-import type { DeleteObjectOptions, GetObjectOptions, HeadObjectOptions, ListObjectsV2Params, ListObjectsV2Result, PutObjectOptions } from '../interfaces/backblaze-service.interface';
+import type { ListObjectsV2Result } from '../interfaces/backblaze-service.interface';
 /** S3 object entry (ListObjectsV2). */
 export interface S3ObjectEntry {
     Key?: string;
@@ -26,30 +31,30 @@ export declare class BackblazeObjectService {
     private readonly client;
     constructor(client: BackblazeClient);
     /**
-     * Uploads an object. Use ContentType enum for common types, or pass a custom string.
+     * Uploads an object. Use PutObjectDto with bucket, key, body and optional contentType.
      */
-    putObject(bucketName: string, key: string, body: Buffer | Uint8Array, options?: PutObjectOptions): Promise<void>;
+    putObject(dto: PutObjectDto, options?: BackblazeOptions): Promise<void>;
     /**
-     * Downloads an object. Returns the body as ArrayBuffer.
+     * Downloads an object. Returns the body as ArrayBuffer. Use GetObjectDto.
      */
-    getObject(bucketName: string, key: string, options?: GetObjectOptions): Promise<ArrayBuffer>;
+    getObject(dto: GetObjectDto, options?: BackblazeOptions): Promise<ArrayBuffer>;
     /**
-     * Deletes an object. Optionally specify versionId for versioned buckets.
+     * Deletes an object. Use DeleteObjectDto. Optionally specify versionId for versioned buckets.
      */
-    deleteObject(bucketName: string, key: string, options?: DeleteObjectOptions): Promise<void>;
+    deleteObject(dto: DeleteObjectDto, options?: BackblazeOptions): Promise<void>;
     /**
-     * Lists objects in a bucket. Returns a normalized result for easier consumption.
-     * Use ListObjectsV2Params for prefix, maxKeys, pagination, etc.
+     * Lists objects in a bucket. Returns a normalized result. Use ListObjectsDto.
      */
-    listObjectsV2(bucketName: string, params?: ListObjectsV2Params, options?: BackblazeOptions): Promise<ListObjectsV2Result>;
+    listObjectsV2(dto: ListObjectsDto, options?: BackblazeOptions): Promise<ListObjectsV2Result>;
     /**
      * Raw S3 List Objects V2 response (XML parsed to JSON). Use when you need the full structure.
      */
-    listObjectsV2Raw(bucketName: string, params?: ListObjectsV2Params, options?: BackblazeOptions): Promise<S3ListObjectsV2Response>;
+    listObjectsV2Raw(dto: ListObjectsDto, options?: BackblazeOptions): Promise<S3ListObjectsV2Response>;
     /**
-     * Returns object metadata (Content-Length, Content-Type, ETag, etc.) in response headers.
+     * Returns object metadata (Content-Length, Content-Type, ETag, etc.) in response headers. Use HeadObjectDto.
      */
-    headObject(bucketName: string, key: string, options?: HeadObjectOptions): Promise<Record<string, string>>;
+    headObject(dto: HeadObjectDto, options?: BackblazeOptions): Promise<Record<string, string>>;
+    private normalizeBody;
     private normalizeListObjectsV2Response;
     private encodeKey;
 }

package/dist/services/backblaze-object.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backblaze-object.service.d.ts","sourceRoot":"","sources":["../../src/services/backblaze-object.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,2CAA2C,CAAC;AAEnD,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;KAC5C,CAAC;CACH;AAED,qBACa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD;;OAEG;IACH,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACH,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC;IAavB;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAahB;;;OAGG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAkB/B;;OAEG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,uBAAuB,CAAC;IAgBnC;;OAEG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAclC,OAAO,CAAC,8BAA8B;IAmBtC,OAAO,CAAC,SAAS;CAMlB"}
+{"version":3,"file":"backblaze-object.service.d.ts","sourceRoot":"","sources":["../../src/services/backblaze-object.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;KAC5C,CAAC;CACH;AAED,qBACa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvE;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAa9E;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7E;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAmB/B;;OAEG;IACH,gBAAgB,CACd,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,uBAAuB,CAAC;IAiBnC;;OAEG;IACG,UAAU,CACd,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAclC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,8BAA8B;IAmBtC,OAAO,CAAC,SAAS;CAMlB"}

package/dist/services/backblaze-object.service.js

@@ -20,12 +20,12 @@ let BackblazeObjectService = class BackblazeObjectService {
         this.client = client;
     }
     /**
-     * Uploads an object. Use ContentType enum for common types, or pass a custom string.
+     * Uploads an object. Use PutObjectDto with bucket, key, body and optional contentType.
      */
-    putObject(bucketName, key, body, options) {
-        const buf = Buffer.isBuffer(body) ? body : Buffer.from(body);
-        const contentType = options?.contentType ?? backblaze_enums_1.ContentType.ApplicationOctetStream;
-        const path = `/${encodeURIComponent(bucketName)}/${this.encodeKey(key)}`;
+    putObject(dto, options) {
+        const buf = this.normalizeBody(dto.body);
+        const contentType = dto.contentType ?? backblaze_enums_1.ContentType.ApplicationOctetStream;
+        const path = `/${encodeURIComponent(dto.bucketName)}/${this.encodeKey(dto.key)}`;
         const headers = {
             'Content-Length': String(buf.length),
             'Content-Type': contentType,
@@ -40,12 +40,12 @@ let BackblazeObjectService = class BackblazeObjectService {
         });
     }
     /**
-     * Downloads an object. Returns the body as ArrayBuffer.
+     * Downloads an object. Returns the body as ArrayBuffer. Use GetObjectDto.
      */
-    getObject(bucketName, key, options) {
-        let path = `/${encodeURIComponent(bucketName)}/${this.encodeKey(key)}`;
-        if (options?.versionId) {
-            path += `?versionId=${encodeURIComponent(options.versionId)}`;
+    getObject(dto, options) {
+        let path = `/${encodeURIComponent(dto.bucketName)}/${this.encodeKey(dto.key)}`;
+        if (dto.versionId) {
+            path += `?versionId=${encodeURIComponent(dto.versionId)}`;
         }
         return this.client.request({
             options,
@@ -55,12 +55,12 @@ let BackblazeObjectService = class BackblazeObjectService {
         });
     }
     /**
-     * Deletes an object. Optionally specify versionId for versioned buckets.
+     * Deletes an object. Use DeleteObjectDto. Optionally specify versionId for versioned buckets.
      */
-    deleteObject(bucketName, key, options) {
-        let path = `/${encodeURIComponent(bucketName)}/${this.encodeKey(key)}`;
-        if (options?.versionId) {
-            path += `?versionId=${encodeURIComponent(options.versionId)}`;
+    deleteObject(dto, options) {
+        let path = `/${encodeURIComponent(dto.bucketName)}/${this.encodeKey(dto.key)}`;
+        if (dto.versionId) {
+            path += `?versionId=${encodeURIComponent(dto.versionId)}`;
         }
         return this.client.request({
             options,
@@ -70,21 +70,20 @@ let BackblazeObjectService = class BackblazeObjectService {
         });
     }
     /**
-     * Lists objects in a bucket. Returns a normalized result for easier consumption.
-     * Use ListObjectsV2Params for prefix, maxKeys, pagination, etc.
+     * Lists objects in a bucket. Returns a normalized result. Use ListObjectsDto.
      */
-    listObjectsV2(bucketName, params, options) {
+    listObjectsV2(dto, options) {
         const query = new URLSearchParams();
         query.set('list-type', '2');
-        if (params?.prefix != null)
-            query.set('prefix', params.prefix);
-        if (params?.maxKeys != null)
-            query.set('max-keys', String(params.maxKeys));
-        if (params?.continuationToken != null)
-            query.set('continuation-token', params.continuationToken);
-        if (params?.startAfter != null)
-            query.set('start-after', params.startAfter);
-        const path = `/${encodeURIComponent(bucketName)}?${query.toString()}`;
+        if (dto.prefix != null)
+            query.set('prefix', dto.prefix);
+        if (dto.maxKeys != null)
+            query.set('max-keys', String(dto.maxKeys));
+        if (dto.continuationToken != null)
+            query.set('continuation-token', dto.continuationToken);
+        if (dto.startAfter != null)
+            query.set('start-after', dto.startAfter);
+        const path = `/${encodeURIComponent(dto.bucketName)}?${query.toString()}`;
         return this.client
             .request({
             options,
@@ -97,18 +96,18 @@ let BackblazeObjectService = class BackblazeObjectService {
     /**
      * Raw S3 List Objects V2 response (XML parsed to JSON). Use when you need the full structure.
      */
-    listObjectsV2Raw(bucketName, params, options) {
+    listObjectsV2Raw(dto, options) {
         const query = new URLSearchParams();
         query.set('list-type', '2');
-        if (params?.prefix != null)
-            query.set('prefix', params.prefix);
-        if (params?.maxKeys != null)
-            query.set('max-keys', String(params.maxKeys));
-        if (params?.continuationToken != null)
-            query.set('continuation-token', params.continuationToken);
-        if (params?.startAfter != null)
-            query.set('start-after', params.startAfter);
-        const path = `/${encodeURIComponent(bucketName)}?${query.toString()}`;
+        if (dto.prefix != null)
+            query.set('prefix', dto.prefix);
+        if (dto.maxKeys != null)
+            query.set('max-keys', String(dto.maxKeys));
+        if (dto.continuationToken != null)
+            query.set('continuation-token', dto.continuationToken);
+        if (dto.startAfter != null)
+            query.set('start-after', dto.startAfter);
+        const path = `/${encodeURIComponent(dto.bucketName)}?${query.toString()}`;
         return this.client.request({
             options,
             method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.GET,
@@ -117,12 +116,12 @@ let BackblazeObjectService = class BackblazeObjectService {
         });
     }
     /**
-     * Returns object metadata (Content-Length, Content-Type, ETag, etc.) in response headers.
+     * Returns object metadata (Content-Length, Content-Type, ETag, etc.) in response headers. Use HeadObjectDto.
      */
-    async headObject(bucketName, key, options) {
-        let path = `/${encodeURIComponent(bucketName)}/${this.encodeKey(key)}`;
-        if (options?.versionId) {
-            path += `?versionId=${encodeURIComponent(options.versionId)}`;
+    async headObject(dto, options) {
+        let path = `/${encodeURIComponent(dto.bucketName)}/${this.encodeKey(dto.key)}`;
+        if (dto.versionId) {
+            path += `?versionId=${encodeURIComponent(dto.versionId)}`;
         }
         const res = await this.client.requestWithResponse({
             options,
@@ -132,6 +131,17 @@ let BackblazeObjectService = class BackblazeObjectService {
         });
         return res.headers;
     }
+    normalizeBody(body) {
+        if (body == null)
+            return Buffer.from([]);
+        if (Buffer.isBuffer(body))
+            return body;
+        if (body instanceof Uint8Array)
+            return Buffer.from(body);
+        if (typeof body === 'string')
+            return Buffer.from(body, 'utf8');
+        return Buffer.from([]);
+    }
     normalizeListObjectsV2Response(raw) {
         const result = raw?.ListBucketResult;
         const contents = result?.Contents;

package/dist/services/backblaze-object.service.js.map

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

package/dist/utils/s3-xml.util.d.ts

@@ -2,6 +2,10 @@
  * Parses S3 response XML (ListBuckets, ListObjects, etc.) to JSON.
  */
 export declare function parseXmlToJson(xml: string): Record<string, unknown>;
+/**
+ * Parses S3 error response XML to a flat payload (Code, Message, Resource, etc.).
+ */
+export declare function parseS3ErrorXml(body: string): Record<string, unknown> | undefined;
 /** Standard S3 namespace for bucket creation XML. */
 export declare const S3_XML_NS = "http://s3.amazonaws.com/doc/2006-03-01/";
 /**

package/dist/utils/s3-xml.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"s3-xml.util.d.ts","sourceRoot":"","sources":["../../src/utils/s3-xml.util.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnE;AAED,qDAAqD;AACrD,eAAO,MAAM,SAAS,4CAA4C,CAAC;AAEnE;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE"}
+{"version":3,"file":"s3-xml.util.d.ts","sourceRoot":"","sources":["../../src/utils/s3-xml.util.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnE;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAUjF;AAED,qDAAqD;AACrD,eAAO,MAAM,SAAS,4CAA4C,CAAC;AAEnE;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/utils/s3-xml.util.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.S3_XML_NS = void 0;
 exports.parseXmlToJson = parseXmlToJson;
+exports.parseS3ErrorXml = parseS3ErrorXml;
 exports.createBucketConfigurationXml = createBucketConfigurationXml;
 const fast_xml_parser_1 = require("fast-xml-parser");
 const parser = new fast_xml_parser_1.XMLParser({
@@ -17,6 +18,21 @@ function parseXmlToJson(xml) {
     const result = parser.parse(xml);
     return (result && typeof result === 'object' ? result : {});
 }
+const S3_ERROR_ROOT = 'Error';
+/**
+ * Parses S3 error response XML to a flat payload (Code, Message, Resource, etc.).
+ */
+function parseS3ErrorXml(body) {
+    if (!body || typeof body !== 'string' || !body.trim().startsWith('<?xml')) {
+        return undefined;
+    }
+    const parsed = parseXmlToJson(body);
+    const error = parsed?.[S3_ERROR_ROOT];
+    if (!error || typeof error !== 'object') {
+        return undefined;
+    }
+    return error;
+}
 /** Standard S3 namespace for bucket creation XML. */
 exports.S3_XML_NS = 'http://s3.amazonaws.com/doc/2006-03-01/';
 /**

package/dist/utils/s3-xml.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3-xml.util.js","sourceRoot":"","sources":["../../src/utils/s3-xml.util.ts"],"names":[],"mappings":";;;AAYA,wCAGC;AAQD,oEAEC;AAzBD,qDAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,2BAAS,CAAC;IAC3B,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,KAAK;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;AACzF,CAAC;AAED,qDAAqD;AACxC,QAAA,SAAS,GAAG,yCAAyC,CAAC;AAEnE;;GAEG;AACH,SAAgB,4BAA4B,CAAC,MAAc;IACzD,OAAO,2EAA2E,iBAAS,yBAAyB,SAAS,CAAC,MAAM,CAAC,mDAAmD,CAAC;AAC3L,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"s3-xml.util.js","sourceRoot":"","sources":["../../src/utils/s3-xml.util.ts"],"names":[],"mappings":";;;AAYA,wCAGC;AAOD,0CAUC;AAQD,oEAEC;AA1CD,qDAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,2BAAS,CAAC;IAC3B,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,KAAK;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;AACzF,CAAC;AAED,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAA4B,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,qDAAqD;AACxC,QAAA,SAAS,GAAG,yCAAyC,CAAC;AAEnE;;GAEG;AACH,SAAgB,4BAA4B,CAAC,MAAc;IACzD,OAAO,2EAA2E,iBAAS,yBAAyB,SAAS,CAAC,MAAM,CAAC,mDAAmD,CAAC;AAC3L,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@venturialstd/backblaze",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Backblaze B2 S3-Compatible API client for Venturial (no AWS SDK)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -24,7 +26,7 @@
     "@nestjs/axios": "^4.0.0",
     "@nestjs/common": "^11.0.11",
     "@nestjs/core": "^11.0.5",
-    "@venturialstd/core": "^1.0.16",
+    "@venturialstd/core": "^2.0.0",
     "class-validator": "^0.14.1",
     "rxjs": "^7.8.1"
   },