@venturialstd/backblaze 0.0.1

package/dist/enums/backblaze.enums.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Bucket ACL supported by Backblaze B2 (bucket level only).
+ */
+export declare enum BucketAcl {
+    Private = "private",
+    PublicRead = "public-read"
+}
+/**
+ * Common content types for Put Object. Use the enum value or pass a custom string.
+ */
+export declare enum ContentType {
+    ApplicationOctetStream = "application/octet-stream",
+    ApplicationJson = "application/json",
+    TextPlain = "text/plain",
+    TextHtml = "text/html",
+    TextCsv = "text/csv",
+    ImageJpeg = "image/jpeg",
+    ImagePng = "image/png",
+    ImageGif = "image/gif",
+    ImageWebp = "image/webp",
+    ImageSvgXml = "image/svg+xml",
+    MultipartFormData = "multipart/form-data"
+}
+/**
+ * S3/Backblaze storage class (when returned in list/get).
+ */
+export declare enum StorageClass {
+    Standard = "STANDARD"
+}
+/**
+ * Known Backblaze regions for type safety.
+ */
+export declare enum BackblazeRegion {
+    UsWest004 = "us-west-004",
+    EuCentral003 = "eu-central-003"
+}
+//# sourceMappingURL=backblaze.enums.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.enums.d.ts","sourceRoot":"","sources":["../../src/enums/backblaze.enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,SAAS;IACnB,OAAO,YAAY;IACnB,UAAU,gBAAgB;CAC3B;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,sBAAsB,6BAA6B;IACnD,eAAe,qBAAqB;IACpC,SAAS,eAAe;IACxB,QAAQ,cAAc;IACtB,OAAO,aAAa;IACpB,SAAS,eAAe;IACxB,QAAQ,cAAc;IACtB,QAAQ,cAAc;IACtB,SAAS,eAAe;IACxB,WAAW,kBAAkB;IAC7B,iBAAiB,wBAAwB;CAC1C;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,SAAS,gBAAgB;IACzB,YAAY,mBAAmB;CAChC"}

package/dist/enums/backblaze.enums.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackblazeRegion = exports.StorageClass = exports.ContentType = exports.BucketAcl = void 0;
+/**
+ * Bucket ACL supported by Backblaze B2 (bucket level only).
+ */
+var BucketAcl;
+(function (BucketAcl) {
+    BucketAcl["Private"] = "private";
+    BucketAcl["PublicRead"] = "public-read";
+})(BucketAcl || (exports.BucketAcl = BucketAcl = {}));
+/**
+ * Common content types for Put Object. Use the enum value or pass a custom string.
+ */
+var ContentType;
+(function (ContentType) {
+    ContentType["ApplicationOctetStream"] = "application/octet-stream";
+    ContentType["ApplicationJson"] = "application/json";
+    ContentType["TextPlain"] = "text/plain";
+    ContentType["TextHtml"] = "text/html";
+    ContentType["TextCsv"] = "text/csv";
+    ContentType["ImageJpeg"] = "image/jpeg";
+    ContentType["ImagePng"] = "image/png";
+    ContentType["ImageGif"] = "image/gif";
+    ContentType["ImageWebp"] = "image/webp";
+    ContentType["ImageSvgXml"] = "image/svg+xml";
+    ContentType["MultipartFormData"] = "multipart/form-data";
+})(ContentType || (exports.ContentType = ContentType = {}));
+/**
+ * S3/Backblaze storage class (when returned in list/get).
+ */
+var StorageClass;
+(function (StorageClass) {
+    StorageClass["Standard"] = "STANDARD";
+})(StorageClass || (exports.StorageClass = StorageClass = {}));
+/**
+ * Known Backblaze regions for type safety.
+ */
+var BackblazeRegion;
+(function (BackblazeRegion) {
+    BackblazeRegion["UsWest004"] = "us-west-004";
+    BackblazeRegion["EuCentral003"] = "eu-central-003";
+})(BackblazeRegion || (exports.BackblazeRegion = BackblazeRegion = {}));
+//# sourceMappingURL=backblaze.enums.js.map

package/dist/enums/backblaze.enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.enums.js","sourceRoot":"","sources":["../../src/enums/backblaze.enums.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,uCAA0B,CAAA;AAC5B,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAED;;GAEG;AACH,IAAY,WAYX;AAZD,WAAY,WAAW;IACrB,kEAAmD,CAAA;IACnD,mDAAoC,CAAA;IACpC,uCAAwB,CAAA;IACxB,qCAAsB,CAAA;IACtB,mCAAoB,CAAA;IACpB,uCAAwB,CAAA;IACxB,qCAAsB,CAAA;IACtB,qCAAsB,CAAA;IACtB,uCAAwB,CAAA;IACxB,4CAA6B,CAAA;IAC7B,wDAAyC,CAAA;AAC3C,CAAC,EAZW,WAAW,2BAAX,WAAW,QAYtB;AAED;;GAEG;AACH,IAAY,YAEX;AAFD,WAAY,YAAY;IACtB,qCAAqB,CAAA;AACvB,CAAC,EAFW,YAAY,4BAAZ,YAAY,QAEvB;AAED;;GAEG;AACH,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,4CAAyB,CAAA;IACzB,kDAA+B,CAAA;AACjC,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from './client/backblaze.client';
+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/list-objects.dto';
+export * from './dtos/put-object.dto';
+export * from './enums/backblaze.enums';
+export * from './interfaces/backblaze-credentials.interface';
+export * from './interfaces/backblaze-service.interface';
+export * from './backblaze.module';
+export * from './services/backblaze-bucket.service';
+export * from './services/backblaze-object.service';
+export * from './settings/backblaze.settings';
+export * from './utils/s3-xml.util';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client/backblaze.client"), exports);
+__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/list-objects.dto"), exports);
+__exportStar(require("./dtos/put-object.dto"), exports);
+__exportStar(require("./enums/backblaze.enums"), exports);
+__exportStar(require("./interfaces/backblaze-credentials.interface"), exports);
+__exportStar(require("./interfaces/backblaze-service.interface"), exports);
+__exportStar(require("./backblaze.module"), exports);
+__exportStar(require("./services/backblaze-bucket.service"), exports);
+__exportStar(require("./services/backblaze-object.service"), exports);
+__exportStar(require("./settings/backblaze.settings"), exports);
+__exportStar(require("./utils/s3-xml.util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/interfaces/backblaze-credentials.interface.d.ts

@@ -0,0 +1,24 @@
+import type { BACKBLAZE_HTTP_METHOD } from '../constants/backblaze-client.constant';
+export interface BackblazeCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+}
+export interface BackblazeOptions {
+    credentials?: BackblazeCredentials;
+    /** Region for the S3 endpoint, e.g. us-west-004 */
+    region?: string;
+}
+/** Parameters for an S3-Compatible request (signed with AWS Sig v4). */
+export interface BackblazeRequestParams<T = unknown> {
+    options?: BackblazeOptions;
+    method: BACKBLAZE_HTTP_METHOD;
+    /** Path without or with bucket/key depending on the operation. E.g. /, /my-bucket, /my-bucket/path/to/key */
+    path: string;
+    /** Body: string (XML/JSON) or Buffer (binary). Included in the signature. */
+    body?: string | Buffer;
+    /** Additional headers (Content-Type, x-amz-acl, etc.). Included in the signature. */
+    headers?: Record<string, string>;
+    /** Default 'json'. Use 'arraybuffer' for downloads. For XML the client may parse to JSON. */
+    responseType?: 'json' | 'arraybuffer' | 'text';
+}
+//# sourceMappingURL=backblaze-credentials.interface.d.ts.map

package/dist/interfaces/backblaze-credentials.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-credentials.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/backblaze-credentials.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,OAAO;IACjD,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,6GAA6G;IAC7G,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;CAChD"}

package/dist/interfaces/backblaze-credentials.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=backblaze-credentials.interface.js.map

package/dist/interfaces/backblaze-credentials.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-credentials.interface.js","sourceRoot":"","sources":["../../src/interfaces/backblaze-credentials.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/backblaze-service.interface.d.ts

@@ -0,0 +1,73 @@
+import type { BackblazeOptions } from './backblaze-credentials.interface';
+import type { BucketAcl } from '../enums/backblaze.enums';
+/** Options for creating a bucket. */
+export interface CreateBucketOptions extends BackblazeOptions {
+    /** Bucket ACL. Defaults to private if omitted. */
+    acl?: BucketAcl;
+    /** Region for CreateBucketConfiguration XML. If omitted, client region is used. */
+    region?: string;
+}
+/** Options for put object. */
+export interface PutObjectOptions extends BackblazeOptions {
+    /** Content-Type header. Use ContentType enum or a custom MIME type string. */
+    contentType?: string;
+}
+/** Options for get object. */
+export interface GetObjectOptions extends BackblazeOptions {
+    /** Version ID for versioned buckets. */
+    versionId?: string;
+}
+/** Options for delete object. */
+export interface DeleteObjectOptions extends BackblazeOptions {
+    /** Version ID for versioned buckets. */
+    versionId?: string;
+}
+/** Options for head object. */
+export interface HeadObjectOptions extends BackblazeOptions {
+    /** Version ID for versioned buckets. */
+    versionId?: string;
+}
+/** Parameters for listing objects (List Objects V2). */
+export interface ListObjectsV2Params {
+    /** Prefix to filter keys. */
+    prefix?: string;
+    /** Maximum number of keys to return (1–1000). */
+    maxKeys?: number;
+    /** Continuation token for pagination. */
+    continuationToken?: string;
+    /** Start listing after this key. */
+    startAfter?: string;
+}
+/** Normalized result of List Buckets (developer-friendly). */
+export interface ListBucketsResult {
+    /** List of buckets. */
+    buckets: Array<{
+        name: string;
+        creationDate?: string;
+    }>;
+    /** Bucket owner from S3 response. */
+    owner?: {
+        id?: string;
+        displayName?: string;
+    };
+}
+/** Normalized result of List Objects V2 (developer-friendly). */
+export interface ListObjectsV2Result {
+    /** List of object entries. */
+    objects: Array<{
+        key?: string;
+        lastModified?: string;
+        etag?: string;
+        size?: number;
+        storageClass?: string;
+    }>;
+    /** Whether the list is truncated (more results available). */
+    isTruncated: boolean;
+    /** Total number of keys returned. */
+    keyCount: number;
+    /** Token for the next page. Present when isTruncated is true. */
+    nextContinuationToken?: string;
+    /** Prefix that was applied. */
+    prefix?: string;
+}
+//# sourceMappingURL=backblaze-service.interface.d.ts.map

package/dist/interfaces/backblaze-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-service.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/backblaze-service.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,qCAAqC;AACrC,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,kDAAkD;IAClD,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8BAA8B;AAC9B,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iCAAiC;AACjC,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,qCAAqC;IACrC,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,OAAO,EAAE,KAAK,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/interfaces/backblaze-service.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=backblaze-service.interface.js.map

package/dist/interfaces/backblaze-service.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze-service.interface.js","sourceRoot":"","sources":["../../src/interfaces/backblaze-service.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,46 @@
+import { BackblazeClient } from '../client/backblaze.client';
+import { BackblazeOptions } from '../interfaces/backblaze-credentials.interface';
+import type { CreateBucketOptions, ListBucketsResult } from '../interfaces/backblaze-service.interface';
+/** Bucket as returned by S3 ListBuckets (parsed XML). */
+export interface S3Bucket {
+    Name: string;
+    CreationDate?: string;
+}
+/** S3 ListBuckets response (ListAllMyBucketsResult). */
+export interface S3ListBucketsResponse {
+    ListAllMyBucketsResult?: {
+        Buckets?: {
+            Bucket?: S3Bucket | S3Bucket[];
+        };
+        Owner?: {
+            ID?: string;
+            DisplayName?: string;
+        };
+    };
+}
+export declare class BackblazeBucketService {
+    private readonly client;
+    constructor(client: BackblazeClient);
+    /**
+     * Lists all buckets. Returns a normalized result for easier consumption.
+     */
+    listBuckets(options?: BackblazeOptions): Promise<ListBucketsResult>;
+    /**
+     * Raw S3 List Buckets response (XML parsed to JSON). Use when you need the full structure.
+     */
+    listBucketsRaw(options?: BackblazeOptions): Promise<S3ListBucketsResponse>;
+    /**
+     * Creates a bucket. Use BucketAcl enum for the acl option.
+     */
+    createBucket(bucketName: string, options?: CreateBucketOptions): Promise<void>;
+    /**
+     * Deletes a bucket. The bucket must be empty.
+     */
+    deleteBucket(bucketName: string, options?: BackblazeOptions): Promise<void>;
+    /**
+     * Checks if a bucket exists (HEAD request). Throws if the bucket does not exist.
+     */
+    headBucket(bucketName: string, options?: BackblazeOptions): Promise<void>;
+    private normalizeListBucketsResponse;
+}
+//# sourceMappingURL=backblaze-bucket.service.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,107 @@
+"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.BackblazeBucketService = void 0;
+const common_1 = require("@nestjs/common");
+const backblaze_client_1 = require("../client/backblaze.client");
+const backblaze_client_constant_1 = require("../constants/backblaze-client.constant");
+const s3_xml_util_1 = require("../utils/s3-xml.util");
+let BackblazeBucketService = class BackblazeBucketService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Lists all buckets. Returns a normalized result for easier consumption.
+     */
+    listBuckets(options) {
+        return this.client
+            .request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.GET,
+            path: '/',
+            responseType: 'text',
+        })
+            .then((raw) => this.normalizeListBucketsResponse(raw));
+    }
+    /**
+     * Raw S3 List Buckets response (XML parsed to JSON). Use when you need the full structure.
+     */
+    listBucketsRaw(options) {
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.GET,
+            path: '/',
+            responseType: 'text',
+        });
+    }
+    /**
+     * Creates a bucket. Use BucketAcl enum for the acl option.
+     */
+    createBucket(bucketName, options) {
+        const 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;
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.PUT,
+            path: `/${encodeURIComponent(bucketName)}`,
+            body,
+            headers: Object.keys(headers).length ? headers : undefined,
+            responseType: 'text',
+        });
+    }
+    /**
+     * Deletes a bucket. The bucket must be empty.
+     */
+    deleteBucket(bucketName, options) {
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.DELETE,
+            path: `/${encodeURIComponent(bucketName)}`,
+            responseType: 'text',
+        });
+    }
+    /**
+     * Checks if a bucket exists (HEAD request). Throws if the bucket does not exist.
+     */
+    headBucket(bucketName, options) {
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.HEAD,
+            path: `/${encodeURIComponent(bucketName)}`,
+            responseType: 'text',
+        });
+    }
+    normalizeListBucketsResponse(raw) {
+        const result = raw?.ListAllMyBucketsResult;
+        const bucketOrList = result?.Buckets?.Bucket;
+        const buckets = Array.isArray(bucketOrList)
+            ? bucketOrList
+            : bucketOrList
+                ? [bucketOrList]
+                : [];
+        return {
+            buckets: buckets.map((b) => ({ name: b.Name, creationDate: b.CreationDate })),
+            owner: result?.Owner
+                ? { id: result.Owner.ID, displayName: result.Owner.DisplayName }
+                : undefined,
+        };
+    }
+};
+exports.BackblazeBucketService = BackblazeBucketService;
+exports.BackblazeBucketService = BackblazeBucketService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [backblaze_client_1.BackblazeClient])
+], BackblazeBucketService);
+//# sourceMappingURL=backblaze-bucket.service.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,56 @@
+import { BackblazeClient } from '../client/backblaze.client';
+import { BackblazeOptions } from '../interfaces/backblaze-credentials.interface';
+import type { DeleteObjectOptions, GetObjectOptions, HeadObjectOptions, ListObjectsV2Params, ListObjectsV2Result, PutObjectOptions } from '../interfaces/backblaze-service.interface';
+/** S3 object entry (ListObjectsV2). */
+export interface S3ObjectEntry {
+    Key?: string;
+    LastModified?: string;
+    ETag?: string;
+    Size?: number;
+    StorageClass?: string;
+}
+/** S3 ListObjectsV2 response (parsed XML). */
+export interface S3ListObjectsV2Response {
+    ListBucketResult?: {
+        Name?: string;
+        Prefix?: string;
+        MaxKeys?: number;
+        KeyCount?: number | string;
+        IsTruncated?: boolean | string;
+        ContinuationToken?: string;
+        NextContinuationToken?: string;
+        Contents?: S3ObjectEntry | S3ObjectEntry[];
+    };
+}
+export declare class BackblazeObjectService {
+    private readonly client;
+    constructor(client: BackblazeClient);
+    /**
+     * Uploads an object. Use ContentType enum for common types, or pass a custom string.
+     */
+    putObject(bucketName: string, key: string, body: Buffer | Uint8Array, options?: PutObjectOptions): Promise<void>;
+    /**
+     * Downloads an object. Returns the body as ArrayBuffer.
+     */
+    getObject(bucketName: string, key: string, options?: GetObjectOptions): Promise<ArrayBuffer>;
+    /**
+     * Deletes an object. Optionally specify versionId for versioned buckets.
+     */
+    deleteObject(bucketName: string, key: string, options?: DeleteObjectOptions): Promise<void>;
+    /**
+     * Lists objects in a bucket. Returns a normalized result for easier consumption.
+     * Use ListObjectsV2Params for prefix, maxKeys, pagination, etc.
+     */
+    listObjectsV2(bucketName: string, params?: ListObjectsV2Params, 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>;
+    /**
+     * Returns object metadata (Content-Length, Content-Type, ETag, etc.) in response headers.
+     */
+    headObject(bucketName: string, key: string, options?: HeadObjectOptions): Promise<Record<string, string>>;
+    private normalizeListObjectsV2Response;
+    private encodeKey;
+}
+//# sourceMappingURL=backblaze-object.service.d.ts.map

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

@@ -0,0 +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"}