manage-storage 0.0.3 → 0.0.4

package/README.md

@@ -13,7 +13,6 @@ Universal cloud storage manager supporting AWS S3, Cloudflare R2, and Backblaze
 - **Lightweight**: Built on aws-lite (not the bloated AWS SDK) for faster cold starts
 - **Simple API**: Single function interface for all storage operations
 - **No File System**: Returns data directly - perfect for serverless/edge environments
-- **TypeScript Ready**: Full type support with comprehensive type definitions
 
 ## Installation
 
@@ -44,6 +43,18 @@ const data = await manageStorage("download", {
 // List all files
 const files = await manageStorage("list");
 
+// Copy a file
+await manageStorage("copy", {
+  key: "documents/report.pdf",
+  destinationKey: "documents/report-backup.pdf",
+});
+
+// Rename a file (copy + delete)
+await manageStorage("rename", {
+  key: "documents/old-name.pdf",
+  destinationKey: "documents/new-name.pdf",
+});
+
 // Delete a file
 await manageStorage("delete", {
   key: "documents/report.pdf",
@@ -90,16 +101,17 @@ Performs storage operations on your configured cloud provider.
 
 #### Parameters
 
-- **action** `string` - The operation to perform: `'upload'`, `'download'`, `'delete'`, `'list'`, or `'deleteAll'`
+- **action** `string` - The operation to perform: `'upload'`, `'download'`, `'delete'`, `'list'`, `'deleteAll'`, `'copy'`, or `'rename'`
 - **options** `object` - Operation-specific options
 
 #### Options
 
-| Option     | Type                     | Required                            | Description                                          |
-| ---------- | ------------------------ | ----------------------------------- | ---------------------------------------------------- |
-| `key`      | `string`                 | Yes (except for `list`/`deleteAll`) | The object key/path                                  |
-| `body`     | `string\|Buffer\|Stream` | Yes (for `upload`)                  | The file content to upload                           |
-| `provider` | `'s3'\|'r2'\|'b2'`       | No                                  | Force a specific provider (auto-detected if omitted) |
+| Option           | Type                     | Required                            | Description                                          |
+| ---------------- | ------------------------ | ----------------------------------- | ---------------------------------------------------- |
+| `key`            | `string`                 | Yes (except for `list`/`deleteAll`) | The object key/path                                  |
+| `destinationKey` | `string`                 | Yes (for `copy`/`rename`)           | The destination key/path for copy/rename operations  |
+| `body`           | `string\|Buffer\|Stream` | Yes (for `upload`)                  | The file content to upload                           |
+| `provider`       | `'s3'\|'r2'\|'b2'`       | No                                  | Force a specific provider (auto-detected if omitted) |
 
 ## Usage Examples
 
@@ -156,7 +168,39 @@ const notes = files.filter((key) => key.startsWith("notes/"));
 console.log(notes); // ['notes/memo.txt']
 ```
 
-### 4. Delete Files
+### 4. Copy Files
+
+```javascript
+// Copy a file to a new location
+await manageStorage("copy", {
+  key: "documents/report.pdf",
+  destinationKey: "documents/backup/report-2024.pdf",
+});
+
+// Create a backup
+await manageStorage("copy", {
+  key: "config/settings.json",
+  destinationKey: "config/settings.backup.json",
+});
+```
+
+### 5. Rename Files
+
+```javascript
+// Rename a file (performs copy + delete)
+await manageStorage("rename", {
+  key: "old-filename.txt",
+  destinationKey: "new-filename.txt",
+});
+
+// Move to a different folder
+await manageStorage("rename", {
+  key: "temp/draft.md",
+  destinationKey: "published/article.md",
+});
+```
+
+### 6. Delete Files
 
 ```javascript
 // Delete a single file
@@ -169,7 +213,7 @@ const result = await manageStorage("deleteAll");
 console.log(`Deleted ${result.count} files`);
 ```
 
-### 5. Force a Specific Provider
+### 7. Force a Specific Provider
 
 ```javascript
 // Use R2 even if other providers are configured
@@ -187,7 +231,7 @@ await manageStorage("upload", {
 });
 ```
 
-### 6. Runtime Configuration (Override Environment Variables)
+### 8. Runtime Configuration (Override Environment Variables)
 
 ```javascript
 // Pass credentials at runtime instead of using env vars
@@ -242,7 +286,7 @@ export async function GET(req) {
 
 ```javascript
 import express from "express";
-import { manageStorage } from "@opensourceagi/cloud-storage";
+import { manageStorage } from "manage-storage";
 
 const app = express();
 app.use(express.json());
@@ -290,7 +334,7 @@ app.listen(3000, () => console.log("Server running on port 3000"));
 ### Cloudflare Workers
 
 ```javascript
-import { manageStorage } from "@opensourceagi/cloud-storage";
+import { manageStorage } from "manage-storage";
 
 export default {
   async fetch(request, env) {
@@ -383,6 +427,26 @@ const contents = await Promise.all(
 }
 ```
 
+### Copy
+
+```javascript
+{
+  success: true,
+  sourceKey: 'documents/report.pdf',
+  destinationKey: 'documents/backup/report-2024.pdf'
+}
+```
+
+### Rename
+
+```javascript
+{
+  success: true,
+  oldKey: 'old-filename.txt',
+  newKey: 'new-filename.txt'
+}
+```
+
 ## Why aws-lite?
 
 This library uses [@aws-lite](https://aws-lite.org/) instead of the official AWS SDK because:
@@ -393,11 +457,7 @@ This library uses [@aws-lite](https://aws-lite.org/) instead of the official AWS
 - **Modern API**: Clean, promise-based interface
 - **No dependencies overhead**: Minimal dependency tree
 
-# Cloud Object Storage Comparison: GCS, Backblaze B2, Cloudflare R2, and AWS S3
-
-Google Cloud Storage (GCS) joins Backblaze B2, Cloudflare R2, and AWS S3 as a hyperscaler option with [strong multi-region support](https://cloud.google.com/storage/pricing), multiple storage classes, and [deep integration with Google Cloud services](https://cloud.google.com/storage/pricing). These providers all [offer S3-compatible object storage](https://www.backblaze.com/cloud-storage/pricing) but differ significantly in [pricing models](https://www.backblaze.com/cloud-storage/pricing), especially storage costs, egress fees, and ecosystem fit.
-
-## Updated pricing snapshot ("hot"/Standard storage)
+# Cloud Object Storage Comparison
 
 | Service                                                         | Storage price (/TB-month)      | Egress to internet                                                                        | API ops (Class A/B per 1K, approx)                                                 | Minimum duration                                            | Notes                                                              |
 | --------------------------------------------------------------- | ------------------------------ | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------ |

package/dist/index.d.ts

@@ -1,7 +1,20 @@
 /**
  * Storage operation action type
  */
-export declare type Action = "upload" | "download" | "delete" | "list" | "deleteAll";
+export declare type Action = "upload" | "download" | "delete" | "list" | "deleteAll" | "copy" | "rename";
+
+/**
+ * Result from copy operation
+ */
+export declare interface CopyResult {
+    /** Whether the copy was successful */
+    success: boolean;
+    /** The source object key */
+    sourceKey: string;
+    /** The destination object key */
+    destinationKey: string;
+    [key: string]: any;
+}
 
 /**
  * Result from deleteAll operation
@@ -63,6 +76,20 @@ export declare interface DeleteResult {
  * });
  *
  * @example
+ * // Copy a file
+ * await manageStorage('copy', {
+ *   key: 'documents/report.pdf',
+ *   destinationKey: 'documents/report-copy.pdf'
+ * });
+ *
+ * @example
+ * // Rename a file (copy + delete)
+ * await manageStorage('rename', {
+ *   key: 'documents/old-name.pdf',
+ *   destinationKey: 'documents/new-name.pdf'
+ * });
+ *
+ * @example
  * // Force a specific provider with runtime credentials
  * await manageStorage('upload', {
  *   key: 'test.txt',
@@ -74,34 +101,61 @@ export declare interface DeleteResult {
  *   BUCKET_URL: 'https://account.r2.cloudflarestorage.com'
  * });
  */
-export declare function manageStorage(action: "upload", options: StorageOptions & {
+declare function manageStorage(action: "upload", options: StorageOptions & {
     key: string;
     body: string | Buffer | ReadableStream;
 }): Promise<UploadResult>;
 
-export declare function manageStorage(action: "download", options: StorageOptions & {
+declare function manageStorage(action: "download", options: StorageOptions & {
     key: string;
 }): Promise<string>;
 
-export declare function manageStorage(action: "delete", options: StorageOptions & {
+declare function manageStorage(action: "delete", options: StorageOptions & {
     key: string;
 }): Promise<DeleteResult>;
 
-export declare function manageStorage(action: "list", options?: StorageOptions): Promise<string[]>;
+declare function manageStorage(action: "list", options?: StorageOptions): Promise<string[]>;
+
+declare function manageStorage(action: "deleteAll", options?: StorageOptions): Promise<DeleteAllResult>;
+
+declare function manageStorage(action: "copy", options: StorageOptions & {
+    key: string;
+    destinationKey: string;
+}): Promise<CopyResult>;
 
-export declare function manageStorage(action: "deleteAll", options?: StorageOptions): Promise<DeleteAllResult>;
+declare function manageStorage(action: "rename", options: StorageOptions & {
+    key: string;
+    destinationKey: string;
+}): Promise<RenameResult>;
+export default manageStorage;
+export { manageStorage }
 
 /**
  * Cloud storage provider type
  */
 export declare type Provider = "s3" | "r2" | "b2";
 
+/**
+ * Result from rename operation
+ */
+export declare interface RenameResult {
+    /** Whether the rename was successful */
+    success: boolean;
+    /** The old object key */
+    oldKey: string;
+    /** The new object key */
+    newKey: string;
+    [key: string]: any;
+}
+
 /**
  * Options for storage operations
  */
 export declare interface StorageOptions {
     /** The object key/path (required for upload, download, delete) */
     key?: string;
+    /** The destination key/path (required for copy, rename) */
+    destinationKey?: string;
     /** The file content to upload (required for upload) */
     body?: string | Buffer | ReadableStream;
     /** Force a specific cloud provider (auto-detected if omitted) */

package/dist/index.js

@@ -1,79 +1,105 @@
-import $ from "@aws-lite/client";
-import y from "@aws-lite/s3";
-import { config as f } from "dotenv";
-f();
-async function w(o, s = {}) {
-  var _, i;
-  const { key: e, body: E, provider: d, ...K } = s, c = d || b(), A = Object.fromEntries(
-    Object.entries(K).map(([n, a]) => [`${c.toUpperCase()}_${n}`, a])
-  ), t = g(c, A);
+import b from "@aws-lite/client";
+import k from "@aws-lite/s3";
+import { config as w } from "dotenv";
+w();
+async function U(r, s = {}) {
+  var _, C;
+  const { key: e, body: a, destinationKey: o, provider: K, ...d } = s, u = K || B(), y = Object.fromEntries(
+    Object.entries(d).map(([n, l]) => [`${u.toUpperCase()}_${n}`, l])
+  ), t = f(u, y);
   if (!t.bucket || !t.accessKeyId || !t.secretAccessKey)
-    throw new Error(`Missing credentials for ${c}`);
-  const r = await $({
+    throw new Error(`Missing credentials for ${u}`);
+  const c = await b({
     region: t.region,
     endpoint: t.endpoint,
     accessKeyId: t.accessKeyId,
     secretAccessKey: t.secretAccessKey,
-    plugins: [y]
+    plugins: [k]
   });
   try {
-    switch (o) {
+    switch (r) {
       case "upload":
-        const n = await r.s3.PutObject({
+        const n = await c.s3.PutObject({
           Bucket: t.bucket,
           Key: e,
-          Body: E
+          Body: a
         });
-        return console.log(`Uploaded ${e} to ${c}`), { success: !0, key: e, ...n };
+        return { success: !0, key: e, ...n };
       case "download":
-        const a = await r.s3.GetObject({
+        return (await c.s3.GetObject({
           Bucket: t.bucket,
           Key: e
-        });
-        return console.log(`Downloaded ${e} from ${c}`), a.Body;
+        })).Body;
       case "delete":
-        const S = await r.s3.DeleteObject({
+        const p = await c.s3.DeleteObject({
           Bucket: t.bucket,
           Key: e
         });
-        return console.log(`Deleted ${e} from ${c}`), { success: !0, key: e, ...S };
+        return { success: !0, key: e, ...p };
       case "list":
-        const C = ((_ = (await r.s3.ListObjectsV2({
+        return ((_ = (await c.s3.ListObjectsV2({
           Bucket: t.bucket
-        })).Contents) == null ? void 0 : _.map((u) => u.Key)) || [];
-        return console.log(C.join(`
-`)), C;
+        })).Contents) == null ? void 0 : _.map((E) => E.Key)) || [];
       case "deleteAll":
-        const l = await r.s3.ListObjectsV2({
+        const i = await c.s3.ListObjectsV2({
           Bucket: t.bucket
         });
-        if ((i = l.Contents) != null && i.length) {
-          const u = await r.s3.DeleteObjects({
+        if ((C = i.Contents) != null && C.length) {
+          const E = await c.s3.DeleteObjects({
             Bucket: t.bucket,
             Delete: {
-              Objects: l.Contents.map((p) => ({ Key: p.Key }))
+              Objects: i.Contents.map((A) => ({
+                Key: A.Key
+              }))
             }
           });
-          return console.log(
-            `Deleted all ${l.Contents.length} files from ${c}`
-          ), {
+          return {
             success: !0,
-            count: l.Contents.length,
-            ...u
+            count: i.Contents.length,
+            ...E
           };
         } else
-          return console.log(`${c} bucket empty`), { success: !0, count: 0 };
+          return { success: !0, count: 0 };
+      case "copy":
+        if (!o)
+          throw new Error("destinationKey is required for copy operation");
+        const S = await c.s3.CopyObject({
+          Bucket: t.bucket,
+          CopySource: `${t.bucket}/${e}`,
+          Key: o
+        });
+        return {
+          success: !0,
+          sourceKey: e,
+          destinationKey: o,
+          ...S
+        };
+      case "rename":
+        if (!o)
+          throw new Error("destinationKey is required for rename operation");
+        return await c.s3.CopyObject({
+          Bucket: t.bucket,
+          CopySource: `${t.bucket}/${e}`,
+          Key: o
+        }), await c.s3.DeleteObject({
+          Bucket: t.bucket,
+          Key: e
+        }), {
+          success: !0,
+          oldKey: e,
+          newKey: o
+        };
       default:
         throw new Error(
-          "Invalid action: upload, download, delete, list, deleteAll"
+          "Invalid action: upload, download, delete, list, deleteAll, copy, rename"
         );
     }
   } catch (n) {
-    throw console.error(`Error in ${c}:`, n.message), n;
+    throw console.error(`Error in ${u}:`, n.message), n;
   }
 }
-function b() {
-  const o = {
+function B() {
+  const r = {
     r2: [
       "R2_BUCKET_NAME",
       "R2_ACCESS_KEY_ID",
@@ -93,15 +119,15 @@ function b() {
       "S3_BUCKET_URL"
     ]
   };
-  for (const [s, e] of Object.entries(o))
-    if (e.every((E) => process.env[E]))
+  for (const [s, e] of Object.entries(r))
+    if (e.every((a) => process.env[a]))
       return s;
   return "r2";
 }
-function g(o, s = {}) {
-  const e = o.toUpperCase() + "_";
+function f(r, s = {}) {
+  const e = r.toUpperCase() + "_";
   return {
-    region: o === "s3" ? s.awsRegion || process.env.S3_REGION || "us-east-1" : "auto",
+    region: r === "s3" ? s.awsRegion || process.env.S3_REGION || "us-east-1" : "auto",
     endpoint: s[`${e}BUCKET_URL`] || process.env[`${e}BUCKET_URL`] || "",
     bucket: s[`${e}BUCKET_NAME`] || process.env[`${e}BUCKET_NAME`] || "",
     accessKeyId: s[`${e}ACCESS_KEY_ID`] || s[`${e}APPLICATION_KEY_ID`] || process.env[`${e}ACCESS_KEY_ID`] || process.env[`${e}APPLICATION_KEY_ID`] || "",
@@ -109,5 +135,6 @@ function g(o, s = {}) {
   };
 }
 export {
-  w as manageStorage
+  U as default,
+  U as manageStorage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "manage-storage",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Storage manager supporting AWS S3, Cloudflare R2, and Backblaze B2 with automatic provider detection",
   "main": "./dist/index.js",
   "module": "./dist/index.js",