b2b-platform-utils 1.1.26 → 1.1.28

package/fileSystem.js

@@ -1,5 +1,8 @@
 "use strict";
 
+const http = require("http");
+const https = require("https");
+
 /**
  * @module fileSystem
  * @description
@@ -299,6 +302,116 @@ function getAbsoluteMediaResourceUrl(service, instance, fileName) {
   return `${baseUrl}/file/${service}/${instance}/${fileName}`;
 }
 
+/**
+ * Download remote resource to Buffer or read local file to Buffer.
+ *
+ * @param {string} source - URL (http/https) or local file path.
+ * @param {Object} [options]
+ * @param {number} [options.timeoutMs=15000] - Request timeout.
+ * @param {number} [options.maxBytes=26214400] - Max allowed size in bytes (default 25MB).
+ * @param {number} [options.maxRedirects=3] - Max redirects to follow.
+ * @returns {Promise<Buffer>}
+ */
+function downloadToBuffer(source, options = {}) {
+  const timeoutMs = Number.isInteger(options.timeoutMs)
+    ? options.timeoutMs
+    : 15000;
+  const maxBytes = Number.isInteger(options.maxBytes)
+    ? options.maxBytes
+    : 25 * 1024 * 1024;
+  const maxRedirects = Number.isInteger(options.maxRedirects)
+    ? options.maxRedirects
+    : 3;
+
+  if (!source || typeof source !== "string") {
+    return Promise.reject(
+      new TypeError("downloadToBuffer: source must be a non-empty string")
+    );
+  }
+
+  const trimmed = source.trim();
+
+  if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+    return downloadHttpToBuffer(trimmed, { timeoutMs, maxBytes, maxRedirects });
+  }
+
+  const absPath = resolvePath(trimmed);
+  return fsPromises.readFile(absPath);
+}
+
+/**
+ * Download an HTTP/HTTPS resource to Buffer with basic redirect support.
+ *
+ * @param {string} url
+ * @param {Object} options
+ * @param {number} options.timeoutMs
+ * @param {number} options.maxBytes
+ * @param {number} options.maxRedirects
+ * @returns {Promise<Buffer>}
+ */
+function downloadHttpToBuffer(url, options) {
+  return new Promise((resolve, reject) => {
+    const client = url.startsWith("https://") ? https : http;
+
+    const req = client.get(url, (res) => {
+      const statusCode = res.statusCode || 0;
+
+      // Follow redirects
+      if (
+        statusCode >= 300 &&
+        statusCode < 400 &&
+        res.headers.location &&
+        options.maxRedirects > 0
+      ) {
+        res.resume();
+        const nextUrl = new URL(res.headers.location, url).toString();
+        return resolve(
+          downloadHttpToBuffer(nextUrl, {
+            ...options,
+            maxRedirects: options.maxRedirects - 1,
+          })
+        );
+      }
+
+      if (statusCode < 200 || statusCode >= 300) {
+        res.resume();
+        return reject(
+          new Error(
+            `downloadToBuffer: request failed with status ${statusCode}`
+          )
+        );
+      }
+
+      const chunks = [];
+      let received = 0;
+
+      res.on("data", (chunk) => {
+        received += chunk.length;
+        if (received > options.maxBytes) {
+          req.destroy(
+            new Error(
+              `downloadToBuffer: maxBytes exceeded (${options.maxBytes})`
+            )
+          );
+          return;
+        }
+        chunks.push(chunk);
+      });
+
+      res.on("end", () => resolve(Buffer.concat(chunks)));
+      res.on("error", reject);
+    });
+
+    req.setTimeout(options.timeoutMs, () => {
+      req.destroy(
+        new Error(`downloadToBuffer: timeout after ${options.timeoutMs}ms`)
+      );
+    });
+
+    req.on("error", reject);
+  });
+}
+
 // -----------------------------------------------------------------------------
 // Exports
 // -----------------------------------------------------------------------------
@@ -311,6 +424,7 @@ module.exports = {
   readJsonFile,
   removeFile,
   unlinkIfExists,
+  downloadToBuffer,
 
   // MIME helpers
   getImageExtension,

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "b2b-platform-utils",
-  "version": "1.1.26",
+  "version": "1.1.28",
   "description": "Shared utilities for Node.js microservices: errors map, local cache, logger, numbers, dates, filesystem, media optimization, paginator, slugger, crypto wrapper, sanitize HTML, sorting.",
   "type": "commonjs",
   "license": "KingSizer",
   "private": false,
+  "scripts": {
+    "publish-update": "npm version patch --no-git-tag-version && npm publish",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
   "files": [
     "*.js",
     "README.md"