@memberjunction/storage 0.9.4

package/dist/drivers/AzureFileStorage.d.ts

@@ -0,0 +1,11 @@
+import { CreatePreAuthUploadUrlPayload, FileStorageBase } from '../generic/FileStorageBase';
+export declare class AzureFileStorage extends FileStorageBase {
+    private _sharedKeyCredential;
+    private _container;
+    private _accountName;
+    constructor();
+    CreatePreAuthUploadUrl(objectName: string): Promise<CreatePreAuthUploadUrlPayload>;
+    CreatePreAuthDownloadUrl(objectName: string): Promise<string>;
+    DeleteObject(objectName: string): Promise<boolean>;
+}
+//# sourceMappingURL=AzureFileStorage.d.ts.map

package/dist/drivers/AzureFileStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureFileStorage.d.ts","sourceRoot":"","sources":["../../src/drivers/AzureFileStorage.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE5F,qBACa,gBAAiB,SAAQ,eAAe;IACnD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;;IAYtB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAoBlF,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBvD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAMhE"}

package/dist/drivers/AzureFileStorage.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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.AzureFileStorage = void 0;
+const storage_blob_1 = require("@azure/storage-blob");
+const global_1 = require("@memberjunction/global");
+const env = __importStar(require("env-var"));
+const FileStorageBase_1 = require("../generic/FileStorageBase");
+let AzureFileStorage = class AzureFileStorage extends FileStorageBase_1.FileStorageBase {
+    constructor() {
+        super();
+        this._container = env.get('STORAGE_AZURE_CONTAINER').required().asString();
+        this._accountName = env.get('STORAGE_AZURE_ACCOUNT_NAME').required().asString();
+        const accountKey = env.get('STORAGE_AZURE_ACCOUNT_KEY').required().asString();
+        this._sharedKeyCredential = new storage_blob_1.StorageSharedKeyCredential(this._accountName, accountKey);
+    }
+    CreatePreAuthUploadUrl(objectName) {
+        const sasOptions = {
+            services: storage_blob_1.AccountSASServices.parse('b').toString(), // blobs
+            resourceTypes: storage_blob_1.AccountSASResourceTypes.parse('o').toString(), // object
+            permissions: storage_blob_1.AccountSASPermissions.parse('w'), // write-only permissions
+            protocol: storage_blob_1.SASProtocol.Https,
+            startsOn: new Date(),
+            expiresOn: new Date(new Date().valueOf() + 10 * 60 * 1000), // 10 minutes
+        };
+        // Using the SAS url to upload e.g.
+        // curl -H "x-ms-blob-type: BlockBlob" --upload-file 1236.txt --url "https://bccdpfiles.blob.core.windows.net/ca-temp/1236.txt?sv=2023-11-03&ss=btqf&srt=sco&spr=https&st=2024-03-18T15%3A59%3A19Z&se=2024-03-18T16%3A09%3A19Z&sp=rwdlacupi&sig=Vu68WUzRmVDsTLXpFvRUKiZVQgjWtds1FFiRDXiwtug%3D"
+        const sasToken = (0, storage_blob_1.generateAccountSASQueryParameters)(sasOptions, this._sharedKeyCredential).toString();
+        const queryString = sasToken[0] === '?' ? sasToken : `?${sasToken}`;
+        const UploadUrl = `https://${this._accountName}.blob.core.windows.net/${this._container}/${objectName}${queryString}`;
+        return Promise.resolve({ UploadUrl });
+    }
+    CreatePreAuthDownloadUrl(objectName) {
+        const sasOptions = {
+            services: storage_blob_1.AccountSASServices.parse('b').toString(), // blobs
+            resourceTypes: storage_blob_1.AccountSASResourceTypes.parse('o').toString(), // object
+            permissions: storage_blob_1.AccountSASPermissions.parse('r'), // read-only permissions
+            protocol: storage_blob_1.SASProtocol.Https,
+            startsOn: new Date(),
+            expiresOn: new Date(new Date().valueOf() + 10 * 60 * 1000), // 10 minutes
+        };
+        const sasToken = (0, storage_blob_1.generateAccountSASQueryParameters)(sasOptions, this._sharedKeyCredential).toString();
+        const queryString = sasToken[0] === '?' ? sasToken : `?${sasToken}`;
+        const url = `https://${this._accountName}.blob.core.windows.net/${this._container}/${objectName}${queryString}`;
+        return Promise.resolve(url);
+    }
+    async DeleteObject(objectName) {
+        const url = `https://${this._accountName}.blob.core.windows.net/${this._container}/${objectName}`;
+        const blobClient = new storage_blob_1.BlobClient(url, this._sharedKeyCredential);
+        const { succeeded } = await blobClient.deleteIfExists();
+        return succeeded;
+    }
+};
+exports.AzureFileStorage = AzureFileStorage;
+exports.AzureFileStorage = AzureFileStorage = __decorate([
+    (0, global_1.RegisterClass)(FileStorageBase_1.FileStorageBase, 'Azure Blob Storage'),
+    __metadata("design:paramtypes", [])
+], AzureFileStorage);
+//# sourceMappingURL=AzureFileStorage.js.map

package/dist/drivers/AzureFileStorage.js.map

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

package/dist/generic/FileStorageBase.d.ts

@@ -0,0 +1,132 @@
+export type CreatePreAuthUploadUrlPayload = {
+    UploadUrl: string;
+    ProviderKey?: string | undefined;
+};
+/**
+ * Represents an abstract base class for file storage. Provides methods for creating pre-authorized upload and download URLs, as well as deleting objects. This
+ * interface is implemented in specific driver classes for each storage provider.
+ */
+export declare abstract class FileStorageBase {
+    /**
+     * This method is designed to generate a pre-authenticated URL for uploading files to a storage provider. It abstracts over different storage providers,
+     * allowing for a unified interface to obtain upload URLs, regardless of the underlying provider's specifics. The method takes the name of the file (or
+     * object) you wish to upload as input and returns a Promise. This Promise, when resolved, provides a payload containing two key pieces of information:
+     *
+     * 1. `UploadUrl`: The URL to which the file should be uploaded. This URL is pre-authenticated, meaning it includes any necessary authentication tokens or
+     *    signatures. The URL's format and the authentication method depend on the storage provider being used.
+     *
+     * 2. `ProviderKey` (optional): Some storage providers assign their own unique key or name to the uploaded object instead of using the name provided by the
+     *    user. If the provider you are using does this, the `ProviderKey` will be included in the payload. This key can be useful for future reference to the
+     *    object within the storage provider's system.
+     *
+     * @usage
+     *
+     * Suppose you have a file named "photo.jpg" that you want to upload to your storage provider. You would call this method with the object name "photo.jpg".
+     * After the Promise resolves, you will receive the upload URL and, if applicable, the provider's object key. You can then use this URL to upload your file
+     * directly to the storage provider.
+     *
+     * ```typescript
+     * const uploadPayload = await CreatePreAuthUploadUrl("photo.jpg");
+     * console.log(uploadPayload.UploadUrl); // Use this URL to upload your file
+     * if (uploadPayload.ProviderKey) {
+     *   // If this is returned, use it as the `objectName` for `CreatePreAuthDownloadUrl` or `DeleteObject`
+     *   console.log(uploadPayload.ProviderKey);
+     * }
+     * ```
+     *
+     * Note: This method is abstract and must be implemented by a subclass that specifies the logic for interacting with a specific storage provider.
+     *
+     * @param objectName - The name of the object or file to be uploaded. This name is used by the storage provider and may also be included in the
+     *                     pre-authenticated URL.
+     * @returns A Promise that resolves to a payload containing the upload URL and, optionally, the provider's object key. This payload allows you to proceed with
+     *          uploading your file to the storage provider.
+     */
+    abstract CreatePreAuthUploadUrl(objectName: string): Promise<CreatePreAuthUploadUrlPayload>;
+    /**
+     * This abstract method is designed to generate a pre-authenticated URL that allows for the downloading of files or objects from a storage provider. Being
+     * abstract, it requires implementation in a subclass tailored to the specifics of the storage provider you're using. This method abstracts the process of
+     * generating download URLs across different storage providers, offering a unified interface for obtaining these URLs.
+     *
+     * When you call this method with the name of the file or object you wish to download, it initiates a process to create a URL. This URL is not just any link;
+     * it is pre-authenticated. This means it includes any necessary authentication tokens or signatures directly in the URL, allowing for secure access without
+     * requiring additional authentication steps at the time of download. The format of the URL and the authentication method depend on the storage provider.
+     *
+     * @usage
+     *
+     * Suppose you have a file named "report.pdf" stored in your cloud storage, and you want to generate a URL to download this file. You would call this method
+     * with the object name "report.pdf". After the Promise resolves, you will receive a URL that is ready to use for downloading the file.
+     *
+     * ```typescript
+     * const downloadUrl = await CreatePreAuthDownloadUrl("report.pdf");
+     * console.log(downloadUrl); // Use this URL to download your file directly
+     * ```
+     *
+     * If a `ProviderKey` was previously returned by `CreatePreAuthUploadUrl`, use that as the `objectName` instead of the object's natural name.
+     *
+     * ```typescript
+     * const downloadUrl = await CreatePreAuthDownloadUrl(file.ProviderKey);
+     * console.log(downloadUrl); // Use this URL to download your file directly
+     * ```
+     *
+     * This method simplifies the process of securely sharing or accessing files stored in cloud storage by providing a direct, pre-authenticated link to the
+     * file. It's particularly useful in applications where files need to be accessed or shared without navigating through the storage provider's standard
+     * authentication flow each time.
+     *
+     * Note: Since this method is abstract, you must implement it in a subclass that defines the specific interactions with your chosen storage provider.
+     *
+     * @param objectName - The name of the object or file for which you want to generate a download URL. This is the name as it is known to the storage provider,
+     *                     and it will be used to locate the file and generate the URL.
+     * @returns A Promise that resolves to a string, which is the pre-authenticated download URL for the specified object or file. This URL can be used
+     *          immediately for downloading the file without further authentication.
+     */
+    abstract CreatePreAuthDownloadUrl(objectName: string): Promise<string>;
+    /**
+     * This abstract method is designed for deleting an object or file from a storage provider's system. Being abstract, it requires concrete implementation in
+     * subclasses that are tailored to interact with specific storage providers. The method aims to provide a unified interface for object deletion across
+     * different storage providers, simplifying the deletion process regardless of the underlying provider's specifics.
+     *
+     * When invoking this method, you need to specify the name of the object you wish to delete. This name should match exactly as it is known to the storage
+     * provider, ensuring the correct object is targeted for deletion.
+     *
+     * The method returns a Promise that, when resolved, indicates the success or failure of the deletion operation. A resolved value of `true` means the object
+     * was successfully deleted, while `false` indicates a failure to delete the object. It's important to handle both outcomes to ensure your application can
+     * respond appropriately to the deletion operation's result.
+     *
+     * @usage
+     *
+     * Suppose you have a file named "old_report.pdf" that is no longer needed and you want to delete it from your cloud storage. You would call this method with
+     * the object name "old_report.pdf". After the Promise resolves, you can check the result to confirm the deletion.
+     *
+     * ```typescript
+     * DeleteObject("old_report.pdf").then((isDeleted) => {
+     *   if (isDeleted) {
+     *     console.log("The file was successfully deleted.");
+     *   } else {
+     *     console.log("Failed to delete the file. It may not exist or there was an error in the deletion process.");
+     *   }
+     * });
+     * ```
+     *
+     * If a `ProviderKey` was previously returned by `CreatePreAuthUploadUrl`, use that as the `objectName` instead of the object's natural name.
+     *
+     * ```typescript
+     * DeleteObject(file.ProviderKey).then((isDeleted) => {
+     *   if (isDeleted) {
+     *     console.log("The file was successfully deleted.");
+     *   } else {
+     *     console.log("Failed to delete the file. It may not exist or there was an error in the deletion process.");
+     *   }
+     * });
+     * ```
+     *
+     * Note: Since this method is abstract, it must be implemented in a subclass that defines the specific logic for interacting with your chosen storage
+     * provider. This implementation should handle the intricacies of the deletion process, including any authentication and authorization required by the storage
+     * provider.
+     *
+     * @param objectName - The name of the object or file to be deleted. This is the identifier used by the storage provider to locate the object for deletion.
+     * @returns A Promise that resolves to a boolean value. `true` indicates that the object was successfully deleted, while `false` indicates a failure in the
+     * deletion process.
+     */
+    abstract DeleteObject(objectName: string): Promise<boolean>;
+}
+//# sourceMappingURL=FileStorageBase.d.ts.map

package/dist/generic/FileStorageBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStorageBase.d.ts","sourceRoot":"","sources":["../../src/generic/FileStorageBase.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF;;;GAGG;AACH,8BAAsB,eAAe;IACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;aACa,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAElG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;aACa,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;aACa,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CACnE"}

package/dist/generic/FileStorageBase.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageBase = void 0;
+/**
+ * Represents an abstract base class for file storage. Provides methods for creating pre-authorized upload and download URLs, as well as deleting objects. This
+ * interface is implemented in specific driver classes for each storage provider.
+ */
+class FileStorageBase {
+}
+exports.FileStorageBase = FileStorageBase;
+//# sourceMappingURL=FileStorageBase.js.map

package/dist/generic/FileStorageBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStorageBase.js","sourceRoot":"","sources":["../../src/generic/FileStorageBase.ts"],"names":[],"mappings":";;;AAKA;;;GAGG;AACH,MAAsB,eAAe;CA4HpC;AA5HD,0CA4HC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './drivers/AzureFileStorage';
+export * from './generic/FileStorageBase';
+export * from './util';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./drivers/AzureFileStorage"), exports);
+__exportStar(require("./generic/FileStorageBase"), exports);
+__exportStar(require("./util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,4DAA0C;AAC1C,yCAAuB"}

package/dist/util.d.ts

@@ -0,0 +1,39 @@
+import { FileStorageProviderEntity } from '@memberjunction/core-entities';
+/**
+ * Creates an upload URL for a file in the specified file storage provider. Infers ContentType based on the file name, enforces a specific `Status` and may set
+ * the `ProviderKey` value, dependening on the underlying file storage provider.
+ *
+ * @param providerEntity - The file storage provider entity.
+ * @param input - The input object containing the file details.
+ * @returns A promise that resolves to an object with the updated input and the upload URL.
+ */
+export declare const createUploadUrl: <TInput extends {
+    ID: number;
+    Name: string;
+    ProviderID: number;
+    ContentType?: string;
+    ProviderKey?: string;
+}>(providerEntity: FileStorageProviderEntity, input: TInput) => Promise<{
+    updatedInput: TInput & {
+        Status: string;
+        ContentType: string;
+    };
+    UploadUrl: string;
+}>;
+/**
+ * Creates a pre-authorized download URL for a file from the specified file storage provider.
+ *
+ * @param {FileStorageProviderEntity} providerEntity - The file storage provider entity.
+ * @param {string | number} providerKeyOrID - The provider key or ID for the file to download.
+ * @returns {Promise<string>} - The pre-authorized download URL.
+ */
+export declare const createDownloadUrl: (providerEntity: FileStorageProviderEntity, providerKeyOrID: string | number) => Promise<string>;
+/**
+ * Delete a previously uploaded file from the specified file storage provider.
+ *
+ * @param {FileStorageProviderEntity} providerEntity - The file storage provider entity.
+ * @param {string | number} providerKeyOrID - The provider key or ID for the file to delete.
+ * @returns {Promise<boolean>} - The success of he delete operation.
+ */
+export declare const deleteObject: (providerEntity: FileStorageProviderEntity, providerKeyOrID: string | number) => Promise<boolean>;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAK1E;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;QACL,MAAM;UAAQ,MAAM;gBAAc,MAAM;kBAAgB,MAAM;kBAAgB,MAAM;mBAEzF,yBAAyB;;gBAGR,MAAM;qBAAe,MAAM;;eACjD,MAAM;EAclB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,mBAA0B,yBAAyB,mBAAmB,MAAM,GAAG,MAAM,KAAG,QAAQ,MAAM,CAGnI,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,mBAAoB,yBAAyB,mBAAmB,MAAM,GAAG,MAAM,qBAGvG,CAAC"}

package/dist/util.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteObject = exports.createDownloadUrl = exports.createUploadUrl = void 0;
+const global_1 = require("@memberjunction/global");
+const mime_types_1 = __importDefault(require("mime-types"));
+const FileStorageBase_1 = require("./generic/FileStorageBase");
+/**
+ * Creates an upload URL for a file in the specified file storage provider. Infers ContentType based on the file name, enforces a specific `Status` and may set
+ * the `ProviderKey` value, dependening on the underlying file storage provider.
+ *
+ * @param providerEntity - The file storage provider entity.
+ * @param input - The input object containing the file details.
+ * @returns A promise that resolves to an object with the updated input and the upload URL.
+ */
+const createUploadUrl = async (providerEntity, input) => {
+    const { ID, ProviderID } = input;
+    const ContentType = input.ContentType ?? mime_types_1.default.lookup(input.Name) ?? 'application/octet-stream';
+    const Status = 'Uploading';
+    await providerEntity.Load(ProviderID);
+    const driver = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(FileStorageBase_1.FileStorageBase, providerEntity.ServerDriverKey);
+    const { UploadUrl, ...maybeProviderKey } = await driver.CreatePreAuthUploadUrl(String(ID));
+    const updatedInput = { ...input, ...maybeProviderKey, ContentType, Status };
+    return { updatedInput, UploadUrl };
+};
+exports.createUploadUrl = createUploadUrl;
+/**
+ * Creates a pre-authorized download URL for a file from the specified file storage provider.
+ *
+ * @param {FileStorageProviderEntity} providerEntity - The file storage provider entity.
+ * @param {string | number} providerKeyOrID - The provider key or ID for the file to download.
+ * @returns {Promise<string>} - The pre-authorized download URL.
+ */
+const createDownloadUrl = async (providerEntity, providerKeyOrID) => {
+    const driver = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(FileStorageBase_1.FileStorageBase, providerEntity.ServerDriverKey);
+    return driver.CreatePreAuthDownloadUrl(String(providerKeyOrID));
+};
+exports.createDownloadUrl = createDownloadUrl;
+/**
+ * Delete a previously uploaded file from the specified file storage provider.
+ *
+ * @param {FileStorageProviderEntity} providerEntity - The file storage provider entity.
+ * @param {string | number} providerKeyOrID - The provider key or ID for the file to delete.
+ * @returns {Promise<boolean>} - The success of he delete operation.
+ */
+const deleteObject = (providerEntity, providerKeyOrID) => {
+    const driver = global_1.MJGlobal.Instance.ClassFactory.CreateInstance(FileStorageBase_1.FileStorageBase, providerEntity.ServerDriverKey);
+    return driver.DeleteObject(String(providerKeyOrID));
+};
+exports.deleteObject = deleteObject;
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":";;;;;;AACA,mDAAkD;AAClD,4DAA8B;AAC9B,+DAA4D;AAE5D;;;;;;;GAOG;AACI,MAAM,eAAe,GAAG,KAAK,EAGlC,cAAyC,EACzC,KAAa,EAIZ,EAAE;IACH,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAEjC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,oBAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC;IAC/F,MAAM,MAAM,GAAG,WAAW,CAAC;IAE3B,MAAM,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,iBAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAAkB,iCAAe,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAE/H,MAAM,EAAE,SAAS,EAAE,GAAG,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3F,MAAM,YAAY,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAE5E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC,CAAC;AArBW,QAAA,eAAe,mBAqB1B;AAEF;;;;;;GAMG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,cAAyC,EAAE,eAAgC,EAAmB,EAAE;IACtI,MAAM,MAAM,GAAG,iBAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAAkB,iCAAe,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAC/H,OAAO,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC;AAHW,QAAA,iBAAiB,qBAG5B;AAEF;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAC,cAAyC,EAAE,eAAgC,EAAE,EAAE;IAC1G,MAAM,MAAM,GAAG,iBAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,cAAc,CAAkB,iCAAe,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAC/H,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AACtD,CAAC,CAAC;AAHW,QAAA,YAAY,gBAGvB"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@memberjunction/storage",
+  "version": "0.9.4",
+  "description": "This library provides a set of objects that handle the interface between the server-side API and various cloud storage providers.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "start": "ts-node-dev src/index.ts",
+    "build": "tsc",
+    "watch": "tsc -w",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "devDependencies": {
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "@azure/identity": "^4.0.1",
+    "@azure/storage-blob": "^12.17.0",
+    "@memberjunction/core": "^0.9.174",
+    "@memberjunction/core-entities": "^0.9.159",
+    "@memberjunction/global": "^0.9.155",
+    "env-var": "^7.3.0",
+    "mime-types": "^2.1.35"
+  }
+}

package/readme.md

@@ -0,0 +1,3 @@
+# @memberjunction/storage
+
+The `@memberjunction/storage` library provides a set of objects that handle the interface between the server-side API and various cloud storage providers.