@sanvika/cloudinary 0.1.3 → 0.1.4

package/dist/index.js

@@ -146,10 +146,17 @@ async function uploadImage(fileOrBuffer, options = {}) {
     folder,
     resourceType = "image",
     tags = [],
+    eager,
     transforms,
+    eagerAsync,
+    eagerNotificationUrl,
     publicId,
     overwrite = false,
-    notificationUrl
+    notificationUrl,
+    chunked,
+    chunkSize = 6 * 1024 * 1024,
+    timeout,
+    maxAttempts = 3
   } = options;
   const uploadFolder = getFolderPath(_appName, folder);
   const uploadOpts = {
@@ -159,22 +166,40 @@ async function uploadImage(fileOrBuffer, options = {}) {
     tags: [_appName, ...tags]
   };
   if (publicId) uploadOpts.public_id = publicId;
-  if (transforms) uploadOpts.eager = transforms;
+  const eagerValue = eager || transforms;
+  if (eagerValue) uploadOpts.eager = eagerValue;
+  if (eagerAsync) uploadOpts.eager_async = true;
+  if (eagerNotificationUrl) uploadOpts.eager_notification_url = eagerNotificationUrl;
   if (notificationUrl) uploadOpts.notification_url = notificationUrl;
+  if (timeout) uploadOpts.timeout = timeout;
+  const fileSize = Buffer.isBuffer(fileOrBuffer) ? fileOrBuffer.length : null;
+  const useChunked = chunked || resourceType === "video" && fileSize !== null && fileSize > 10 * 1024 * 1024;
+  if (useChunked) {
+    uploadOpts.chunk_size = chunkSize;
+  }
   return withRetry(
     () => {
       if (Buffer.isBuffer(fileOrBuffer)) {
         return new Promise((resolve, reject) => {
-          const stream = cloudinary.uploader.upload_stream(uploadOpts, (err, result) => {
+          const streamFactory = useChunked ? cloudinary.uploader.upload_chunked_stream : cloudinary.uploader.upload_stream;
+          const stream = streamFactory.call(cloudinary.uploader, uploadOpts, (err, result) => {
             if (err) return reject(err);
             resolve(result);
           });
           stream.end(fileOrBuffer);
         });
       }
+      if (useChunked) {
+        return new Promise((resolve, reject) => {
+          cloudinary.uploader.upload_large(fileOrBuffer, uploadOpts, (err, result) => {
+            if (err) return reject(err);
+            resolve(result);
+          });
+        });
+      }
       return cloudinary.uploader.upload(fileOrBuffer, uploadOpts);
     },
-    { operationName: "uploadImage", maxAttempts: 3 }
+    { operationName: "uploadImage", maxAttempts }
   );
 }
 async function uploadVideo(fileOrBuffer, options = {}) {
@@ -253,6 +278,94 @@ async function pingCloudinary() {
   ensureConfigured();
   return cloudinary.api.ping();
 }
+async function getCloudinaryUsage(options = {}) {
+  ensureConfigured();
+  const { resourceType } = options;
+  return cloudinary.api.usage(resourceType ? { resource_type: resourceType } : {});
+}
+function getCloudinarySdkVersion() {
+  return cloudinary.CLOUDINARY_VERSION;
+}
+
+// src/cloudinaryDiagnostics.js
+import crypto from "crypto";
+function testCloudinaryWebhookSignature(apiSecret, options = {}) {
+  try {
+    if (!apiSecret) {
+      return { success: false, error: "apiSecret is required" };
+    }
+    const testPayload = { test: "data", timestamp: Math.floor(Date.now() / 1e3) };
+    const testPayloadString = JSON.stringify(testPayload);
+    const testTimestamp = testPayload.timestamp.toString();
+    const signatureData = testTimestamp + testPayloadString;
+    const signature = crypto.createHmac("sha1", apiSecret).update(signatureData).digest("hex");
+    return {
+      success: true,
+      testPayload,
+      testTimestamp,
+      signature,
+      headers: {
+        "X-Cld-Timestamp": testTimestamp,
+        "X-Cld-Signature": signature
+      },
+      testEndpoint: options.testEndpoint || "/api/webhooks/cloudinary/debug"
+    };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+async function runCloudinaryDiagnostics(options = {}) {
+  const {
+    testWebhook = false,
+    webhookSecret,
+    testFolder = "diagnostics"
+  } = options;
+  const report = {
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    cloudinaryVersion: getCloudinarySdkVersion(),
+    nodeVersion: process.version,
+    configuration: {
+      cloudName: process.env.CLOUDINARY_CLOUD_NAME || process.env.CLOUDINARY_NAME ? "set" : "missing",
+      apiKey: process.env.CLOUDINARY_API_KEY ? "set" : "missing",
+      apiSecret: process.env.CLOUDINARY_API_SECRET ? "set" : "missing",
+      uploadPreset: process.env.CLOUDINARY_UPLOAD_PRESET ? "set" : "missing"
+    },
+    tests: {}
+  };
+  report.tests.ping = await pingCloudinary().then(
+    (result) => ({ success: true, result }),
+    (error) => ({ success: false, error: error.message })
+  );
+  const testBuffer = Buffer.from("Cloudinary diagnostic test");
+  report.tests.upload = await uploadImage(testBuffer, {
+    folder: testFolder,
+    resourceType: "raw",
+    tags: ["test", "diagnostics"],
+    publicId: `diagnostic_${Date.now()}`,
+    overwrite: true
+  }).then(
+    (result) => ({
+      success: true,
+      publicId: result.public_id,
+      url: result.secure_url,
+      bytes: result.bytes
+    }),
+    (error) => ({
+      success: false,
+      error: error.message,
+      httpCode: error.http_code,
+      name: error.name
+    })
+  );
+  report.tests.videoLimits = await getCloudinaryUsage({ resourceType: "video" }).then(
+    (result) => ({ success: true, result }),
+    (error) => ({ success: false, error: error.message })
+  );
+  if (testWebhook) {
+    report.tests.webhook = testCloudinaryWebhookSignature(webhookSecret);
+  }
+  return report;
+}
 export {
   CloudinaryError,
   TRANSFORM_PRESETS,
@@ -261,11 +374,15 @@ export {
   deleteImages,
   extractPublicId,
   getAppName,
+  getCloudinarySdkVersion,
+  getCloudinaryUsage,
   getFolderPath,
   getOptimizedUrl,
   isCloudinaryUrl,
   isRetriableError,
   pingCloudinary,
+  runCloudinaryDiagnostics,
+  testCloudinaryWebhookSignature,
   uploadImage,
   uploadImages,
   uploadRawFile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanvika/cloudinary",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Centralized Cloudinary SDK for the Sanvika ecosystem — upload, delete, transform, and manage media across 50+ projects",
   "type": "module",
   "main": "./dist/index.js",