@memberjunction/storage 2.30.0 → 2.32.0

package/dist/drivers/SharePointFileStorage.js

@@ -0,0 +1,490 @@
+"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.SharePointFileStorage = void 0;
+const microsoft_graph_client_1 = require("@microsoft/microsoft-graph-client");
+const global_1 = require("@memberjunction/global");
+const env = __importStar(require("env-var"));
+const mime = __importStar(require("mime-types"));
+const FileStorageBase_1 = require("../generic/FileStorageBase");
+/**
+ * Simple implementation of AuthenticationProvider that uses client credentials flow
+ */
+class ClientCredentialsAuthProvider {
+    constructor(clientId, clientSecret, tenantId) {
+        this.accessToken = null;
+        this.tokenExpiration = null;
+        this.clientId = clientId;
+        this.clientSecret = clientSecret;
+        this.tenantId = tenantId;
+        this.tokenEndpoint = `https://login.microsoftonline.com/${tenantId}/oauth2/v2.0/token`;
+    }
+    /**
+     * Get access token for the specified resource
+     */
+    async getAccessToken() {
+        if (this.accessToken && this.tokenExpiration && this.tokenExpiration > new Date()) {
+            return this.accessToken;
+        }
+        const data = new URLSearchParams({
+            client_id: this.clientId,
+            scope: 'https://graph.microsoft.com/.default',
+            client_secret: this.clientSecret,
+            grant_type: 'client_credentials'
+        });
+        const response = await fetch(this.tokenEndpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded'
+            },
+            body: data
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get access token: ${response.statusText}`);
+        }
+        const json = await response.json();
+        this.accessToken = json.access_token;
+        // Set token expiration time (subtract 5 minutes as a buffer)
+        const expiresIn = json.expires_in || 3600;
+        this.tokenExpiration = new Date(Date.now() + (expiresIn - 300) * 1000);
+        return this.accessToken;
+    }
+}
+let SharePointFileStorage = class SharePointFileStorage extends FileStorageBase_1.FileStorageBase {
+    constructor() {
+        super();
+        this.providerName = 'SharePoint';
+        const clientId = env.get('STORAGE_SHAREPOINT_CLIENT_ID').required().asString();
+        const clientSecret = env.get('STORAGE_SHAREPOINT_CLIENT_SECRET').required().asString();
+        const tenantId = env.get('STORAGE_SHAREPOINT_TENANT_ID').required().asString();
+        this._siteId = env.get('STORAGE_SHAREPOINT_SITE_ID').required().asString();
+        this._driveId = env.get('STORAGE_SHAREPOINT_DRIVE_ID').required().asString();
+        // Optionally set a root folder within the SharePoint drive
+        this._rootFolderId = env.get('STORAGE_SHAREPOINT_ROOT_FOLDER_ID').asString();
+        // Initialize Graph client with auth provider
+        const authProvider = new ClientCredentialsAuthProvider(clientId, clientSecret, tenantId);
+        this._client = microsoft_graph_client_1.Client.initWithMiddleware({
+            authProvider: authProvider
+        });
+    }
+    /**
+     * Get the parent item ID for a given path
+     *
+     * @param path The path to get the parent folder for
+     * @returns The parent folder ID
+     */
+    async _getParentFolderIdByPath(path) {
+        if (!path || path === '/' || path === '') {
+            return this._rootFolderId || 'root';
+        }
+        const pathParts = path.split('/').filter(p => p);
+        let currentFolderId = this._rootFolderId || 'root';
+        for (let i = 0; i < pathParts.length; i++) {
+            const folderName = pathParts[i];
+            const result = await this._client.api(`/drives/${this._driveId}/items/${currentFolderId}/children`)
+                .filter(`name eq '${folderName}' and folder ne null`)
+                .get();
+            if (!result.value || result.value.length === 0) {
+                throw new Error(`Folder not found: ${folderName}`);
+            }
+            currentFolderId = result.value[0].id;
+        }
+        return currentFolderId;
+    }
+    /**
+     * Get an item by path
+     *
+     * @param path The path of the item
+     * @returns The item
+     */
+    async _getItemByPath(path) {
+        if (!path || path === '/' || path === '') {
+            const itemId = this._rootFolderId || 'root';
+            return this._client.api(`/drives/${this._driveId}/items/${itemId}`).get();
+        }
+        // Normalize path
+        const normalizedPath = path.startsWith('/') ? path.substring(1) : path;
+        try {
+            // Try to get the item directly by path
+            const driveRoot = this._rootFolderId ?
+                `/drives/${this._driveId}/items/${this._rootFolderId}` :
+                `/drives/${this._driveId}/root`;
+            return await this._client.api(`${driveRoot}:/${normalizedPath}`).get();
+        }
+        catch (error) {
+            console.error('Error getting item by path', { path, error });
+            throw error;
+        }
+    }
+    /**
+     * Convert a SharePoint item to a StorageObjectMetadata object
+     */
+    _itemToMetadata(item) {
+        const isDirectory = !!item.folder;
+        const parentPath = item.parentReference?.path?.split(':').pop() || '';
+        // Remove any root folder prefix from the parent path if present
+        let path = parentPath;
+        if (this._rootFolderId && path.startsWith(`/drives/${this._driveId}/items/${this._rootFolderId}`)) {
+            path = path.replace(`/drives/${this._driveId}/items/${this._rootFolderId}`, '');
+        }
+        // Ensure path starts with / and remove leading slash for storage format
+        path = path.startsWith('/') ? path.substring(1) : path;
+        // For full paths, combine parent path with name
+        const fullPath = path ? `${path}/${item.name}` : item.name;
+        return {
+            name: item.name,
+            path,
+            fullPath,
+            size: item.size || 0,
+            contentType: item.file?.mimeType || mime.lookup(item.name) || 'application/octet-stream',
+            lastModified: new Date(item.lastModifiedDateTime),
+            isDirectory,
+            etag: item.eTag,
+            customMetadata: {}
+        };
+    }
+    /**
+     * Create a pre-authenticated upload URL is not directly supported in SharePoint/OneDrive
+     */
+    async CreatePreAuthUploadUrl(objectName) {
+        // SharePoint doesn't provide a way to get pre-authenticated upload URLs like S3
+        // Instead, we'll use the PutObject method for actual uploads
+        this.throwUnsupportedOperationError('CreatePreAuthUploadUrl');
+    }
+    /**
+     * Create a pre-authenticated download URL for an object
+     */
+    async CreatePreAuthDownloadUrl(objectName) {
+        try {
+            const item = await this._getItemByPath(objectName);
+            // Request a download URL - this is a time-limited URL
+            const downloadUrl = await this._client.api(`/drives/${this._driveId}/items/${item.id}/createLink`)
+                .post({
+                type: 'view',
+                scope: 'anonymous',
+                expirationDateTime: new Date(Date.now() + 10 * 60 * 1000).toISOString() // 10 minutes
+            });
+            return downloadUrl.link.webUrl;
+        }
+        catch (error) {
+            console.error('Error creating pre-auth download URL', { objectName, error });
+            throw new Error(`Failed to create download URL for: ${objectName}`);
+        }
+    }
+    /**
+     * Move an object from one location to another
+     */
+    async MoveObject(oldObjectName, newObjectName) {
+        try {
+            // Get the old item
+            const item = await this._getItemByPath(oldObjectName);
+            // Parse the new path to get the new parent folder and name
+            const newPathParts = newObjectName.split('/');
+            const newName = newPathParts.pop() || '';
+            const newParentPath = newPathParts.join('/');
+            // Get the new parent folder ID
+            const parentFolderId = await this._getParentFolderIdByPath(newParentPath);
+            // Move the item
+            await this._client.api(`/drives/${this._driveId}/items/${item.id}`)
+                .update({
+                name: newName,
+                parentReference: {
+                    id: parentFolderId
+                }
+            });
+            return true;
+        }
+        catch (error) {
+            console.error('Error moving object', { oldObjectName, newObjectName, error });
+            return false;
+        }
+    }
+    /**
+     * Delete an object
+     */
+    async DeleteObject(objectName) {
+        try {
+            const item = await this._getItemByPath(objectName);
+            // Delete the item
+            await this._client.api(`/drives/${this._driveId}/items/${item.id}`)
+                .delete();
+            return true;
+        }
+        catch (error) {
+            // Check if it's a "not found" error, which we'll consider a success for idempotency
+            if (error.statusCode === 404) {
+                return true;
+            }
+            console.error('Error deleting object', { objectName, error });
+            return false;
+        }
+    }
+    /**
+     * List objects in a given directory
+     */
+    async ListObjects(prefix, delimiter) {
+        try {
+            // Get the folder ID
+            const folder = await this._getItemByPath(prefix);
+            // List children
+            const children = await this._client.api(`/drives/${this._driveId}/items/${folder.id}/children`).get();
+            const objects = [];
+            const prefixes = [];
+            for (const item of children.value) {
+                if (item.folder) {
+                    // This is a folder/directory
+                    const folderPath = prefix ?
+                        (prefix.endsWith('/') ? `${prefix}${item.name}` : `${prefix}/${item.name}`) :
+                        item.name;
+                    prefixes.push(`${folderPath}/`);
+                }
+                // Add all items as objects (including folders)
+                objects.push(this._itemToMetadata(item));
+            }
+            return { objects, prefixes };
+        }
+        catch (error) {
+            console.error('Error listing objects', { prefix, error });
+            return { objects: [], prefixes: [] };
+        }
+    }
+    /**
+     * Create a directory
+     */
+    async CreateDirectory(directoryPath) {
+        try {
+            // Remove trailing slash if present
+            const normalizedPath = directoryPath.endsWith('/') ?
+                directoryPath.substring(0, directoryPath.length - 1) :
+                directoryPath;
+            // Parse the path to get the parent folder and new folder name
+            const pathParts = normalizedPath.split('/');
+            const folderName = pathParts.pop() || '';
+            const parentPath = pathParts.join('/');
+            // Get the parent folder ID
+            const parentFolderId = await this._getParentFolderIdByPath(parentPath);
+            // Create the folder
+            await this._client.api(`/drives/${this._driveId}/items/${parentFolderId}/children`)
+                .post({
+                name: folderName,
+                folder: {},
+                '@microsoft.graph.conflictBehavior': 'fail'
+            });
+            return true;
+        }
+        catch (error) {
+            console.error('Error creating directory', { directoryPath, error });
+            return false;
+        }
+    }
+    /**
+     * Delete a directory and optionally its contents
+     */
+    async DeleteDirectory(directoryPath, recursive = false) {
+        try {
+            // Remove trailing slash if present
+            const normalizedPath = directoryPath.endsWith('/') ?
+                directoryPath.substring(0, directoryPath.length - 1) :
+                directoryPath;
+            const folder = await this._getItemByPath(normalizedPath);
+            if (!recursive) {
+                // Check if folder is empty
+                const children = await this._client.api(`/drives/${this._driveId}/items/${folder.id}/children`).get();
+                if (children.value && children.value.length > 0) {
+                    throw new Error('Directory is not empty');
+                }
+            }
+            // Delete the folder (SharePoint will delete recursively by default)
+            await this._client.api(`/drives/${this._driveId}/items/${folder.id}`)
+                .delete();
+            return true;
+        }
+        catch (error) {
+            console.error('Error deleting directory', { directoryPath, recursive, error });
+            return false;
+        }
+    }
+    /**
+     * Get object metadata
+     */
+    async GetObjectMetadata(objectName) {
+        try {
+            const item = await this._getItemByPath(objectName);
+            return this._itemToMetadata(item);
+        }
+        catch (error) {
+            console.error('Error getting object metadata', { objectName, error });
+            throw new Error(`Object not found: ${objectName}`);
+        }
+    }
+    /**
+     * Get an object's contents
+     */
+    async GetObject(objectName) {
+        try {
+            const item = await this._getItemByPath(objectName);
+            // Get the content
+            const response = await fetch(item['@microsoft.graph.downloadUrl']);
+            if (!response.ok) {
+                throw new Error(`Failed to download item: ${response.statusText}`);
+            }
+            // Convert response to buffer
+            const arrayBuffer = await response.arrayBuffer();
+            return Buffer.from(arrayBuffer);
+        }
+        catch (error) {
+            console.error('Error getting object', { objectName, error });
+            throw new Error(`Failed to get object: ${objectName}`);
+        }
+    }
+    /**
+     * Upload an object directly
+     */
+    async PutObject(objectName, data, contentType, metadata) {
+        try {
+            // Parse the path to get the parent folder and filename
+            const pathParts = objectName.split('/');
+            const fileName = pathParts.pop() || '';
+            const parentPath = pathParts.join('/');
+            // Get the parent folder ID
+            const parentFolderId = await this._getParentFolderIdByPath(parentPath);
+            // Determine content type
+            const effectiveContentType = contentType || mime.lookup(objectName) || 'application/octet-stream';
+            if (data.length < 4 * 1024 * 1024) {
+                // For small files (< 4MB), use simple upload
+                await this._client.api(`/drives/${this._driveId}/items/${parentFolderId}:/${fileName}:/content`)
+                    .put(data);
+            }
+            else {
+                // For larger files, use upload session
+                // Create upload session
+                const uploadSession = await this._client.api(`/drives/${this._driveId}/items/${parentFolderId}:/${fileName}:/createUploadSession`)
+                    .post({
+                    item: {
+                        '@microsoft.graph.conflictBehavior': 'replace'
+                    }
+                });
+                // Upload the file in chunks (could be improved with parallel uploads)
+                const maxChunkSize = 60 * 1024 * 1024; // 60 MB chunks
+                for (let i = 0; i < data.length; i += maxChunkSize) {
+                    const chunk = data.slice(i, Math.min(i + maxChunkSize, data.length));
+                    const contentRange = `bytes ${i}-${i + chunk.length - 1}/${data.length}`;
+                    await fetch(uploadSession.uploadUrl, {
+                        method: 'PUT',
+                        headers: {
+                            'Content-Length': chunk.length.toString(),
+                            'Content-Range': contentRange
+                        },
+                        body: chunk
+                    });
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('Error putting object', { objectName, error });
+            return false;
+        }
+    }
+    /**
+     * Copy an object
+     */
+    async CopyObject(sourceObjectName, destinationObjectName) {
+        try {
+            // Get source item
+            const sourceItem = await this._getItemByPath(sourceObjectName);
+            // Parse destination path
+            const destPathParts = destinationObjectName.split('/');
+            const destName = destPathParts.pop() || '';
+            const destParentPath = destPathParts.join('/');
+            // Get destination parent folder ID
+            const destParentId = await this._getParentFolderIdByPath(destParentPath);
+            // Create a copy
+            await this._client.api(`/drives/${this._driveId}/items/${sourceItem.id}/copy`)
+                .post({
+                parentReference: {
+                    id: destParentId
+                },
+                name: destName
+            });
+            return true;
+        }
+        catch (error) {
+            console.error('Error copying object', { sourceObjectName, destinationObjectName, error });
+            return false;
+        }
+    }
+    /**
+     * Check if an object exists
+     */
+    async ObjectExists(objectName) {
+        try {
+            await this._getItemByPath(objectName);
+            return true;
+        }
+        catch (error) {
+            if (error.statusCode === 404) {
+                return false;
+            }
+            console.error('Error checking if object exists', { objectName, error });
+            return false;
+        }
+    }
+    /**
+     * Check if a directory exists
+     */
+    async DirectoryExists(directoryPath) {
+        try {
+            // Remove trailing slash if present
+            const normalizedPath = directoryPath.endsWith('/') ?
+                directoryPath.substring(0, directoryPath.length - 1) :
+                directoryPath;
+            const item = await this._getItemByPath(normalizedPath);
+            return !!item.folder;
+        }
+        catch (error) {
+            if (error.statusCode === 404) {
+                return false;
+            }
+            console.error('Error checking if directory exists', { directoryPath, error });
+            return false;
+        }
+    }
+};
+exports.SharePointFileStorage = SharePointFileStorage;
+exports.SharePointFileStorage = SharePointFileStorage = __decorate([
+    (0, global_1.RegisterClass)(FileStorageBase_1.FileStorageBase, 'SharePoint Storage'),
+    __metadata("design:paramtypes", [])
+], SharePointFileStorage);
+//# sourceMappingURL=SharePointFileStorage.js.map

package/dist/drivers/SharePointFileStorage.js.map

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

package/dist/generic/FileStorageBase.d.ts

@@ -1,12 +1,44 @@
+/// <reference types="node" />
 export type CreatePreAuthUploadUrlPayload = {
     UploadUrl: string;
     ProviderKey?: string | undefined;
 };
+export type StorageObjectMetadata = {
+    name: string;
+    path: string;
+    fullPath: string;
+    size: number;
+    contentType: string;
+    lastModified: Date;
+    isDirectory: boolean;
+    etag?: string;
+    cacheControl?: string;
+    customMetadata?: Record<string, string>;
+};
+export type StorageListResult = {
+    objects: StorageObjectMetadata[];
+    prefixes: string[];
+};
+/**
+ * Error thrown when a method is not supported by a storage provider
+ */
+export declare class UnsupportedOperationError extends Error {
+    constructor(methodName: string, providerName: string);
+}
 /**
  * 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 {
+    /**
+     * The name of this storage provider, used in error messages
+     */
+    protected abstract readonly providerName: string;
+    /**
+     * Helper method to throw an UnsupportedOperationError
+     * @param methodName The name of the method that is not supported
+     */
+    protected throwUnsupportedOperationError(methodName: string): never;
     /**
      * 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
@@ -140,5 +172,92 @@ export declare abstract class FileStorageBase {
      * deletion process.
      */
     abstract DeleteObject(objectName: string): Promise<boolean>;
+    /**
+     * Lists objects in a storage provider's system with the given prefix path.
+     *
+     * This method returns a list of objects and prefixes (directories) under the specified path.
+     * The method supports a hierarchical directory-like structure through the use of prefixes
+     * that can represent "folders" within the storage.
+     *
+     * @param prefix - The path prefix to list objects from. Use "/" for the root, or paths like "documents/"
+     *                 for specific directories.
+     * @param delimiter - The character used to group keys. Typically "/" is used to simulate directory structure.
+     *                    Defaults to "/".
+     * @returns A Promise that resolves to a StorageListResult containing both objects and prefixes (directories).
+     */
+    abstract ListObjects(prefix: string, delimiter?: string): Promise<StorageListResult>;
+    /**
+     * Creates a directory in the storage system.
+     *
+     * For storage systems that don't natively support directories, this may create a zero-byte object with
+     * a trailing delimiter to simulate a directory. For systems with native directory support, this will
+     * create an actual directory.
+     *
+     * @param directoryPath - The path of the directory to create. Should end with a delimiter (typically "/").
+     * @returns A Promise that resolves to a boolean indicating success.
+     */
+    abstract CreateDirectory(directoryPath: string): Promise<boolean>;
+    /**
+     * Deletes a directory and optionally all of its contents recursively.
+     *
+     * @param directoryPath - The path of the directory to delete.
+     * @param recursive - If true, deletes all contents recursively. If false and the directory is not empty,
+     *                    the operation will fail. Defaults to false.
+     * @returns A Promise that resolves to a boolean indicating success.
+     */
+    abstract DeleteDirectory(directoryPath: string, recursive?: boolean): Promise<boolean>;
+    /**
+     * Retrieves metadata for a specific object without downloading its contents.
+     *
+     * @param objectName - The name of the object to retrieve metadata for.
+     * @returns A Promise that resolves to a StorageObjectMetadata object containing the metadata.
+     *          If the object does not exist, the promise will be rejected.
+     */
+    abstract GetObjectMetadata(objectName: string): Promise<StorageObjectMetadata>;
+    /**
+     * Downloads an object's content as a Buffer.
+     *
+     * @param objectName - The name of the object to download.
+     * @returns A Promise that resolves to a Buffer containing the object's data.
+     *          If the object does not exist, the promise will be rejected.
+     */
+    abstract GetObject(objectName: string): Promise<Buffer>;
+    /**
+     * Uploads object data to the storage provider.
+     *
+     * This is a direct upload method that doesn't use a pre-authorized URL.
+     *
+     * @param objectName - The name to assign to the uploaded object.
+     * @param data - The Buffer containing the data to upload.
+     * @param contentType - Optional MIME type of the content.
+     * @param metadata - Optional custom metadata to associate with the object.
+     * @returns A Promise that resolves to a boolean indicating success.
+     */
+    abstract PutObject(objectName: string, data: Buffer, contentType?: string, metadata?: Record<string, string>): Promise<boolean>;
+    /**
+     * Copies an object within the storage system.
+     *
+     * Unlike MoveObject which removes the source object, this creates a copy while
+     * leaving the original intact.
+     *
+     * @param sourceObjectName - The name of the object to copy.
+     * @param destinationObjectName - The name to assign to the copied object.
+     * @returns A Promise that resolves to a boolean indicating success.
+     */
+    abstract CopyObject(sourceObjectName: string, destinationObjectName: string): Promise<boolean>;
+    /**
+     * Checks if an object exists in the storage system.
+     *
+     * @param objectName - The name of the object to check.
+     * @returns A Promise that resolves to a boolean indicating if the object exists.
+     */
+    abstract ObjectExists(objectName: string): Promise<boolean>;
+    /**
+     * Checks if a directory exists in the storage system.
+     *
+     * @param directoryPath - The path of the directory to check.
+     * @returns A Promise that resolves to a boolean indicating if the directory exists.
+     */
+    abstract DirectoryExists(directoryPath: string): Promise<boolean>;
 }
 //# sourceMappingURL=FileStorageBase.d.ts.map

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

@@ -1 +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;;;;;;;;;;OAUG;aACa,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;aACa,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CACnE"}
+{"version":3,"file":"FileStorageBase.d.ts","sourceRoot":"","sources":["../../src/generic/FileStorageBase.ts"],"names":[],"mappings":"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"}