@plasius/storage 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -20,6 +20,34 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 - **Security**
   - (placeholder)
 
+## [1.0.2] - 2026-02-22
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [1.0.1] - 2026-02-13
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - Replace dual-`tsc` build steps with `tsup` to emit ESM + CJS + types side-by-side in `dist/` (`index.js`, `index.cjs`, `index.d.ts`).
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [1.0.0] - 2026-02-12
 
 - **Added**
@@ -48,7 +76,7 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 
 ---
 
-[Unreleased]: https://github.com/Plasius-LTD/storage/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/Plasius-LTD/storage/compare/v1.0.2...HEAD
 
 ## [1.0.0] - 2026-02-11
 
@@ -64,3 +92,5 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 - **Security**
   - (placeholder)
 [1.0.0]: https://github.com/Plasius-LTD/storage/releases/tag/v1.0.0
+[1.0.1]: https://github.com/Plasius-LTD/storage/releases/tag/v1.0.1
+[1.0.2]: https://github.com/Plasius-LTD/storage/releases/tag/v1.0.2

package/dist/index.cjs

@@ -0,0 +1,100 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  uploadUserImageShare: () => uploadUserImageShare
+});
+module.exports = __toCommonJS(index_exports);
+var import_storage_file_share = require("@azure/storage-file-share");
+async function uploadUserImageShare(userId, version, buffer, contentType, options = {}) {
+  if (!process.env.AZURE_STORAGE_CONNECTION_STRING) {
+    throw new Error(
+      "AZURE_STORAGE_CONNECTION_STRING is not set in environment variables."
+    );
+  }
+  if (!userId || typeof userId !== "string") {
+    throw new Error("userId is required and must be a string.");
+  }
+  if (typeof version !== "number" || isNaN(version)) {
+    throw new Error("version is required and must be a number.");
+  }
+  if (!buffer || !(buffer instanceof Buffer)) {
+    throw new Error("buffer is required and must be a Buffer.");
+  }
+  if (!contentType || typeof contentType !== "string") {
+    throw new Error("contentType is required and must be a string.");
+  }
+  const maxRetries = options.maxRetries ?? 3;
+  const baseDelayMs = options.baseDelayMs ?? 500;
+  const shareName = "avatars";
+  const directoryName = userId;
+  const fileName = `${version}.jpg`;
+  const serviceClient = import_storage_file_share.ShareServiceClient.fromConnectionString(
+    process.env.AZURE_STORAGE_CONNECTION_STRING
+  );
+  const shareClient = serviceClient.getShareClient(shareName);
+  const directoryClient = shareClient.getDirectoryClient(directoryName);
+  const fileClient = directoryClient.getFileClient(fileName);
+  let attempt = 0;
+  let lastError = null;
+  while (attempt < maxRetries) {
+    try {
+      await shareClient.createIfNotExists();
+      await directoryClient.createIfNotExists();
+      await fileClient.create(buffer.length, {
+        fileHttpHeaders: { fileContentType: contentType }
+      });
+      await fileClient.uploadRange(buffer, 0, buffer.length);
+      return fileClient.url;
+    } catch (err) {
+      lastError = err;
+      if (err && typeof err === "object" && "message" in err && typeof err.message === "string") {
+        console.error(
+          `Attempt ${attempt + 1} to upload user image failed: ${err.message}`
+        );
+      } else {
+        console.error(
+          `Attempt ${attempt + 1} to upload user image failed:`,
+          err
+        );
+      }
+      if (attempt < maxRetries - 1) {
+        const baseDelay = Math.pow(2, attempt) * baseDelayMs;
+        const jitter = Math.random() * baseDelay;
+        const delay = baseDelay / 2 + jitter;
+        console.warn(
+          `Backing off for ${Math.round(delay)} ms before retrying...`
+        );
+        await new Promise((res) => setTimeout(res, delay));
+      }
+    }
+    attempt++;
+  }
+  const lastErrorMsg = lastError && typeof lastError === "object" && "message" in lastError && typeof lastError.message === "string" ? lastError.message : String(lastError ?? "");
+  throw new Error(
+    `Failed to upload user image after ${maxRetries} attempts: ${lastErrorMsg}`
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  uploadUserImageShare
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { ShareServiceClient } from \"@azure/storage-file-share\";\n\ninterface UploadOptions {\n  maxRetries?: number;\n  baseDelayMs?: number;\n}\n\n/**\n * Uploads a user image to Azure File Share storage with retries and error handling.\n * @param userId - The user's ID (used as directory name)\n * @param version - The version number (used as file name)\n * @param buffer - The file data as a Buffer\n * @param contentType - The MIME type of the file\n * @param options - Optional settings for retries and backoff\n * @returns URL to the uploaded file\n */\nexport async function uploadUserImageShare(\n  userId: string,\n  version: number,\n  buffer: Buffer,\n  contentType: string,\n  options: UploadOptions = {}\n): Promise<string> {\n  // Parameter validation\n  if (!process.env.AZURE_STORAGE_CONNECTION_STRING) {\n    throw new Error(\n      \"AZURE_STORAGE_CONNECTION_STRING is not set in environment variables.\"\n    );\n  }\n  if (!userId || typeof userId !== \"string\") {\n    throw new Error(\"userId is required and must be a string.\");\n  }\n  if (typeof version !== \"number\" || isNaN(version)) {\n    throw new Error(\"version is required and must be a number.\");\n  }\n  if (!buffer || !(buffer instanceof Buffer)) {\n    throw new Error(\"buffer is required and must be a Buffer.\");\n  }\n  if (!contentType || typeof contentType !== \"string\") {\n    throw new Error(\"contentType is required and must be a string.\");\n  }\n\n  const maxRetries = options.maxRetries ?? 3;\n  const baseDelayMs = options.baseDelayMs ?? 500;\n\n  const shareName = \"avatars\";\n  const directoryName = userId;\n  const fileName = `${version}.jpg`;\n\n  const serviceClient = ShareServiceClient.fromConnectionString(\n    process.env.AZURE_STORAGE_CONNECTION_STRING\n  );\n  const shareClient = serviceClient.getShareClient(shareName);\n  const directoryClient = shareClient.getDirectoryClient(directoryName);\n  const fileClient = directoryClient.getFileClient(fileName);\n\n  // Retry logic with exponential backoff\n  let attempt = 0;\n  let lastError: unknown = null;\n  while (attempt < maxRetries) {\n    try {\n      // Ensure share exists\n      await shareClient.createIfNotExists();\n      // Ensure directory exists\n      await directoryClient.createIfNotExists();\n      // Create file (set size)\n      await fileClient.create(buffer.length, {\n        fileHttpHeaders: { fileContentType: contentType },\n      });\n      // Upload content\n      await fileClient.uploadRange(buffer, 0, buffer.length);\n      // Return file URL\n      return fileClient.url;\n    } catch (err: unknown) {\n      lastError = err;\n      if (\n        err &&\n        typeof err === \"object\" &&\n        \"message\" in err &&\n        typeof (err as { message: unknown }).message === \"string\"\n      ) {\n        console.error(\n          `Attempt ${attempt + 1} to upload user image failed: ${\n            (err as { message: string }).message\n          }`\n        );\n      } else {\n        console.error(\n          `Attempt ${attempt + 1} to upload user image failed:`,\n          err\n        );\n      }\n      // Exponential backoff with jitter\n      if (attempt < maxRetries - 1) {\n        const baseDelay = Math.pow(2, attempt) * baseDelayMs;\n        const jitter = Math.random() * baseDelay;\n        const delay = baseDelay / 2 + jitter; // Between 0.5x and 1.5x base delay\n        console.warn(\n          `Backing off for ${Math.round(delay)} ms before retrying...`\n        );\n        await new Promise((res) => setTimeout(res, delay));\n      }\n    }\n    attempt++;\n  }\n  const lastErrorMsg =\n    lastError &&\n    typeof lastError === \"object\" &&\n    \"message\" in lastError &&\n    typeof (lastError as { message: unknown }).message === \"string\"\n      ? (lastError as { message: string }).message\n      : String((lastError as Error) ?? \"\");\n  throw new Error(\n    `Failed to upload user image after ${maxRetries} attempts: ${lastErrorMsg}`\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gCAAmC;AAgBnC,eAAsB,qBACpB,QACA,SACA,QACA,aACA,UAAyB,CAAC,GACT;AAEjB,MAAI,CAAC,QAAQ,IAAI,iCAAiC;AAChD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AACA,MAAI,OAAO,YAAY,YAAY,MAAM,OAAO,GAAG;AACjD,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AACA,MAAI,CAAC,UAAU,EAAE,kBAAkB,SAAS;AAC1C,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AACA,MAAI,CAAC,eAAe,OAAO,gBAAgB,UAAU;AACnD,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACjE;AAEA,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,cAAc,QAAQ,eAAe;AAE3C,QAAM,YAAY;AAClB,QAAM,gBAAgB;AACtB,QAAM,WAAW,GAAG,OAAO;AAE3B,QAAM,gBAAgB,6CAAmB;AAAA,IACvC,QAAQ,IAAI;AAAA,EACd;AACA,QAAM,cAAc,cAAc,eAAe,SAAS;AAC1D,QAAM,kBAAkB,YAAY,mBAAmB,aAAa;AACpE,QAAM,aAAa,gBAAgB,cAAc,QAAQ;AAGzD,MAAI,UAAU;AACd,MAAI,YAAqB;AACzB,SAAO,UAAU,YAAY;AAC3B,QAAI;AAEF,YAAM,YAAY,kBAAkB;AAEpC,YAAM,gBAAgB,kBAAkB;AAExC,YAAM,WAAW,OAAO,OAAO,QAAQ;AAAA,QACrC,iBAAiB,EAAE,iBAAiB,YAAY;AAAA,MAClD,CAAC;AAED,YAAM,WAAW,YAAY,QAAQ,GAAG,OAAO,MAAM;AAErD,aAAO,WAAW;AAAA,IACpB,SAAS,KAAc;AACrB,kBAAY;AACZ,UACE,OACA,OAAO,QAAQ,YACf,aAAa,OACb,OAAQ,IAA6B,YAAY,UACjD;AACA,gBAAQ;AAAA,UACN,WAAW,UAAU,CAAC,iCACnB,IAA4B,OAC/B;AAAA,QACF;AAAA,MACF,OAAO;AACL,gBAAQ;AAAA,UACN,WAAW,UAAU,CAAC;AAAA,UACtB;AAAA,QACF;AAAA,MACF;AAEA,UAAI,UAAU,aAAa,GAAG;AAC5B,cAAM,YAAY,KAAK,IAAI,GAAG,OAAO,IAAI;AACzC,cAAM,SAAS,KAAK,OAAO,IAAI;AAC/B,cAAM,QAAQ,YAAY,IAAI;AAC9B,gBAAQ;AAAA,UACN,mBAAmB,KAAK,MAAM,KAAK,CAAC;AAAA,QACtC;AACA,cAAM,IAAI,QAAQ,CAAC,QAAQ,WAAW,KAAK,KAAK,CAAC;AAAA,MACnD;AAAA,IACF;AACA;AAAA,EACF;AACA,QAAM,eACJ,aACA,OAAO,cAAc,YACrB,aAAa,aACb,OAAQ,UAAmC,YAAY,WAClD,UAAkC,UACnC,OAAQ,aAAuB,EAAE;AACvC,QAAM,IAAI;AAAA,IACR,qCAAqC,UAAU,cAAc,YAAY;AAAA,EAC3E;AACF;","names":[]}

package/{dist-cjs/index.d.ts → dist/index.d.cts}

@@ -11,6 +11,6 @@ interface UploadOptions {
  * @param options - Optional settings for retries and backoff
  * @returns URL to the uploaded file
  */
-export declare function uploadUserImageShare(userId: string, version: number, buffer: Buffer, contentType: string, options?: UploadOptions): Promise<string>;
-export {};
-//# sourceMappingURL=index.d.ts.map
+declare function uploadUserImageShare(userId: string, version: number, buffer: Buffer, contentType: string, options?: UploadOptions): Promise<string>;
+
+export { uploadUserImageShare };

package/dist/index.d.ts

@@ -11,6 +11,6 @@ interface UploadOptions {
  * @param options - Optional settings for retries and backoff
  * @returns URL to the uploaded file
  */
-export declare function uploadUserImageShare(userId: string, version: number, buffer: Buffer, contentType: string, options?: UploadOptions): Promise<string>;
-export {};
-//# sourceMappingURL=index.d.ts.map
+declare function uploadUserImageShare(userId: string, version: number, buffer: Buffer, contentType: string, options?: UploadOptions): Promise<string>;
+
+export { uploadUserImageShare };

package/dist/index.js

@@ -1,84 +1,75 @@
+// src/index.ts
 import { ShareServiceClient } from "@azure/storage-file-share";
-/**
- * Uploads a user image to Azure File Share storage with retries and error handling.
- * @param userId - The user's ID (used as directory name)
- * @param version - The version number (used as file name)
- * @param buffer - The file data as a Buffer
- * @param contentType - The MIME type of the file
- * @param options - Optional settings for retries and backoff
- * @returns URL to the uploaded file
- */
-export async function uploadUserImageShare(userId, version, buffer, contentType, options = {}) {
-    // Parameter validation
-    if (!process.env.AZURE_STORAGE_CONNECTION_STRING) {
-        throw new Error("AZURE_STORAGE_CONNECTION_STRING is not set in environment variables.");
+async function uploadUserImageShare(userId, version, buffer, contentType, options = {}) {
+  if (!process.env.AZURE_STORAGE_CONNECTION_STRING) {
+    throw new Error(
+      "AZURE_STORAGE_CONNECTION_STRING is not set in environment variables."
+    );
+  }
+  if (!userId || typeof userId !== "string") {
+    throw new Error("userId is required and must be a string.");
+  }
+  if (typeof version !== "number" || isNaN(version)) {
+    throw new Error("version is required and must be a number.");
+  }
+  if (!buffer || !(buffer instanceof Buffer)) {
+    throw new Error("buffer is required and must be a Buffer.");
+  }
+  if (!contentType || typeof contentType !== "string") {
+    throw new Error("contentType is required and must be a string.");
+  }
+  const maxRetries = options.maxRetries ?? 3;
+  const baseDelayMs = options.baseDelayMs ?? 500;
+  const shareName = "avatars";
+  const directoryName = userId;
+  const fileName = `${version}.jpg`;
+  const serviceClient = ShareServiceClient.fromConnectionString(
+    process.env.AZURE_STORAGE_CONNECTION_STRING
+  );
+  const shareClient = serviceClient.getShareClient(shareName);
+  const directoryClient = shareClient.getDirectoryClient(directoryName);
+  const fileClient = directoryClient.getFileClient(fileName);
+  let attempt = 0;
+  let lastError = null;
+  while (attempt < maxRetries) {
+    try {
+      await shareClient.createIfNotExists();
+      await directoryClient.createIfNotExists();
+      await fileClient.create(buffer.length, {
+        fileHttpHeaders: { fileContentType: contentType }
+      });
+      await fileClient.uploadRange(buffer, 0, buffer.length);
+      return fileClient.url;
+    } catch (err) {
+      lastError = err;
+      if (err && typeof err === "object" && "message" in err && typeof err.message === "string") {
+        console.error(
+          `Attempt ${attempt + 1} to upload user image failed: ${err.message}`
+        );
+      } else {
+        console.error(
+          `Attempt ${attempt + 1} to upload user image failed:`,
+          err
+        );
+      }
+      if (attempt < maxRetries - 1) {
+        const baseDelay = Math.pow(2, attempt) * baseDelayMs;
+        const jitter = Math.random() * baseDelay;
+        const delay = baseDelay / 2 + jitter;
+        console.warn(
+          `Backing off for ${Math.round(delay)} ms before retrying...`
+        );
+        await new Promise((res) => setTimeout(res, delay));
+      }
     }
-    if (!userId || typeof userId !== "string") {
-        throw new Error("userId is required and must be a string.");
-    }
-    if (typeof version !== "number" || isNaN(version)) {
-        throw new Error("version is required and must be a number.");
-    }
-    if (!buffer || !(buffer instanceof Buffer)) {
-        throw new Error("buffer is required and must be a Buffer.");
-    }
-    if (!contentType || typeof contentType !== "string") {
-        throw new Error("contentType is required and must be a string.");
-    }
-    const maxRetries = options.maxRetries ?? 3;
-    const baseDelayMs = options.baseDelayMs ?? 500;
-    const shareName = "avatars";
-    const directoryName = userId;
-    const fileName = `${version}.jpg`;
-    const serviceClient = ShareServiceClient.fromConnectionString(process.env.AZURE_STORAGE_CONNECTION_STRING);
-    const shareClient = serviceClient.getShareClient(shareName);
-    const directoryClient = shareClient.getDirectoryClient(directoryName);
-    const fileClient = directoryClient.getFileClient(fileName);
-    // Retry logic with exponential backoff
-    let attempt = 0;
-    let lastError = null;
-    while (attempt < maxRetries) {
-        try {
-            // Ensure share exists
-            await shareClient.createIfNotExists();
-            // Ensure directory exists
-            await directoryClient.createIfNotExists();
-            // Create file (set size)
-            await fileClient.create(buffer.length, {
-                fileHttpHeaders: { fileContentType: contentType },
-            });
-            // Upload content
-            await fileClient.uploadRange(buffer, 0, buffer.length);
-            // Return file URL
-            return fileClient.url;
-        }
-        catch (err) {
-            lastError = err;
-            if (err &&
-                typeof err === "object" &&
-                "message" in err &&
-                typeof err.message === "string") {
-                console.error(`Attempt ${attempt + 1} to upload user image failed: ${err.message}`);
-            }
-            else {
-                console.error(`Attempt ${attempt + 1} to upload user image failed:`, err);
-            }
-            // Exponential backoff with jitter
-            if (attempt < maxRetries - 1) {
-                const baseDelay = Math.pow(2, attempt) * baseDelayMs;
-                const jitter = Math.random() * baseDelay;
-                const delay = baseDelay / 2 + jitter; // Between 0.5x and 1.5x base delay
-                console.warn(`Backing off for ${Math.round(delay)} ms before retrying...`);
-                await new Promise((res) => setTimeout(res, delay));
-            }
-        }
-        attempt++;
-    }
-    const lastErrorMsg = lastError &&
-        typeof lastError === "object" &&
-        "message" in lastError &&
-        typeof lastError.message === "string"
-        ? lastError.message
-        : String(lastError ?? "");
-    throw new Error(`Failed to upload user image after ${maxRetries} attempts: ${lastErrorMsg}`);
+    attempt++;
+  }
+  const lastErrorMsg = lastError && typeof lastError === "object" && "message" in lastError && typeof lastError.message === "string" ? lastError.message : String(lastError ?? "");
+  throw new Error(
+    `Failed to upload user image after ${maxRetries} attempts: ${lastErrorMsg}`
+  );
 }
+export {
+  uploadUserImageShare
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { ShareServiceClient } from \"@azure/storage-file-share\";\n\ninterface UploadOptions {\n  maxRetries?: number;\n  baseDelayMs?: number;\n}\n\n/**\n * Uploads a user image to Azure File Share storage with retries and error handling.\n * @param userId - The user's ID (used as directory name)\n * @param version - The version number (used as file name)\n * @param buffer - The file data as a Buffer\n * @param contentType - The MIME type of the file\n * @param options - Optional settings for retries and backoff\n * @returns URL to the uploaded file\n */\nexport async function uploadUserImageShare(\n  userId: string,\n  version: number,\n  buffer: Buffer,\n  contentType: string,\n  options: UploadOptions = {}\n): Promise<string> {\n  // Parameter validation\n  if (!process.env.AZURE_STORAGE_CONNECTION_STRING) {\n    throw new Error(\n      \"AZURE_STORAGE_CONNECTION_STRING is not set in environment variables.\"\n    );\n  }\n  if (!userId || typeof userId !== \"string\") {\n    throw new Error(\"userId is required and must be a string.\");\n  }\n  if (typeof version !== \"number\" || isNaN(version)) {\n    throw new Error(\"version is required and must be a number.\");\n  }\n  if (!buffer || !(buffer instanceof Buffer)) {\n    throw new Error(\"buffer is required and must be a Buffer.\");\n  }\n  if (!contentType || typeof contentType !== \"string\") {\n    throw new Error(\"contentType is required and must be a string.\");\n  }\n\n  const maxRetries = options.maxRetries ?? 3;\n  const baseDelayMs = options.baseDelayMs ?? 500;\n\n  const shareName = \"avatars\";\n  const directoryName = userId;\n  const fileName = `${version}.jpg`;\n\n  const serviceClient = ShareServiceClient.fromConnectionString(\n    process.env.AZURE_STORAGE_CONNECTION_STRING\n  );\n  const shareClient = serviceClient.getShareClient(shareName);\n  const directoryClient = shareClient.getDirectoryClient(directoryName);\n  const fileClient = directoryClient.getFileClient(fileName);\n\n  // Retry logic with exponential backoff\n  let attempt = 0;\n  let lastError: unknown = null;\n  while (attempt < maxRetries) {\n    try {\n      // Ensure share exists\n      await shareClient.createIfNotExists();\n      // Ensure directory exists\n      await directoryClient.createIfNotExists();\n      // Create file (set size)\n      await fileClient.create(buffer.length, {\n        fileHttpHeaders: { fileContentType: contentType },\n      });\n      // Upload content\n      await fileClient.uploadRange(buffer, 0, buffer.length);\n      // Return file URL\n      return fileClient.url;\n    } catch (err: unknown) {\n      lastError = err;\n      if (\n        err &&\n        typeof err === \"object\" &&\n        \"message\" in err &&\n        typeof (err as { message: unknown }).message === \"string\"\n      ) {\n        console.error(\n          `Attempt ${attempt + 1} to upload user image failed: ${\n            (err as { message: string }).message\n          }`\n        );\n      } else {\n        console.error(\n          `Attempt ${attempt + 1} to upload user image failed:`,\n          err\n        );\n      }\n      // Exponential backoff with jitter\n      if (attempt < maxRetries - 1) {\n        const baseDelay = Math.pow(2, attempt) * baseDelayMs;\n        const jitter = Math.random() * baseDelay;\n        const delay = baseDelay / 2 + jitter; // Between 0.5x and 1.5x base delay\n        console.warn(\n          `Backing off for ${Math.round(delay)} ms before retrying...`\n        );\n        await new Promise((res) => setTimeout(res, delay));\n      }\n    }\n    attempt++;\n  }\n  const lastErrorMsg =\n    lastError &&\n    typeof lastError === \"object\" &&\n    \"message\" in lastError &&\n    typeof (lastError as { message: unknown }).message === \"string\"\n      ? (lastError as { message: string }).message\n      : String((lastError as Error) ?? \"\");\n  throw new Error(\n    `Failed to upload user image after ${maxRetries} attempts: ${lastErrorMsg}`\n  );\n}\n"],"mappings":";AAAA,SAAS,0BAA0B;AAgBnC,eAAsB,qBACpB,QACA,SACA,QACA,aACA,UAAyB,CAAC,GACT;AAEjB,MAAI,CAAC,QAAQ,IAAI,iCAAiC;AAChD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AACA,MAAI,OAAO,YAAY,YAAY,MAAM,OAAO,GAAG;AACjD,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AACA,MAAI,CAAC,UAAU,EAAE,kBAAkB,SAAS;AAC1C,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AACA,MAAI,CAAC,eAAe,OAAO,gBAAgB,UAAU;AACnD,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACjE;AAEA,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,cAAc,QAAQ,eAAe;AAE3C,QAAM,YAAY;AAClB,QAAM,gBAAgB;AACtB,QAAM,WAAW,GAAG,OAAO;AAE3B,QAAM,gBAAgB,mBAAmB;AAAA,IACvC,QAAQ,IAAI;AAAA,EACd;AACA,QAAM,cAAc,cAAc,eAAe,SAAS;AAC1D,QAAM,kBAAkB,YAAY,mBAAmB,aAAa;AACpE,QAAM,aAAa,gBAAgB,cAAc,QAAQ;AAGzD,MAAI,UAAU;AACd,MAAI,YAAqB;AACzB,SAAO,UAAU,YAAY;AAC3B,QAAI;AAEF,YAAM,YAAY,kBAAkB;AAEpC,YAAM,gBAAgB,kBAAkB;AAExC,YAAM,WAAW,OAAO,OAAO,QAAQ;AAAA,QACrC,iBAAiB,EAAE,iBAAiB,YAAY;AAAA,MAClD,CAAC;AAED,YAAM,WAAW,YAAY,QAAQ,GAAG,OAAO,MAAM;AAErD,aAAO,WAAW;AAAA,IACpB,SAAS,KAAc;AACrB,kBAAY;AACZ,UACE,OACA,OAAO,QAAQ,YACf,aAAa,OACb,OAAQ,IAA6B,YAAY,UACjD;AACA,gBAAQ;AAAA,UACN,WAAW,UAAU,CAAC,iCACnB,IAA4B,OAC/B;AAAA,QACF;AAAA,MACF,OAAO;AACL,gBAAQ;AAAA,UACN,WAAW,UAAU,CAAC;AAAA,UACtB;AAAA,QACF;AAAA,MACF;AAEA,UAAI,UAAU,aAAa,GAAG;AAC5B,cAAM,YAAY,KAAK,IAAI,GAAG,OAAO,IAAI;AACzC,cAAM,SAAS,KAAK,OAAO,IAAI;AAC/B,cAAM,QAAQ,YAAY,IAAI;AAC9B,gBAAQ;AAAA,UACN,mBAAmB,KAAK,MAAM,KAAK,CAAC;AAAA,QACtC;AACA,cAAM,IAAI,QAAQ,CAAC,QAAQ,WAAW,KAAK,KAAK,CAAC;AAAA,MACnD;AAAA,IACF;AACA;AAAA,EACF;AACA,QAAM,eACJ,aACA,OAAO,cAAc,YACrB,aAAa,aACb,OAAQ,UAAmC,YAAY,WAClD,UAAkC,UACnC,OAAQ,aAAuB,EAAE;AACvC,QAAM,IAAI;AAAA,IACR,qCAAqC,UAAU,cAAc,YAAY;AAAA,EAC3E;AACF;","names":[]}

package/docs/adrs/index.md

@@ -0,0 +1,4 @@
+# ADR Index
+
+- [ADR-0001: Standalone @plasius/storage Package Scope](./adr-0001-storage-package-scope.md)
+- [ADR-0002: Public Repository Governance Baseline](./adr-0002-public-repo-governance.md)

package/package.json

@@ -1,26 +1,25 @@
 {
   "name": "@plasius/storage",
-  "version": "1.0.0",
-  "main": "./dist-cjs/index.js",
+  "version": "1.0.2",
+  "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "private": false,
   "type": "module",
   "description": "Azure storage for Plasius projects",
   "scripts": {
-    "build": "tsc --build && npm run build:cjs",
+    "build": "tsup",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:coverage:watch": "vitest --coverage",
-    "clean": "rimraf dist-cjs dist tsconfig.tsbuildinfo",
+    "clean": "rimraf dist dist-cjs tsconfig.tsbuildinfo",
     "reset:clean": "rm -rf node_modules package-lock.json && npm run clean",
     "audit:ts": "tsc --noEmit --pretty",
     "audit:eslint": "eslint \"{src,apps,packages}/**/*.{ts,tsx}\" --max-warnings=0 --ext .ts,.tsx",
-    "audit:deps": "depcheck --skip-missing=true",
+    "audit:deps": "npm ls --all --omit=optional --omit=peer > /dev/null 2>&1 || true",
     "audit:npm": "npm audit --audit-level=moderate || true",
     "audit:test": "vitest run --coverage",
     "audit:all": "npm-run-all -l audit:ts audit:eslint audit:deps audit:npm audit:test",
-    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node --outDir dist-cjs --tsBuildInfoFile dist-cjs/tsconfig.tsbuildinfo",
     "lint": "eslint .",
     "prepare": "npm run build"
   },
@@ -37,35 +36,34 @@
   },
   "devDependencies": {
     "@azure/cosmos": "^4.4.1",
-    "@types/node": "^24.3.1",
     "@testing-library/react": "^16.3.0",
+    "@types/node": "^24.3.1",
     "@types/react": "^19.1.8",
     "@types/uuid": "^10.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.38.0",
-    "@typescript-eslint/parser": "^8.38.0",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "ajv": "^6.12.6",
-    "depcheck": "^1.4.7",
-    "eslint": "^9.33.0",
-    "npm-run-all": "^4.1.5",
+    "eslint": "^10.0.1",
+    "npm-run-all": "^1.1.3",
     "react": "^19.1.0",
+    "tsup": "^8.5.0",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4",
+    "vitest": "^4.0.18",
     "zod": "^4.0.17"
   },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist-cjs/index.js"
+      "require": "./dist/index.cjs"
     },
     "./package.json": "./package.json"
   },
   "module": "./dist/index.js",
   "files": [
     "dist",
-    "dist-cjs",
     "src",
     "README.md",
     "CHANGELOG.md",
@@ -99,5 +97,8 @@
   ],
   "engines": {
     "node": ">=22.12"
+  },
+  "overrides": {
+    "minimatch": "^10.2.1"
   }
 }

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6FjB"}

package/dist-cjs/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6FjB"}

package/dist-cjs/index.js

@@ -1,87 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadUserImageShare = uploadUserImageShare;
-const storage_file_share_1 = require("@azure/storage-file-share");
-/**
- * Uploads a user image to Azure File Share storage with retries and error handling.
- * @param userId - The user's ID (used as directory name)
- * @param version - The version number (used as file name)
- * @param buffer - The file data as a Buffer
- * @param contentType - The MIME type of the file
- * @param options - Optional settings for retries and backoff
- * @returns URL to the uploaded file
- */
-async function uploadUserImageShare(userId, version, buffer, contentType, options = {}) {
-    // Parameter validation
-    if (!process.env.AZURE_STORAGE_CONNECTION_STRING) {
-        throw new Error("AZURE_STORAGE_CONNECTION_STRING is not set in environment variables.");
-    }
-    if (!userId || typeof userId !== "string") {
-        throw new Error("userId is required and must be a string.");
-    }
-    if (typeof version !== "number" || isNaN(version)) {
-        throw new Error("version is required and must be a number.");
-    }
-    if (!buffer || !(buffer instanceof Buffer)) {
-        throw new Error("buffer is required and must be a Buffer.");
-    }
-    if (!contentType || typeof contentType !== "string") {
-        throw new Error("contentType is required and must be a string.");
-    }
-    const maxRetries = options.maxRetries ?? 3;
-    const baseDelayMs = options.baseDelayMs ?? 500;
-    const shareName = "avatars";
-    const directoryName = userId;
-    const fileName = `${version}.jpg`;
-    const serviceClient = storage_file_share_1.ShareServiceClient.fromConnectionString(process.env.AZURE_STORAGE_CONNECTION_STRING);
-    const shareClient = serviceClient.getShareClient(shareName);
-    const directoryClient = shareClient.getDirectoryClient(directoryName);
-    const fileClient = directoryClient.getFileClient(fileName);
-    // Retry logic with exponential backoff
-    let attempt = 0;
-    let lastError = null;
-    while (attempt < maxRetries) {
-        try {
-            // Ensure share exists
-            await shareClient.createIfNotExists();
-            // Ensure directory exists
-            await directoryClient.createIfNotExists();
-            // Create file (set size)
-            await fileClient.create(buffer.length, {
-                fileHttpHeaders: { fileContentType: contentType },
-            });
-            // Upload content
-            await fileClient.uploadRange(buffer, 0, buffer.length);
-            // Return file URL
-            return fileClient.url;
-        }
-        catch (err) {
-            lastError = err;
-            if (err &&
-                typeof err === "object" &&
-                "message" in err &&
-                typeof err.message === "string") {
-                console.error(`Attempt ${attempt + 1} to upload user image failed: ${err.message}`);
-            }
-            else {
-                console.error(`Attempt ${attempt + 1} to upload user image failed:`, err);
-            }
-            // Exponential backoff with jitter
-            if (attempt < maxRetries - 1) {
-                const baseDelay = Math.pow(2, attempt) * baseDelayMs;
-                const jitter = Math.random() * baseDelay;
-                const delay = baseDelay / 2 + jitter; // Between 0.5x and 1.5x base delay
-                console.warn(`Backing off for ${Math.round(delay)} ms before retrying...`);
-                await new Promise((res) => setTimeout(res, delay));
-            }
-        }
-        attempt++;
-    }
-    const lastErrorMsg = lastError &&
-        typeof lastError === "object" &&
-        "message" in lastError &&
-        typeof lastError.message === "string"
-        ? lastError.message
-        : String(lastError ?? "");
-    throw new Error(`Failed to upload user image after ${maxRetries} attempts: ${lastErrorMsg}`);
-}