@venturialstd/backblaze 0.0.1 → 0.0.3

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.3",
   "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"
   },