@memberjunction/storage 5.24.0 → 5.25.0

package/dist/FileStorageEngine.d.ts

@@ -0,0 +1,187 @@
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { BaseSingleton } from '@memberjunction/global';
+import { FileStorageEngineBase, StorageAccountWithProvider, MJFileStorageAccountEntity, MJFileStorageProviderEntity } from '@memberjunction/core-entities';
+import { FileStorageBase } from './generic/FileStorageBase.js';
+/**
+ * Options for uploading a file to MJ Storage.
+ */
+export interface UploadFileOptions {
+    /** Raw file content as a Buffer */
+    content: Buffer;
+    /** File name (used for the MJ: Files record and the storage path) */
+    fileName: string;
+    /** MIME type of the file (e.g., 'application/pdf') */
+    mimeType: string;
+    /** User context for DB operations and credential access */
+    contextUser: UserInfo;
+    /**
+     * Optional pre-resolved FileStorageAccount ID.
+     * When provided, the file is uploaded to this specific account.
+     * Otherwise, the first active account is used.
+     */
+    storageAccountId?: string;
+    /**
+     * Optional metadata provider. Defaults to `Metadata.Provider`.
+     */
+    provider?: IMetadataProvider;
+    /**
+     * Optional path prefix within the storage bucket.
+     * Defaults to `'artifacts/<date>/<uuid>'`.
+     */
+    pathPrefix?: string;
+}
+/**
+ * Result returned by {@link FileStorageEngine.UploadFile}.
+ */
+export interface UploadFileResult {
+    /** The newly created MJ: Files record ID */
+    FileID: string;
+    /** The storage path (ProviderKey) where the file was stored */
+    StoragePath: string;
+    /** The storage account that was used */
+    Account: MJFileStorageAccountEntity;
+    /** The storage provider that was used */
+    Provider: MJFileStorageProviderEntity;
+}
+/**
+ * Server-side file storage engine providing high-level operations for uploading,
+ * downloading, and managing files in MJ Storage.
+ *
+ * Follows the containment pattern (like AIEngine wraps AIEngineBase):
+ * - Delegates all metadata access to {@link FileStorageEngineBase}
+ * - Adds server-side methods: {@link UploadFile}, {@link GetDriver}, {@link ResolveStorageAccount}
+ *
+ * **Client-side code** should use `FileStorageEngineBase` from `@memberjunction/core-entities`
+ * for metadata-only access (accounts, providers, lookups).
+ *
+ * Usage:
+ * ```typescript
+ * import { FileStorageEngine } from '@memberjunction/storage';
+ *
+ * const engine = FileStorageEngine.Instance;
+ * await engine.Config(false, contextUser);
+ *
+ * // Upload a file
+ * const result = await engine.UploadFile({
+ *     content: Buffer.from(base64Data, 'base64'),
+ *     fileName: 'report.pdf',
+ *     mimeType: 'application/pdf',
+ *     contextUser
+ * });
+ *
+ * // Get a driver for direct operations
+ * const driver = await engine.GetDriver(accountId, contextUser);
+ * const objects = await driver.ListObjects('/');
+ * ```
+ */
+export declare class FileStorageEngine extends BaseSingleton<FileStorageEngine> {
+    private _loaded;
+    private _loading;
+    private _loadingPromise;
+    private _contextUser;
+    private _driverCache;
+    /**
+     * Returns the global singleton instance.
+     */
+    static get Instance(): FileStorageEngine;
+    /** Access to the underlying metadata-only engine. */
+    protected get Base(): FileStorageEngineBase;
+    /** Returns true if the engine has been configured. */
+    get Loaded(): boolean;
+    /** Gets all file storage accounts (cached). */
+    get Accounts(): MJFileStorageAccountEntity[];
+    /** Gets all file storage providers (cached). */
+    get Providers(): MJFileStorageProviderEntity[];
+    /** Gets all storage accounts combined with their provider details (cached). */
+    get AccountsWithProviders(): StorageAccountWithProvider[];
+    /** Whether any storage accounts are configured. */
+    get HasStorageAccounts(): boolean;
+    /** Gets a file storage account by its ID. */
+    GetAccountById(accountId: string): MJFileStorageAccountEntity | undefined;
+    /** Gets a file storage provider by its ID. */
+    GetProviderById(providerId: string): MJFileStorageProviderEntity | undefined;
+    /** Gets a file storage account by its name (case-insensitive). */
+    GetAccountByName(name: string): MJFileStorageAccountEntity | undefined;
+    /** Gets file storage accounts linked to a given provider ID. */
+    GetAccountsByProviderID(providerId: string): MJFileStorageAccountEntity[];
+    /** Gets a storage account with its provider details by account ID. */
+    GetAccountWithProvider(accountId: string): StorageAccountWithProvider | null;
+    /**
+     * Configures the engine by loading the underlying metadata cache and any
+     * server-specific state. Safe to call multiple times — uses cached data
+     * unless `forceRefresh` is true. Concurrent callers share a single loading
+     * promise to avoid redundant work.
+     */
+    Config(forceRefresh?: boolean, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<void>;
+    /**
+     * Internal loading logic — separated for clean promise management.
+     * First ensures the base metadata cache is loaded, then loads any
+     * server-specific state (extensible for future needs).
+     */
+    private innerLoad;
+    /**
+     * Initializes storage drivers for all active accounts and caches them.
+     * Called automatically during Config(). Can also be called independently to
+     * re-initialize drivers without reloading metadata (e.g., after credential rotation).
+     * Accounts that fail to initialize are logged and skipped — they will fall back to
+     * on-demand initialization when GetDriver() is called.
+     */
+    RefreshDriverCache(): Promise<void>;
+    /**
+     * Resolves a storage account to use for file operations.
+     *
+     * Resolution logic:
+     * 1. If `accountId` is provided, returns that specific account
+     * 2. Otherwise, returns the first active account
+     * 3. If no active accounts exist, returns the first account regardless of active status
+     *
+     * @param accountId - Optional explicit account ID
+     * @returns The resolved account with provider, or null if no accounts are configured
+     */
+    ResolveStorageAccount(accountId?: string): StorageAccountWithProvider | null;
+    /**
+     * Returns an authenticated storage driver for a given account.
+     *
+     * Checks the pre-initialized driver cache first (populated during Config()).
+     * If the account wasn't cached (e.g., it failed during Config or was added after),
+     * falls back to on-demand initialization.
+     *
+     * This handles:
+     * - Looking up the account and provider from cached metadata
+     * - Decrypting credentials via the Credential Engine
+     * - Setting up OAuth token refresh callbacks for providers like Box
+     *
+     * @param accountId - The FileStorageAccount ID to get a driver for
+     * @param contextUser - User context for credential decryption (used for on-demand init)
+     * @returns An initialized, ready-to-use FileStorageBase driver
+     * @throws Error if the account is not found or driver initialization fails
+     */
+    GetDriver(accountId: string, contextUser: UserInfo): Promise<FileStorageBase>;
+    /**
+     * Uploads a file to MJ Storage and creates an `MJ: Files` entity record.
+     *
+     * This is the primary high-level method for storing files. It handles:
+     * 1. Resolving which storage account to use
+     * 2. Initializing an authenticated driver
+     * 3. Uploading the file content
+     * 4. Creating the `MJ: Files` database record
+     *
+     * @param options - Upload options (content, fileName, mimeType, contextUser, etc.)
+     * @returns Upload result containing the file ID, storage path, and account/provider used
+     * @throws Error if no storage accounts are configured or the upload/save fails
+     *
+     * @example
+     * ```typescript
+     * const result = await FileStorageEngine.Instance.UploadFile({
+     *     content: Buffer.from(base64Data, 'base64'),
+     *     fileName: 'report.pdf',
+     *     mimeType: 'application/pdf',
+     *     contextUser,
+     *     storageAccountId: resolvedAccountId  // optional
+     * });
+     * console.log('Created file:', result.FileID);
+     * ```
+     */
+    UploadFile(options: UploadFileOptions): Promise<UploadFileResult>;
+}
+//# sourceMappingURL=FileStorageEngine.d.ts.map

package/dist/FileStorageEngine.d.ts.map

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

package/dist/FileStorageEngine.js

@@ -0,0 +1,301 @@
+import { LogError, Metadata } from '@memberjunction/core';
+import { BaseSingleton } from '@memberjunction/global';
+import { FileStorageEngineBase } from '@memberjunction/core-entities';
+import { initializeDriverWithAccountCredentials } from './util.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Engine
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Server-side file storage engine providing high-level operations for uploading,
+ * downloading, and managing files in MJ Storage.
+ *
+ * Follows the containment pattern (like AIEngine wraps AIEngineBase):
+ * - Delegates all metadata access to {@link FileStorageEngineBase}
+ * - Adds server-side methods: {@link UploadFile}, {@link GetDriver}, {@link ResolveStorageAccount}
+ *
+ * **Client-side code** should use `FileStorageEngineBase` from `@memberjunction/core-entities`
+ * for metadata-only access (accounts, providers, lookups).
+ *
+ * Usage:
+ * ```typescript
+ * import { FileStorageEngine } from '@memberjunction/storage';
+ *
+ * const engine = FileStorageEngine.Instance;
+ * await engine.Config(false, contextUser);
+ *
+ * // Upload a file
+ * const result = await engine.UploadFile({
+ *     content: Buffer.from(base64Data, 'base64'),
+ *     fileName: 'report.pdf',
+ *     mimeType: 'application/pdf',
+ *     contextUser
+ * });
+ *
+ * // Get a driver for direct operations
+ * const driver = await engine.GetDriver(accountId, contextUser);
+ * const objects = await driver.ListObjects('/');
+ * ```
+ */
+export class FileStorageEngine extends BaseSingleton {
+    constructor() {
+        super(...arguments);
+        // Loading state management (mirrors AIEngine pattern)
+        this._loaded = false;
+        this._loading = false;
+        this._loadingPromise = null;
+        // Server-specific state: cached, initialized drivers keyed by account ID
+        this._driverCache = new Map();
+    }
+    /**
+     * Returns the global singleton instance.
+     */
+    static get Instance() {
+        return super.getInstance();
+    }
+    // ─────────────────────────────────────────────────────────────────────
+    // Containment — delegate to FileStorageEngineBase
+    // ─────────────────────────────────────────────────────────────────────
+    /** Access to the underlying metadata-only engine. */
+    get Base() {
+        return FileStorageEngineBase.Instance;
+    }
+    /** Returns true if the engine has been configured. */
+    get Loaded() {
+        return this._loaded && this.Base.Loaded;
+    }
+    // --- Delegated metadata getters ---
+    /** Gets all file storage accounts (cached). */
+    get Accounts() {
+        return this.Base.Accounts;
+    }
+    /** Gets all file storage providers (cached). */
+    get Providers() {
+        return this.Base.Providers;
+    }
+    /** Gets all storage accounts combined with their provider details (cached). */
+    get AccountsWithProviders() {
+        return this.Base.AccountsWithProviders;
+    }
+    /** Whether any storage accounts are configured. */
+    get HasStorageAccounts() {
+        return this.Base.AccountsWithProviders.length > 0;
+    }
+    // --- Delegated lookup methods ---
+    /** Gets a file storage account by its ID. */
+    GetAccountById(accountId) {
+        return this.Base.GetAccountById(accountId);
+    }
+    /** Gets a file storage provider by its ID. */
+    GetProviderById(providerId) {
+        return this.Base.GetProviderById(providerId);
+    }
+    /** Gets a file storage account by its name (case-insensitive). */
+    GetAccountByName(name) {
+        return this.Base.GetAccountByName(name);
+    }
+    /** Gets file storage accounts linked to a given provider ID. */
+    GetAccountsByProviderID(providerId) {
+        return this.Base.GetAccountsByProviderID(providerId);
+    }
+    /** Gets a storage account with its provider details by account ID. */
+    GetAccountWithProvider(accountId) {
+        return this.Base.GetAccountWithProvider(accountId);
+    }
+    // ─────────────────────────────────────────────────────────────────────
+    // Configuration
+    // ─────────────────────────────────────────────────────────────────────
+    /**
+     * Configures the engine by loading the underlying metadata cache and any
+     * server-specific state. Safe to call multiple times — uses cached data
+     * unless `forceRefresh` is true. Concurrent callers share a single loading
+     * promise to avoid redundant work.
+     */
+    async Config(forceRefresh, contextUser, provider) {
+        if (this._loaded && !forceRefresh) {
+            return;
+        }
+        // If currently loading, return the existing promise so all callers wait together
+        if (this._loading && this._loadingPromise) {
+            return this._loadingPromise;
+        }
+        this._loading = true;
+        this._loadingPromise = this.innerLoad(forceRefresh, contextUser, provider);
+        try {
+            await this._loadingPromise;
+        }
+        finally {
+            this._loading = false;
+            this._loadingPromise = null;
+        }
+    }
+    /**
+     * Internal loading logic — separated for clean promise management.
+     * First ensures the base metadata cache is loaded, then loads any
+     * server-specific state (extensible for future needs).
+     */
+    async innerLoad(forceRefresh, contextUser, provider) {
+        try {
+            this._contextUser = contextUser;
+            // Load base metadata (accounts, providers)
+            await this.Base.Config(forceRefresh ?? false, contextUser, provider);
+            // Initialize drivers for all active accounts and cache them
+            await this.RefreshDriverCache();
+            this._loaded = true;
+        }
+        catch (error) {
+            LogError(error);
+            throw error;
+        }
+    }
+    /**
+     * Initializes storage drivers for all active accounts and caches them.
+     * Called automatically during Config(). Can also be called independently to
+     * re-initialize drivers without reloading metadata (e.g., after credential rotation).
+     * Accounts that fail to initialize are logged and skipped — they will fall back to
+     * on-demand initialization when GetDriver() is called.
+     */
+    async RefreshDriverCache() {
+        this._driverCache.clear();
+        const activeAccounts = this.Base.AccountsWithProviders.filter(a => a.provider.IsActive !== false);
+        if (activeAccounts.length === 0 || !this._contextUser) {
+            return;
+        }
+        const contextUser = this._contextUser;
+        const results = await Promise.allSettled(activeAccounts.map(async ({ account, provider: storageProvider }) => {
+            const driver = await initializeDriverWithAccountCredentials({
+                accountEntity: account,
+                providerEntity: storageProvider,
+                contextUser
+            });
+            this._driverCache.set(account.ID, driver);
+        }));
+        // Log failures but don't throw — failed accounts fall back to on-demand init
+        for (let i = 0; i < results.length; i++) {
+            if (results[i].status === 'rejected') {
+                const accountName = activeAccounts[i].account.Name;
+                const reason = results[i].reason;
+                LogError(`FileStorageEngine: failed to pre-initialize driver for account "${accountName}": ${reason}`);
+            }
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────────
+    // Server-side operations
+    // ─────────────────────────────────────────────────────────────────────
+    /**
+     * Resolves a storage account to use for file operations.
+     *
+     * Resolution logic:
+     * 1. If `accountId` is provided, returns that specific account
+     * 2. Otherwise, returns the first active account
+     * 3. If no active accounts exist, returns the first account regardless of active status
+     *
+     * @param accountId - Optional explicit account ID
+     * @returns The resolved account with provider, or null if no accounts are configured
+     */
+    ResolveStorageAccount(accountId) {
+        if (accountId) {
+            return this.Base.GetAccountWithProvider(accountId);
+        }
+        const accounts = this.Base.AccountsWithProviders;
+        if (accounts.length === 0)
+            return null;
+        return accounts.find(a => a.provider.IsActive !== false) ?? accounts[0];
+    }
+    /**
+     * Returns an authenticated storage driver for a given account.
+     *
+     * Checks the pre-initialized driver cache first (populated during Config()).
+     * If the account wasn't cached (e.g., it failed during Config or was added after),
+     * falls back to on-demand initialization.
+     *
+     * This handles:
+     * - Looking up the account and provider from cached metadata
+     * - Decrypting credentials via the Credential Engine
+     * - Setting up OAuth token refresh callbacks for providers like Box
+     *
+     * @param accountId - The FileStorageAccount ID to get a driver for
+     * @param contextUser - User context for credential decryption (used for on-demand init)
+     * @returns An initialized, ready-to-use FileStorageBase driver
+     * @throws Error if the account is not found or driver initialization fails
+     */
+    async GetDriver(accountId, contextUser) {
+        // Check pre-initialized cache first
+        const cached = this._driverCache.get(accountId);
+        if (cached) {
+            return cached;
+        }
+        // On-demand fallback: account wasn't in cache (failed init, added late, etc.)
+        const resolved = this.Base.GetAccountWithProvider(accountId);
+        if (!resolved) {
+            throw new Error(`FileStorageEngine.GetDriver: account '${accountId}' not found in cached metadata. Did you call Config() first?`);
+        }
+        const driver = await initializeDriverWithAccountCredentials({
+            accountEntity: resolved.account,
+            providerEntity: resolved.provider,
+            contextUser
+        });
+        // Cache it for future calls
+        this._driverCache.set(accountId, driver);
+        return driver;
+    }
+    /**
+     * Uploads a file to MJ Storage and creates an `MJ: Files` entity record.
+     *
+     * This is the primary high-level method for storing files. It handles:
+     * 1. Resolving which storage account to use
+     * 2. Initializing an authenticated driver
+     * 3. Uploading the file content
+     * 4. Creating the `MJ: Files` database record
+     *
+     * @param options - Upload options (content, fileName, mimeType, contextUser, etc.)
+     * @returns Upload result containing the file ID, storage path, and account/provider used
+     * @throws Error if no storage accounts are configured or the upload/save fails
+     *
+     * @example
+     * ```typescript
+     * const result = await FileStorageEngine.Instance.UploadFile({
+     *     content: Buffer.from(base64Data, 'base64'),
+     *     fileName: 'report.pdf',
+     *     mimeType: 'application/pdf',
+     *     contextUser,
+     *     storageAccountId: resolvedAccountId  // optional
+     * });
+     * console.log('Created file:', result.FileID);
+     * ```
+     */
+    async UploadFile(options) {
+        const { content, fileName, mimeType, contextUser, storageAccountId, provider } = options;
+        const md = provider ?? Metadata.Provider;
+        // 1. Resolve storage account
+        const resolved = this.ResolveStorageAccount(storageAccountId);
+        if (!resolved) {
+            throw new Error('FileStorageEngine.UploadFile: no file storage accounts configured. Cannot upload.');
+        }
+        // 2. Initialize driver
+        const driver = await this.GetDriver(resolved.account.ID, contextUser);
+        // 3. Upload
+        const pathPrefix = options.pathPrefix ?? `artifacts/${new Date().toISOString().slice(0, 10)}/${crypto.randomUUID()}`;
+        const storagePath = `${pathPrefix}/${fileName}`;
+        const uploaded = await driver.PutObject(storagePath, content, mimeType);
+        if (!uploaded) {
+            throw new Error(`FileStorageEngine.UploadFile: PutObject returned false for path '${storagePath}'`);
+        }
+        // 4. Create MJ: Files record
+        const fileEntity = await md.GetEntityObject('MJ: Files', contextUser);
+        fileEntity.Name = fileName;
+        fileEntity.ContentType = mimeType;
+        fileEntity.ProviderID = resolved.provider.ID;
+        fileEntity.ProviderKey = storagePath;
+        fileEntity.Status = 'Uploaded';
+        if (!(await fileEntity.Save())) {
+            throw new Error(`FileStorageEngine.UploadFile: failed to save MJ: Files record for '${fileName}'`);
+        }
+        return {
+            FileID: fileEntity.ID,
+            StoragePath: storagePath,
+            Account: resolved.account,
+            Provider: resolved.provider
+        };
+    }
+}
+//# sourceMappingURL=FileStorageEngine.js.map

package/dist/FileStorageEngine.js.map

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