@venturialstd/backblaze 0.0.1

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

@@ -0,0 +1,165 @@
+"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.BackblazeObjectService = 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 backblaze_enums_1 = require("../enums/backblaze.enums");
+let BackblazeObjectService = class BackblazeObjectService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Uploads an object. Use ContentType enum for common types, or pass a custom string.
+     */
+    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)}`;
+        const headers = {
+            'Content-Length': String(buf.length),
+            'Content-Type': contentType,
+        };
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.PUT,
+            path,
+            body: buf,
+            headers,
+            responseType: 'text',
+        });
+    }
+    /**
+     * Downloads an object. Returns the body as ArrayBuffer.
+     */
+    getObject(bucketName, key, options) {
+        let path = `/${encodeURIComponent(bucketName)}/${this.encodeKey(key)}`;
+        if (options?.versionId) {
+            path += `?versionId=${encodeURIComponent(options.versionId)}`;
+        }
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.GET,
+            path,
+            responseType: 'arraybuffer',
+        });
+    }
+    /**
+     * Deletes an object. 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)}`;
+        }
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.DELETE,
+            path,
+            responseType: 'text',
+        });
+    }
+    /**
+     * Lists objects in a bucket. Returns a normalized result for easier consumption.
+     * Use ListObjectsV2Params for prefix, maxKeys, pagination, etc.
+     */
+    listObjectsV2(bucketName, params, 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()}`;
+        return this.client
+            .request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.GET,
+            path,
+            responseType: 'text',
+        })
+            .then((raw) => this.normalizeListObjectsV2Response(raw));
+    }
+    /**
+     * Raw S3 List Objects V2 response (XML parsed to JSON). Use when you need the full structure.
+     */
+    listObjectsV2Raw(bucketName, params, 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()}`;
+        return this.client.request({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.GET,
+            path,
+            responseType: 'text',
+        });
+    }
+    /**
+     * Returns object metadata (Content-Length, Content-Type, ETag, etc.) in response headers.
+     */
+    async headObject(bucketName, key, options) {
+        let path = `/${encodeURIComponent(bucketName)}/${this.encodeKey(key)}`;
+        if (options?.versionId) {
+            path += `?versionId=${encodeURIComponent(options.versionId)}`;
+        }
+        const res = await this.client.requestWithResponse({
+            options,
+            method: backblaze_client_constant_1.BACKBLAZE_HTTP_METHOD.HEAD,
+            path,
+            responseType: 'text',
+        });
+        return res.headers;
+    }
+    normalizeListObjectsV2Response(raw) {
+        const result = raw?.ListBucketResult;
+        const contents = result?.Contents;
+        const list = Array.isArray(contents) ? contents : contents ? [contents] : [];
+        return {
+            objects: list.map((c) => ({
+                key: c.Key,
+                lastModified: c.LastModified,
+                etag: c.ETag,
+                size: c.Size,
+                storageClass: c.StorageClass,
+            })),
+            isTruncated: result?.IsTruncated === true || result?.IsTruncated === 'true',
+            keyCount: typeof result?.KeyCount === 'string' ? parseInt(result.KeyCount, 10) : (result?.KeyCount ?? 0),
+            nextContinuationToken: result?.NextContinuationToken,
+            prefix: result?.Prefix,
+        };
+    }
+    encodeKey(key) {
+        return key
+            .split('/')
+            .map((segment) => encodeURIComponent(segment))
+            .join('/');
+    }
+};
+exports.BackblazeObjectService = BackblazeObjectService;
+exports.BackblazeObjectService = BackblazeObjectService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [backblaze_client_1.BackblazeClient])
+], BackblazeObjectService);
+//# sourceMappingURL=backblaze-object.service.js.map

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

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

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

@@ -0,0 +1,3 @@
+import { Settings } from '@venturialstd/core';
+export declare const BACKBLAZE_SETTINGS: Omit<Settings, 'id' | 'createdAt' | 'updatedAt'>[];
+//# sourceMappingURL=backblaze.settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.settings.d.ts","sourceRoot":"","sources":["../../src/settings/backblaze.settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,oBAAoB,CAAC;AAE7D,eAAO,MAAM,kBAAkB,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,EAqChF,CAAC"}

package/dist/settings/backblaze.settings.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKBLAZE_SETTINGS = void 0;
+const core_1 = require("@venturialstd/core");
+exports.BACKBLAZE_SETTINGS = [
+    {
+        scope: 'GLOBAL',
+        module: 'BACKBLAZE',
+        section: 'GENERAL',
+        key: 'REGION',
+        label: 'Backblaze B2 Region (S3 endpoint)',
+        description: 'Region for S3-compatible endpoint (e.g. us-west-004)',
+        type: core_1.SETTINGS_TYPE.TEXT,
+        value: 'us-west-004',
+        options: null,
+        sortOrder: 1,
+    },
+    {
+        scope: 'GLOBAL',
+        module: 'BACKBLAZE',
+        section: 'GENERAL',
+        key: 'ACCESS_KEY_ID',
+        label: 'Backblaze Application Key ID',
+        description: 'S3-compatible Application Key ID',
+        type: core_1.SETTINGS_TYPE.SECRET,
+        value: '',
+        options: null,
+        sortOrder: 2,
+    },
+    {
+        scope: 'GLOBAL',
+        module: 'BACKBLAZE',
+        section: 'GENERAL',
+        key: 'SECRET_ACCESS_KEY',
+        label: 'Backblaze Application Key',
+        description: 'S3-compatible Application Key secret',
+        type: core_1.SETTINGS_TYPE.SECRET,
+        value: '',
+        options: null,
+        sortOrder: 3,
+    },
+];
+//# sourceMappingURL=backblaze.settings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.settings.js","sourceRoot":"","sources":["../../src/settings/backblaze.settings.ts"],"names":[],"mappings":";;;AAAA,6CAA6D;AAEhD,QAAA,kBAAkB,GAAuD;IACpF;QACE,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EAAE,sDAAsD;QACnE,IAAI,EAAE,oBAAa,CAAC,IAAI;QACxB,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;KACb;IACD;QACE,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,kCAAkC;QAC/C,IAAI,EAAE,oBAAa,CAAC,MAAM;QAC1B,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;KACb;IACD;QACE,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,sCAAsC;QACnD,IAAI,EAAE,oBAAa,CAAC,MAAM;QAC1B,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC;KACb;CACF,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Parses S3 response XML (ListBuckets, ListObjects, etc.) to JSON.
+ */
+export declare function parseXmlToJson(xml: string): Record<string, unknown>;
+/** Standard S3 namespace for bucket creation XML. */
+export declare const S3_XML_NS = "http://s3.amazonaws.com/doc/2006-03-01/";
+/**
+ * Builds the XML body for CreateBucketConfiguration (optional in Backblaze).
+ */
+export declare function createBucketConfigurationXml(region: string): string;
+//# sourceMappingURL=s3-xml.util.d.ts.map

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

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

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3_XML_NS = void 0;
+exports.parseXmlToJson = parseXmlToJson;
+exports.createBucketConfigurationXml = createBucketConfigurationXml;
+const fast_xml_parser_1 = require("fast-xml-parser");
+const parser = new fast_xml_parser_1.XMLParser({
+    ignoreDeclaration: true,
+    removeNSPrefix: true,
+    trimValues: true,
+    parseTagValue: false,
+});
+/**
+ * Parses S3 response XML (ListBuckets, ListObjects, etc.) to JSON.
+ */
+function parseXmlToJson(xml) {
+    const result = parser.parse(xml);
+    return (result && typeof result === 'object' ? result : {});
+}
+/** Standard S3 namespace for bucket creation XML. */
+exports.S3_XML_NS = 'http://s3.amazonaws.com/doc/2006-03-01/';
+/**
+ * Builds the XML body for CreateBucketConfiguration (optional in Backblaze).
+ */
+function createBucketConfigurationXml(region) {
+    return `<?xml version="1.0" encoding="UTF-8"?><CreateBucketConfiguration xmlns="${exports.S3_XML_NS}"><LocationConstraint>${escapeXml(region)}</LocationConstraint></CreateBucketConfiguration>`;
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=s3-xml.util.js.map

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

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@venturialstd/backblaze",
+  "version": "0.0.1",
+  "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"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prebuild": "rimraf dist",
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "build:pack": "rimraf *.tgz && npm run build && npm pack",
+    "release:patch": "npm run build && npm version patch --no-git-tag-version && npm publish"
+  },
+  "devDependencies": {
+    "@types/aws4": "^1.11.6",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@nestjs/axios": "^4.0.0",
+    "@nestjs/common": "^11.0.11",
+    "@nestjs/core": "^11.0.5",
+    "@venturialstd/core": "^1.0.16",
+    "class-validator": "^0.14.1",
+    "rxjs": "^7.8.1"
+  },
+  "dependencies": {
+    "aws4": "^1.11.0",
+    "fast-xml-parser": "^4.3.6"
+  }
+}