@memberjunction/storage 3.3.0 → 4.0.0

package/dist/generic/FileStorageBase.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Represents the payload returned by the CreatePreAuthUploadUrl method.
  * This type contains the necessary information for uploading a file to a storage provider.
@@ -216,26 +215,41 @@ export declare class UnsupportedOperationError extends Error {
  * Configuration options for initializing a storage provider.
  * This interface defines the standard configuration that can be passed to initialize().
  *
- * In the enterprise model, every storage driver instance is associated with a
- * FileStorageAccount entity. The accountId is required to link the driver to
- * the specific organizational storage account it operates on behalf of.
+ * ## Usage Patterns
+ *
+ * ### Simple Deployment (Environment Variables)
+ * - Omit accountId when using environment variables
+ * - Constructor loads credentials automatically
+ * - Call initialize() with no config or empty object
+ *
+ * ### Multi-Tenant Enterprise (Database)
+ * - Provide accountId to link driver to FileStorageAccount
+ * - Include decrypted credentials from database
+ * - Or use initializeDriverWithAccountCredentials() utility
  */
 export interface StorageProviderConfig {
     /**
      * The ID of the FileStorageAccount entity this driver instance is operating for.
      * This links the driver to a specific organizational storage account.
      *
-     * Required in the enterprise model - every driver instance must be associated
-     * with a FileStorageAccount.
+     * **Optional**: Provide for multi-tenant mode to track account association.
+     * Omit for simple deployment using environment variables.
      */
-    accountId: string;
+    accountId?: string;
     /**
      * The name of the account (for logging/display purposes).
+     *
+     * **Optional**: Useful for logging and debugging in multi-tenant scenarios.
      */
     accountName?: string;
     /**
      * Provider-specific configuration values (e.g., API keys, bucket names, etc.).
-     * These are typically decrypted from the Credential entity at runtime.
+     *
+     * **Simple Deployment**: Not needed - constructor loads from environment variables.
+     * **Multi-Tenant**: Provide decrypted credentials from Credential entity.
+     *
+     * If provided, these values override the constructor defaults.
+     * If omitted, uses credentials already loaded by constructor.
      */
     [key: string]: unknown;
 }
@@ -654,52 +668,72 @@ export declare abstract class FileStorageBase {
      */
     abstract DirectoryExists(directoryPath: string): Promise<boolean>;
     /**
-     * Initialization method for storage providers.
+     * Initialize storage provider with optional configuration.
      *
-     * This method must be called before using the storage provider. It sets up the
-     * account association and can be overridden by subclasses to perform provider-specific
-     * initialization such as setting up access tokens, establishing connections, or
-     * verifying permissions.
+     * ## Standard Usage Pattern
      *
-     * The base implementation extracts and stores accountId and accountName from the config.
-     * Subclass implementations should call super.initialize(config) first to ensure these
-     * values are properly set before performing provider-specific initialization.
+     * **ALWAYS call this method** after creating a provider instance.
      *
-     * @param config - Configuration object containing account information and provider-specific
-     *                 settings. The accountId property is required and links this driver instance
-     *                 to a specific FileStorageAccount entity. Additional provider-specific values
-     *                 (e.g., API keys, bucket names) are typically decrypted from the associated
-     *                 Credential entity.
+     * ### Simple Deployment (Environment Variables)
+     * Constructor loads credentials from environment variables, then call
+     * initialize() with no config to complete setup:
      *
-     * @example
      * ```typescript
-     * // In a specific provider implementation:
-     * public async initialize(config: StorageProviderConfig): Promise<void> {
-     *   // Always call super first to set accountId and accountName
-     *   await super.initialize(config);
-     *
-     *   // Then handle provider-specific configuration
-     *   if (config.accessToken) {
-     *     this._client = new ProviderClient({ accessToken: config.accessToken as string });
-     *   }
-     *   await this.verifyBucketAccess();
-     * }
+     * // Set environment variables:
+     * // STORAGE_AWS_ACCESS_KEY_ID=...
+     * // STORAGE_AWS_SECRET_ACCESS_KEY=...
+     * // STORAGE_AWS_BUCKET_NAME=...
+     * // STORAGE_AWS_REGION=...
+     *
+     * const storage = new AWSFileStorage(); // Constructor loads env vars
+     * await storage.initialize(); // No config - uses env vars
+     * await storage.ListObjects('/'); // Ready to use
+     * ```
      *
-     * // Usage:
-     * const storage = new MyStorageProvider();
+     * ### Multi-Tenant Enterprise (Database)
+     * Constructor loads defaults, then call initialize() with configuration
+     * to override with database credentials and track account:
+     *
+     * ```typescript
+     * // Preferred: Use infrastructure utility
+     * const storage = await initializeDriverWithAccountCredentials({
+     *   accountEntity,
+     *   providerEntity,
+     *   contextUser
+     * });
+     *
+     * // Alternative: Manual initialization
+     * const storage = new AWSFileStorage();
      * await storage.initialize({
-     *   accountId: 'F1234567-89AB-CDEF-0123-456789ABCDEF',
-     *   accountName: 'Company AWS S3 Storage',
-     *   accessKeyId: 'AKIA...',
-     *   secretAccessKey: '...',
-     *   bucket: 'my-bucket'
+     *   accountId: account.id,
+     *   accountName: account.name,
+     *   accessKeyID: creds.accessKeyID,
+     *   secretAccessKey: creds.secretAccessKey,
+     *   region: creds.region,
+     *   defaultBucket: creds.bucket
      * });
-     * // Now the provider is ready to use
      * ```
      *
-     * @returns A Promise that resolves when initialization is complete.
+     * ## How It Works
+     *
+     * - **No config**: Uses credentials already loaded by constructor from environment variables
+     * - **With config**: Overrides constructor credentials with provided values
+     * - **accountId**: Optional - provide for multi-tenant tracking
+     *
+     * ## Implementation Notes for Subclasses
+     *
+     * Subclass implementations should:
+     * 1. Call super.initialize(config) first to set accountId and accountName
+     * 2. Check if config is provided before attempting to override credentials
+     * 3. Only override values that are present in config
+     * 4. Reinitialize client/connection if credentials changed
+     *
+     * @param config - Optional configuration object
+     *                 - Omit for simple deployment (uses env vars from constructor)
+     *                 - Provide for multi-tenant (overrides with database credentials)
+     * @returns A Promise that resolves when initialization is complete
      */
-    initialize(config: StorageProviderConfig): Promise<void>;
+    initialize(config?: StorageProviderConfig): Promise<void>;
     /**
      * Checks whether this storage provider is properly configured and ready to use.
      *

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

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

package/dist/generic/FileStorageBase.js

@@ -1,12 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileStorageBase = exports.UnsupportedOperationError = void 0;
 /**
  * Error thrown when a storage provider does not support a particular operation.
  * This custom error provides clear information about which operation was attempted
  * and which provider doesn't support it.
  */
-class UnsupportedOperationError extends Error {
+export class UnsupportedOperationError extends Error {
     /**
      * Creates a new UnsupportedOperationError instance.
      *
@@ -18,7 +15,6 @@ class UnsupportedOperationError extends Error {
         this.name = 'UnsupportedOperationError';
     }
 }
-exports.UnsupportedOperationError = UnsupportedOperationError;
 /**
  * Represents an abstract base class for file storage operations.
  *
@@ -41,16 +37,7 @@ exports.UnsupportedOperationError = UnsupportedOperationError;
  * - When a storage provider doesn't support a particular operation, implementations should throw UnsupportedOperationError
  * - Each instance operates on behalf of a specific FileStorageAccount (identified by accountId)
  */
-class FileStorageBase {
-    /**
-     * The ID of the FileStorageAccount this driver instance is operating for.
-     * Set during initialization via the config parameter.
-     */
-    _accountId;
-    /**
-     * The name of the FileStorageAccount (for logging/display purposes).
-     */
-    _accountName;
+export class FileStorageBase {
     /**
      * Gets the account ID this driver instance is operating for.
      * Returns undefined if the driver was not initialized with an account.
@@ -76,56 +63,77 @@ class FileStorageBase {
         throw new UnsupportedOperationError(methodName, this.providerName);
     }
     /**
-     * Initialization method for storage providers.
+     * Initialize storage provider with optional configuration.
      *
-     * This method must be called before using the storage provider. It sets up the
-     * account association and can be overridden by subclasses to perform provider-specific
-     * initialization such as setting up access tokens, establishing connections, or
-     * verifying permissions.
+     * ## Standard Usage Pattern
      *
-     * The base implementation extracts and stores accountId and accountName from the config.
-     * Subclass implementations should call super.initialize(config) first to ensure these
-     * values are properly set before performing provider-specific initialization.
+     * **ALWAYS call this method** after creating a provider instance.
      *
-     * @param config - Configuration object containing account information and provider-specific
-     *                 settings. The accountId property is required and links this driver instance
-     *                 to a specific FileStorageAccount entity. Additional provider-specific values
-     *                 (e.g., API keys, bucket names) are typically decrypted from the associated
-     *                 Credential entity.
+     * ### Simple Deployment (Environment Variables)
+     * Constructor loads credentials from environment variables, then call
+     * initialize() with no config to complete setup:
      *
-     * @example
      * ```typescript
-     * // In a specific provider implementation:
-     * public async initialize(config: StorageProviderConfig): Promise<void> {
-     *   // Always call super first to set accountId and accountName
-     *   await super.initialize(config);
+     * // Set environment variables:
+     * // STORAGE_AWS_ACCESS_KEY_ID=...
+     * // STORAGE_AWS_SECRET_ACCESS_KEY=...
+     * // STORAGE_AWS_BUCKET_NAME=...
+     * // STORAGE_AWS_REGION=...
      *
-     *   // Then handle provider-specific configuration
-     *   if (config.accessToken) {
-     *     this._client = new ProviderClient({ accessToken: config.accessToken as string });
-     *   }
-     *   await this.verifyBucketAccess();
-     * }
+     * const storage = new AWSFileStorage(); // Constructor loads env vars
+     * await storage.initialize(); // No config - uses env vars
+     * await storage.ListObjects('/'); // Ready to use
+     * ```
+     *
+     * ### Multi-Tenant Enterprise (Database)
+     * Constructor loads defaults, then call initialize() with configuration
+     * to override with database credentials and track account:
      *
-     * // Usage:
-     * const storage = new MyStorageProvider();
+     * ```typescript
+     * // Preferred: Use infrastructure utility
+     * const storage = await initializeDriverWithAccountCredentials({
+     *   accountEntity,
+     *   providerEntity,
+     *   contextUser
+     * });
+     *
+     * // Alternative: Manual initialization
+     * const storage = new AWSFileStorage();
      * await storage.initialize({
-     *   accountId: 'F1234567-89AB-CDEF-0123-456789ABCDEF',
-     *   accountName: 'Company AWS S3 Storage',
-     *   accessKeyId: 'AKIA...',
-     *   secretAccessKey: '...',
-     *   bucket: 'my-bucket'
+     *   accountId: account.id,
+     *   accountName: account.name,
+     *   accessKeyID: creds.accessKeyID,
+     *   secretAccessKey: creds.secretAccessKey,
+     *   region: creds.region,
+     *   defaultBucket: creds.bucket
      * });
-     * // Now the provider is ready to use
      * ```
      *
-     * @returns A Promise that resolves when initialization is complete.
+     * ## How It Works
+     *
+     * - **No config**: Uses credentials already loaded by constructor from environment variables
+     * - **With config**: Overrides constructor credentials with provided values
+     * - **accountId**: Optional - provide for multi-tenant tracking
+     *
+     * ## Implementation Notes for Subclasses
+     *
+     * Subclass implementations should:
+     * 1. Call super.initialize(config) first to set accountId and accountName
+     * 2. Check if config is provided before attempting to override credentials
+     * 3. Only override values that are present in config
+     * 4. Reinitialize client/connection if credentials changed
+     *
+     * @param config - Optional configuration object
+     *                 - Omit for simple deployment (uses env vars from constructor)
+     *                 - Provide for multi-tenant (overrides with database credentials)
+     * @returns A Promise that resolves when initialization is complete
      */
     async initialize(config) {
-        // Extract and store account information from the config
-        this._accountId = config.accountId;
-        this._accountName = config.accountName;
+        // Extract and store account information from the config if provided
+        if (config) {
+            this._accountId = config.accountId;
+            this._accountName = config.accountName;
+        }
     }
 }
-exports.FileStorageBase = FileStorageBase;
 //# sourceMappingURL=FileStorageBase.js.map

package/dist/generic/FileStorageBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileStorageBase.js","sourceRoot":"","sources":["../../src/generic/FileStorageBase.ts"],"names":[],"mappings":";;;AAkOA;;;;GAIG;AACH,MAAa,yBAA0B,SAAQ,KAAK;IAClD;;;;;OAKG;IACH,YAAY,UAAkB,EAAE,YAAoB;QAClD,KAAK,CAAC,cAAc,UAAU,6BAA6B,YAAY,WAAW,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAXD,8DAWC;AAgCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAsB,eAAe;IAOnC;;;OAGG;IACO,UAAU,CAAqB;IAEzC;;OAEG;IACO,YAAY,CAAqB;IAE3C;;;OAGG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACO,8BAA8B,CAAC,UAAkB;QACzD,MAAM,IAAI,yBAAyB,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACrE,CAAC;IAsXD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACI,KAAK,CAAC,UAAU,CAAC,MAA6B;QACnD,wDAAwD;QACxD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;IACzC,CAAC;CA8GF;AAjkBD,0CAikBC"}
+{"version":3,"file":"FileStorageBase.js","sourceRoot":"","sources":["../../src/generic/FileStorageBase.ts"],"names":[],"mappings":"AAkOA;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD;;;;;OAKG;IACH,YAAY,UAAkB,EAAE,YAAoB;QAClD,KAAK,CAAC,cAAc,UAAU,6BAA6B,YAAY,WAAW,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AA+CD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAgB,eAAe;IAkBnC;;;OAGG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACO,8BAA8B,CAAC,UAAkB;QACzD,MAAM,IAAI,yBAAyB,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACrE,CAAC;IAsXD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACI,KAAK,CAAC,UAAU,CAAC,MAA8B;QACpD,oEAAoE;QACpE,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;YACnC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;QACzC,CAAC;IACH,CAAC;CA8GF"}

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-export * from './drivers/AWSFileStorage';
-export * from './drivers/AzureFileStorage';
-export * from './drivers/GoogleFileStorage';
-export * from './drivers/GoogleDriveFileStorage';
-export * from './drivers/SharePointFileStorage';
-export * from './drivers/DropboxFileStorage';
-export * from './drivers/BoxFileStorage';
-export * from './generic/FileStorageBase';
-export * from './util';
-export * from './config';
+export * from './drivers/AWSFileStorage.js';
+export * from './drivers/AzureFileStorage.js';
+export * from './drivers/GoogleFileStorage.js';
+export * from './drivers/GoogleDriveFileStorage.js';
+export * from './drivers/SharePointFileStorage.js';
+export * from './drivers/DropboxFileStorage.js';
+export * from './drivers/BoxFileStorage.js';
+export * from './generic/FileStorageBase.js';
+export * from './util.js';
+export * from './config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,27 +1,11 @@
-"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/AWSFileStorage"), exports);
-__exportStar(require("./drivers/AzureFileStorage"), exports);
-__exportStar(require("./drivers/GoogleFileStorage"), exports);
-__exportStar(require("./drivers/GoogleDriveFileStorage"), exports);
-__exportStar(require("./drivers/SharePointFileStorage"), exports);
-__exportStar(require("./drivers/DropboxFileStorage"), exports);
-__exportStar(require("./drivers/BoxFileStorage"), exports);
-__exportStar(require("./generic/FileStorageBase"), exports);
-__exportStar(require("./util"), exports);
-__exportStar(require("./config"), exports);
+export * from './drivers/AWSFileStorage.js';
+export * from './drivers/AzureFileStorage.js';
+export * from './drivers/GoogleFileStorage.js';
+export * from './drivers/GoogleDriveFileStorage.js';
+export * from './drivers/SharePointFileStorage.js';
+export * from './drivers/DropboxFileStorage.js';
+export * from './drivers/BoxFileStorage.js';
+export * from './generic/FileStorageBase.js';
+export * from './util.js';
+export * from './config.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,6DAA2C;AAC3C,8DAA4C;AAC5C,mEAAiD;AACjD,kEAAgD;AAChD,+DAA6C;AAC7C,2DAAyC;AACzC,4DAA0C;AAC1C,yCAAuB;AACvB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/util.d.ts

@@ -1,6 +1,6 @@
 import { FileStorageProviderEntity, FileStorageAccountEntity } from '@memberjunction/core-entities';
 import { UserInfo } from '@memberjunction/core';
-import { FileStorageBase, FileSearchResult } from './generic/FileStorageBase';
+import { FileStorageBase, FileSearchResult } from './generic/FileStorageBase.js';
 /**
  * Callback function called when a new refresh token is issued.
  * This is important for providers like Box that issue new refresh tokens with each refresh.
@@ -329,7 +329,7 @@ export declare const deleteObject: (providerEntity: FileStorageProviderEntity, p
  * const docsResult = await listObjects(fileStorageProvider, 'documents/', '/', userContext);
  * ```
  */
-export declare const listObjects: (providerEntity: FileStorageProviderEntity, prefix: string, delimiter?: string, userContext?: UserContextOptions) => Promise<import('./generic/FileStorageBase').StorageListResult>;
+export declare const listObjects: (providerEntity: FileStorageProviderEntity, prefix: string, delimiter?: string, userContext?: UserContextOptions) => Promise<import("./generic/FileStorageBase.js").StorageListResult>;
 /**
  * Result of a cross-provider copy operation
  */

package/dist/util.d.ts.map

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