@lossless.org/client 0.1.0

package/dist_ts/objectstorage/classes.connection.d.ts

@@ -0,0 +1,21 @@
+import { SmartBucket } from './classes.smartbucket.js';
+import type { ICapabilities, IOperationOptions, IReadiness } from '../core/interfaces.js';
+export interface IObjectStorageConnectionOptions {
+    backend: 'objectstorage' | 's3';
+    endpoint: string;
+    region?: string;
+    credentials: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    forcePathStyle?: boolean;
+    /** Existing bucket used by the read-only readiness probe; no bucket is created automatically. */
+    readinessBucket?: string;
+}
+export declare class ObjectStorageConnection extends SmartBucket {
+    readonly options: IObjectStorageConnectionOptions;
+    readonly backend: 'objectstorage' | 's3';
+    readonly capabilities: ICapabilities;
+    constructor(options: IObjectStorageConnectionOptions);
+    ready(options?: IOperationOptions): Promise<IReadiness>;
+}

package/dist_ts/objectstorage/classes.connection.js

@@ -0,0 +1,27 @@
+import { SmartBucket } from './classes.smartbucket.js';
+export class ObjectStorageConnection extends SmartBucket {
+    options;
+    backend;
+    capabilities;
+    constructor(options) {
+        const endpoint = new URL(options.endpoint);
+        if (!['http:', 'https:'].includes(endpoint.protocol) || endpoint.username || endpoint.password ||
+            endpoint.pathname !== '/' || endpoint.search || endpoint.hash) {
+            throw new TypeError('Object storage requires an HTTP(S) origin with separate credentials.');
+        }
+        super({ endpoint: endpoint.hostname, port: Number(endpoint.port || (endpoint.protocol === 'https:' ? 443 : 80)),
+            useSsl: endpoint.protocol === 'https:', accessKey: options.credentials.accessKeyId,
+            accessSecret: options.credentials.secretAccessKey, region: options.region ?? 'us-east-1' }, { forcePathStyle: options.forcePathStyle });
+        this.options = options;
+        this.backend = options.backend;
+        this.capabilities = Object.freeze({ backend: this.backend, transactions: 'unsupported', changeStreams: 'unsupported',
+            objectMetrics: 'unsupported', diskResidentScans: 'unknown' });
+    }
+    async ready(options = {}) {
+        if (!this.options.readinessBucket)
+            return { ready: false, reason: 'readiness_bucket_required' };
+        const result = await this.checkReadiness(this.options.readinessBucket, options);
+        return result.ready ? { ready: true } : { ready: false, reason: result.reason };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jb25uZWN0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvb2JqZWN0c3RvcmFnZS9jbGFzc2VzLmNvbm5lY3Rpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBYXZELE1BQU0sT0FBTyx1QkFBd0IsU0FBUSxXQUFXO0lBRzFCO0lBRlosT0FBTyxDQUF5QjtJQUNoQyxZQUFZLENBQWdCO0lBQzVDLFlBQTRCLE9BQXdDO1FBQ2xFLE1BQU0sUUFBUSxHQUFHLElBQUksR0FBRyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUMzQyxJQUFJLENBQUMsQ0FBQyxPQUFPLEVBQUUsUUFBUSxDQUFDLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsSUFBSSxRQUFRLENBQUMsUUFBUSxJQUFJLFFBQVEsQ0FBQyxRQUFRO1lBQzFGLFFBQVEsQ0FBQyxRQUFRLEtBQUssR0FBRyxJQUFJLFFBQVEsQ0FBQyxNQUFNLElBQUksUUFBUSxDQUFDLElBQUksRUFBRSxDQUFDO1lBQ2xFLE1BQU0sSUFBSSxTQUFTLENBQUMsc0VBQXNFLENBQUMsQ0FBQztRQUM5RixDQUFDO1FBQ0QsS0FBSyxDQUFDLEVBQUUsUUFBUSxFQUFFLFFBQVEsQ0FBQyxRQUFRLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxRQUFRLENBQUMsSUFBSSxJQUFJLENBQUMsUUFBUSxDQUFDLFFBQVEsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUM7WUFDN0csTUFBTSxFQUFFLFFBQVEsQ0FBQyxRQUFRLEtBQUssUUFBUSxFQUFFLFNBQVMsRUFBRSxPQUFPLENBQUMsV0FBVyxDQUFDLFdBQVc7WUFDbEYsWUFBWSxFQUFFLE9BQU8sQ0FBQyxXQUFXLENBQUMsZUFBZSxFQUFFLE1BQU0sRUFBRSxPQUFPLENBQUMsTUFBTSxJQUFJLFdBQVcsRUFBRSxFQUMxRixFQUFFLGNBQWMsRUFBRSxPQUFPLENBQUMsY0FBYyxFQUFFLENBQUMsQ0FBQztRQVRwQixZQUFPLEdBQVAsT0FBTyxDQUFpQztRQVVsRSxJQUFJLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUM7UUFDL0IsSUFBSSxDQUFDLFlBQVksR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsT0FBTyxFQUFFLElBQUksQ0FBQyxPQUFPLEVBQUUsWUFBWSxFQUFFLGFBQWEsRUFBRSxhQUFhLEVBQUUsYUFBYTtZQUNsSCxhQUFhLEVBQUUsYUFBYSxFQUFFLGlCQUFpQixFQUFFLFNBQVMsRUFBRSxDQUFDLENBQUM7SUFDbEUsQ0FBQztJQUNNLEtBQUssQ0FBQyxLQUFLLENBQUMsVUFBNkIsRUFBRTtRQUNoRCxJQUFJLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxlQUFlO1lBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLDJCQUEyQixFQUFFLENBQUM7UUFDaEcsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsZUFBZSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ2hGLE9BQU8sTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDO0lBQ2xGLENBQUM7Q0FDRiJ9

package/dist_ts/objectstorage/classes.directory.d.ts

@@ -0,0 +1,124 @@
+import * as plugins from './plugins.js';
+import { Bucket } from './classes.bucket.js';
+import { File } from './classes.file.js';
+import type { IDirectoryFastPutStreamOptions } from './interfaces.js';
+export declare class Directory {
+    bucketRef: Bucket;
+    parentDirectoryRef: Directory;
+    name: string;
+    tree: string[];
+    files: string[];
+    folders: string[];
+    constructor(bucketRefArg: Bucket, parentDirectory: Directory, name: string);
+    /**
+     * returns an array of parent directories
+     */
+    getParentDirectories(): Directory[];
+    /**
+     * returns the directory level
+     */
+    getDirectoryLevel(): number;
+    /**
+     * updates the base path
+     */
+    getBasePath(): string;
+    /**
+     * gets a file by name
+     */
+    getFile(optionsArg: {
+        path: string;
+        createWithContents?: string | Buffer;
+        getFromTrash?: boolean;
+    }): Promise<File>;
+    /**
+     * Check if a file exists in this directory
+     */
+    fileExists(optionsArg: {
+        path: string;
+    }): Promise<boolean>;
+    /**
+     * Check if a subdirectory exists
+     */
+    directoryExists(dirNameArg: string): Promise<boolean>;
+    /**
+     * Collects all ListObjectsV2 pages for a prefix.
+     */
+    private listObjectsV2AllPages;
+    /**
+     * lists all files
+     */
+    listFiles(): Promise<File[]>;
+    /**
+     * lists all folders
+     */
+    listDirectories(): Promise<Directory[]>;
+    /**
+     * gets an array that has all objects with a certain prefix
+     */
+    getTreeArray(): Promise<plugins.s3._Object[] | undefined>;
+    /**
+     * gets a sub directory by name
+     */
+    getSubDirectoryByName(dirNameArg: string, optionsArg?: {
+        /**
+         * in object storage a directory does not exist if it is empty
+         * this option returns a directory even if it is empty
+         */
+        getEmptyDirectory?: boolean;
+        /**
+         * in object storage a directory does not exist if it is empty
+         * this option creates a directory even if it is empty using a initializer file
+         */
+        createWithInitializerFile?: boolean;
+        /**
+         * if the path is a file path, it will be treated as a file and the parent directory will be returned
+         */
+        couldBeFilePath?: boolean;
+    }): Promise<Directory>;
+    /**
+     * moves the directory
+     */
+    move(): Promise<void>;
+    /**
+     * creates an empty file within this directory
+     * @param relativePathArg
+     */
+    createEmptyFile(relativePathArg: string): Promise<File>;
+    fastPut(optionsArg: {
+        path: string;
+        contents: string | Buffer;
+    }): Promise<void>;
+    fastGet(optionsArg: {
+        path: string;
+    }): Promise<Buffer<ArrayBufferLike>>;
+    fastGetStream(optionsArg: {
+        path: string;
+        signal?: AbortSignal;
+    }, typeArg: 'webstream'): Promise<ReadableStream>;
+    fastGetStream(optionsArg: {
+        path: string;
+        signal?: AbortSignal;
+    }, typeArg: 'nodestream'): Promise<plugins.stream.Readable>;
+    /**
+     * fast put stream
+     */
+    fastPutStream(optionsArg: IDirectoryFastPutStreamOptions): Promise<void>;
+    /**
+     * removes a file within the directory
+     * uses file class to make sure effects for metadata etc. are handled correctly
+     * @param optionsArg
+     */
+    fastRemove(optionsArg: {
+        path: string;
+        /**
+         * wether the file should be placed into trash. Default is false.
+         */
+        mode?: 'permanent' | 'trash';
+    }): Promise<void>;
+    /**
+     * deletes the directory with all its contents
+     */
+    delete(optionsArg: {
+        mode?: 'permanent' | 'trash';
+    }): Promise<void>;
+}

package/dist_ts/objectstorage/classes.directory.js

@@ -0,0 +1,335 @@
+// classes.directory.ts
+import * as plugins from './plugins.js';
+import { Bucket } from './classes.bucket.js';
+import { File } from './classes.file.js';
+import * as helpers from './helpers.js';
+export class Directory {
+    bucketRef;
+    parentDirectoryRef;
+    name;
+    tree;
+    files;
+    folders;
+    constructor(bucketRefArg, parentDirectory, name) {
+        this.bucketRef = bucketRefArg;
+        this.parentDirectoryRef = parentDirectory;
+        this.name = name;
+    }
+    /**
+     * returns an array of parent directories
+     */
+    getParentDirectories() {
+        let parentDirectories = [];
+        if (this.parentDirectoryRef) {
+            parentDirectories.push(this.parentDirectoryRef);
+            parentDirectories = parentDirectories.concat(this.parentDirectoryRef.getParentDirectories());
+        }
+        return parentDirectories;
+    }
+    /**
+     * returns the directory level
+     */
+    getDirectoryLevel() {
+        return this.getParentDirectories().length;
+    }
+    /**
+     * updates the base path
+     */
+    getBasePath() {
+        const parentDirectories = this.getParentDirectories();
+        let basePath = '';
+        for (const parentDir of parentDirectories) {
+            if (!parentDir.name && !basePath) {
+                basePath = this.name + '/';
+                continue;
+            }
+            if (parentDir.name && !basePath) {
+                basePath = parentDir.name + '/' + this.name + '/';
+                continue;
+            }
+            if (parentDir.name && basePath) {
+                basePath = parentDir.name + '/' + basePath;
+                continue;
+            }
+        }
+        return basePath;
+    }
+    /**
+     * gets a file by name
+     */
+    async getFile(optionsArg) {
+        const pathDescriptor = {
+            directory: this,
+            path: optionsArg.path,
+        };
+        const exists = await this.bucketRef.fastExists({
+            path: await helpers.reducePathDescriptorToPath(pathDescriptor),
+        });
+        if (!exists && optionsArg.getFromTrash) {
+            const trash = await this.bucketRef.getTrash();
+            const trashedFile = await trash.getTrashedFileByOriginalName(pathDescriptor);
+            return trashedFile;
+        }
+        if (!exists && !optionsArg.createWithContents) {
+            throw new Error(`File not found at path '${optionsArg.path}'`);
+        }
+        if (!exists && optionsArg.createWithContents) {
+            await File.create({
+                directory: this,
+                name: optionsArg.path,
+                contents: optionsArg.createWithContents,
+            });
+        }
+        return new File({
+            directoryRefArg: this,
+            fileName: optionsArg.path,
+        });
+    }
+    /**
+     * Check if a file exists in this directory
+     */
+    async fileExists(optionsArg) {
+        const pathDescriptor = {
+            directory: this,
+            path: optionsArg.path,
+        };
+        return this.bucketRef.fastExists({
+            path: await helpers.reducePathDescriptorToPath(pathDescriptor),
+        });
+    }
+    /**
+     * Check if a subdirectory exists
+     */
+    async directoryExists(dirNameArg) {
+        const directories = await this.listDirectories();
+        return directories.some(dir => dir.name === dirNameArg);
+    }
+    /**
+     * Collects all ListObjectsV2 pages for a prefix.
+     */
+    async listObjectsV2AllPages(prefix, delimiter) {
+        const allContents = [];
+        const allCommonPrefixes = [];
+        let continuationToken;
+        do {
+            const command = new plugins.s3.ListObjectsV2Command({
+                Bucket: this.bucketRef.name,
+                Prefix: prefix,
+                Delimiter: delimiter,
+                ContinuationToken: continuationToken,
+            });
+            const response = await this.bucketRef.smartbucketRef.storageClient.send(command);
+            if (response.Contents) {
+                allContents.push(...response.Contents);
+            }
+            if (response.CommonPrefixes) {
+                allCommonPrefixes.push(...response.CommonPrefixes);
+            }
+            continuationToken = response.IsTruncated ? response.NextContinuationToken : undefined;
+        } while (continuationToken);
+        return { contents: allContents, commonPrefixes: allCommonPrefixes };
+    }
+    /**
+     * lists all files
+     */
+    async listFiles() {
+        const { contents } = await this.listObjectsV2AllPages(this.getBasePath(), '/');
+        const fileArray = [];
+        contents.forEach((item) => {
+            if (item.Key && !item.Key.endsWith('/')) {
+                const subtractedPath = item.Key.replace(this.getBasePath(), '');
+                if (!subtractedPath.includes('/')) {
+                    fileArray.push(new File({
+                        directoryRefArg: this,
+                        fileName: subtractedPath,
+                    }));
+                }
+            }
+        });
+        return fileArray;
+    }
+    /**
+     * lists all folders
+     */
+    async listDirectories() {
+        try {
+            const { commonPrefixes } = await this.listObjectsV2AllPages(this.getBasePath(), '/');
+            const directoryArray = [];
+            if (commonPrefixes) {
+                commonPrefixes.forEach((item) => {
+                    if (item.Prefix) {
+                        const subtractedPath = item.Prefix.replace(this.getBasePath(), '');
+                        if (subtractedPath.endsWith('/')) {
+                            const dirName = subtractedPath.slice(0, -1);
+                            // Ensure the directory name is not empty (which would indicate the base directory itself)
+                            if (dirName) {
+                                directoryArray.push(new Directory(this.bucketRef, this, dirName));
+                            }
+                        }
+                    }
+                });
+            }
+            return directoryArray;
+        }
+        catch (error) {
+            console.error('Error listing directories:', error);
+            throw error;
+        }
+    }
+    /**
+     * gets an array that has all objects with a certain prefix
+     */
+    async getTreeArray() {
+        const command = new plugins.s3.ListObjectsV2Command({
+            Bucket: this.bucketRef.name,
+            Prefix: this.getBasePath(),
+            Delimiter: '/',
+        });
+        const response = await this.bucketRef.smartbucketRef.storageClient.send(command);
+        return response.Contents;
+    }
+    /**
+     * gets a sub directory by name
+     */
+    async getSubDirectoryByName(dirNameArg, optionsArg = {}) {
+        const dirNameArray = dirNameArg.split('/').filter(str => str.trim() !== "");
+        optionsArg = {
+            getEmptyDirectory: false,
+            createWithInitializerFile: false,
+            ...optionsArg,
+        };
+        const getDirectory = async (directoryArg, dirNameToSearch, isFinalDirectory) => {
+            const directories = await directoryArg.listDirectories();
+            let returnDirectory = directories.find((directory) => {
+                return directory.name === dirNameToSearch;
+            });
+            if (returnDirectory) {
+                return returnDirectory;
+            }
+            if (optionsArg.getEmptyDirectory || optionsArg.createWithInitializerFile) {
+                returnDirectory = new Directory(this.bucketRef, directoryArg, dirNameToSearch);
+            }
+            if (isFinalDirectory && optionsArg.createWithInitializerFile) {
+                returnDirectory?.createEmptyFile('00init.txt');
+            }
+            return returnDirectory || null;
+        };
+        if (optionsArg.couldBeFilePath) {
+            const baseDirectory = await this.bucketRef.getBaseDirectory();
+            const existingFile = await baseDirectory.getFile({
+                path: dirNameArg,
+            });
+            if (existingFile) {
+                const adjustedPath = dirNameArg.substring(0, dirNameArg.lastIndexOf('/'));
+                return this.getSubDirectoryByName(adjustedPath);
+            }
+        }
+        let wantedDirectory = null;
+        let counter = 0;
+        for (const dirNameToSearch of dirNameArray) {
+            counter++;
+            const directoryToSearchIn = wantedDirectory ? wantedDirectory : this;
+            wantedDirectory = await getDirectory(directoryToSearchIn, dirNameToSearch, counter === dirNameArray.length);
+        }
+        if (!wantedDirectory) {
+            throw new Error(`Directory not found at path '${dirNameArg}'`);
+        }
+        return wantedDirectory;
+    }
+    /**
+     * moves the directory
+     */
+    async move() {
+        // TODO
+        throw new Error('Moving a directory is not yet implemented');
+    }
+    /**
+     * creates an empty file within this directory
+     * @param relativePathArg
+     */
+    async createEmptyFile(relativePathArg) {
+        const emptyFile = await File.create({
+            directory: this,
+            name: relativePathArg,
+            contents: '',
+        });
+        return emptyFile;
+    }
+    // file operations
+    async fastPut(optionsArg) {
+        const path = plugins.path.join(this.getBasePath(), optionsArg.path);
+        await this.bucketRef.fastPut({
+            path,
+            contents: optionsArg.contents,
+        });
+    }
+    async fastGet(optionsArg) {
+        const path = plugins.path.join(this.getBasePath(), optionsArg.path);
+        const result = await this.bucketRef.fastGet({
+            path,
+        });
+        return result;
+    }
+    /**
+     * fastGetStream
+     * @param optionsArg
+     * @returns
+     */
+    async fastGetStream(optionsArg, typeArg) {
+        const path = plugins.path.join(this.getBasePath(), optionsArg.path);
+        const result = await this.bucketRef.fastGetStream({
+            path,
+            signal: optionsArg.signal,
+        }, typeArg);
+        return result;
+    }
+    /**
+     * fast put stream
+     */
+    async fastPutStream(optionsArg) {
+        const path = plugins.path.join(this.getBasePath(), optionsArg.path);
+        await this.bucketRef.fastPutStream({
+            path,
+            readableStream: optionsArg.stream,
+            contentLength: optionsArg.contentLength,
+            signal: optionsArg.signal,
+        });
+    }
+    /**
+     * removes a file within the directory
+     * uses file class to make sure effects for metadata etc. are handled correctly
+     * @param optionsArg
+     */
+    async fastRemove(optionsArg) {
+        const file = await this.getFile({
+            path: optionsArg.path,
+        });
+        await file.delete({
+            mode: optionsArg.mode ? optionsArg.mode : 'permanent',
+        });
+    }
+    /**
+     * deletes the directory with all its contents
+     */
+    async delete(optionsArg) {
+        const deleteDirectory = async (directoryArg) => {
+            const childDirectories = await directoryArg.listDirectories();
+            if (childDirectories.length === 0) {
+                console.log('Directory empty! Path complete!');
+            }
+            else {
+                for (const childDir of childDirectories) {
+                    await deleteDirectory(childDir);
+                }
+            }
+            const files = await directoryArg.listFiles();
+            for (const file of files) {
+                await file.delete({
+                    mode: optionsArg.mode ? optionsArg.mode : 'permanent',
+                });
+            }
+        };
+        await deleteDirectory(this);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kaXJlY3RvcnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9vYmplY3RzdG9yYWdlL2NsYXNzZXMuZGlyZWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHVCQUF1QjtBQUV2QixPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDN0MsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ3pDLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBR3hDLE1BQU0sT0FBTyxTQUFTO0lBQ2IsU0FBUyxDQUFTO0lBQ2xCLGtCQUFrQixDQUFZO0lBQzlCLElBQUksQ0FBUztJQUViLElBQUksQ0FBWTtJQUNoQixLQUFLLENBQVk7SUFDakIsT0FBTyxDQUFZO0lBRTFCLFlBQVksWUFBb0IsRUFBRSxlQUEwQixFQUFFLElBQVk7UUFDeEUsSUFBSSxDQUFDLFNBQVMsR0FBRyxZQUFZLENBQUM7UUFDOUIsSUFBSSxDQUFDLGtCQUFrQixHQUFHLGVBQWUsQ0FBQztRQUMxQyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztJQUNuQixDQUFDO0lBRUQ7O09BRUc7SUFDSSxvQkFBb0I7UUFDekIsSUFBSSxpQkFBaUIsR0FBZ0IsRUFBRSxDQUFDO1FBQ3hDLElBQUksSUFBSSxDQUFDLGtCQUFrQixFQUFFLENBQUM7WUFDNUIsaUJBQWlCLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDO1lBQ2hELGlCQUFpQixHQUFHLGlCQUFpQixDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsa0JBQWtCLENBQUMsb0JBQW9CLEVBQUUsQ0FBQyxDQUFDO1FBQy9GLENBQUM7UUFDRCxPQUFPLGlCQUFpQixDQUFDO0lBQzNCLENBQUM7SUFFRDs7T0FFRztJQUNJLGlCQUFpQjtRQUN0QixPQUFPLElB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

package/dist_ts/objectstorage/classes.exactpathpurgeerror.d.ts

@@ -0,0 +1,5 @@
+import type { IExactPathPurgeFailureState } from './interfaces.js';
+export declare class ExactPathPurgeError extends Error {
+    readonly state: IExactPathPurgeFailureState;
+    constructor(stateArg: IExactPathPurgeFailureState, causeArg: unknown);
+}

package/dist_ts/objectstorage/classes.exactpathpurgeerror.js

@@ -0,0 +1,18 @@
+const phaseMessages = {
+    capability: 'The exact-path purge capability is invalid or stale.',
+    inventory: 'The exact path could not be inventoried safely.',
+    consistency: 'The exact path changed before purge mutation.',
+    delete: 'The exact path could not be deleted safely.',
+    verification: 'The exact-path purge could not be verified.',
+};
+export class ExactPathPurgeError extends Error {
+    state;
+    constructor(stateArg, causeArg) {
+        super(phaseMessages[stateArg.phase], {
+            cause: causeArg,
+        });
+        this.name = 'ExactPathPurgeError';
+        this.state = stateArg;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5leGFjdHBhdGhwdXJnZWVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvb2JqZWN0c3RvcmFnZS9jbGFzc2VzLmV4YWN0cGF0aHB1cmdlZXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBS0EsTUFBTSxhQUFhLEdBQWdEO0lBQ2pFLFVBQVUsRUFBRSxzREFBc0Q7SUFDbEUsU0FBUyxFQUFFLGlEQUFpRDtJQUM1RCxXQUFXLEVBQUUsK0NBQStDO0lBQzVELE1BQU0sRUFBRSw2Q0FBNkM7SUFDckQsWUFBWSxFQUFFLDZDQUE2QztDQUM1RCxDQUFDO0FBRUYsTUFBTSxPQUFPLG1CQUFvQixTQUFRLEtBQUs7SUFDNUIsS0FBSyxDQUE4QjtJQUVuRCxZQUFZLFFBQXFDLEVBQUUsUUFBaUI7UUFDbEUsS0FBSyxDQUFDLGFBQWEsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUU7WUFDbkMsS0FBSyxFQUFFLFFBQVE7U0FDaEIsQ0FBQyxDQUFDO1FBQ0gsSUFBSSxDQUFDLElBQUksR0FBRyxxQkFBcUIsQ0FBQztRQUNsQyxJQUFJLENBQUMsS0FBSyxHQUFHLFFBQVEsQ0FBQztJQUN4QixDQUFDO0NBQ0YifQ==

package/dist_ts/objectstorage/classes.exactuploaderror.d.ts

@@ -0,0 +1,5 @@
+import type { IExactUploadFailureState } from './interfaces.js';
+export declare class ExactUploadError extends Error {
+    readonly state: IExactUploadFailureState;
+    constructor(stateArg: IExactUploadFailureState, causeArg: unknown);
+}

package/dist_ts/objectstorage/classes.exactuploaderror.js

@@ -0,0 +1,19 @@
+const phaseMessages = {
+    capability: 'The exact upload capability is invalid or stale.',
+    source: 'The exact upload source could not be consumed.',
+    'put-zero': 'The conditional zero-byte object upload failed.',
+    'create-multipart': 'The multipart upload could not be created.',
+    'upload-part': 'A multipart upload part failed.',
+    'complete-multipart': 'The conditional multipart completion failed.',
+};
+export class ExactUploadError extends Error {
+    state;
+    constructor(stateArg, causeArg) {
+        super(phaseMessages[stateArg.phase], {
+            cause: causeArg,
+        });
+        this.name = 'ExactUploadError';
+        this.state = stateArg;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5leGFjdHVwbG9hZGVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvb2JqZWN0c3RvcmFnZS9jbGFzc2VzLmV4YWN0dXBsb2FkZXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBS0EsTUFBTSxhQUFhLEdBQTZDO0lBQzlELFVBQVUsRUFBRSxrREFBa0Q7SUFDOUQsTUFBTSxFQUFFLGdEQUFnRDtJQUN4RCxVQUFVLEVBQUUsaURBQWlEO0lBQzdELGtCQUFrQixFQUFFLDRDQUE0QztJQUNoRSxhQUFhLEVBQUUsaUNBQWlDO0lBQ2hELG9CQUFvQixFQUFFLDhDQUE4QztDQUNyRSxDQUFDO0FBRUYsTUFBTSxPQUFPLGdCQUFpQixTQUFRLEtBQUs7SUFDekIsS0FBSyxDQUEyQjtJQUVoRCxZQUFZLFFBQWtDLEVBQUUsUUFBaUI7UUFDL0QsS0FBSyxDQUFDLGFBQWEsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUU7WUFDbkMsS0FBSyxFQUFFLFFBQVE7U0FDaEIsQ0FBQyxDQUFDO1FBQ0gsSUFBSSxDQUFDLElBQUksR0FBRyxrQkFBa0IsQ0FBQztRQUMvQixJQUFJLENBQUMsS0FBSyxHQUFHLFFBQVEsQ0FBQztJQUN4QixDQUFDO0NBQ0YifQ==

package/dist_ts/objectstorage/classes.file.d.ts

@@ -0,0 +1,91 @@
+import * as plugins from './plugins.js';
+import * as interfaces from './interfaces.js';
+import { Directory } from './classes.directory.js';
+import { MetaData } from './classes.metadata.js';
+/**
+ * represents a file in a directory
+ */
+export declare class File {
+    /**
+     * creates a file in draft mode
+     * you need to call .save() to store it in object storage
+     * @param optionsArg
+     */
+    static create(optionsArg: {
+        directory: Directory;
+        name: string;
+        contents: Buffer | string | plugins.stream.Readable;
+        /**
+         * if contents are of type string, you can specify the encoding here
+         */
+        encoding?: 'utf8' | 'binary';
+    }): Promise<File>;
+    parentDirectoryRef: Directory;
+    name: string;
+    /**
+     * get the full path to the file
+     * @returns the full path to the file
+     */
+    getBasePath(): string;
+    constructor(optionsArg: {
+        directoryRefArg: Directory;
+        fileName: string;
+    });
+    getContentsAsString(): Promise<string>;
+    getContents(): Promise<Buffer>;
+    getReadStream(typeArg: 'webstream'): Promise<ReadableStream>;
+    getReadStream(typeArg: 'nodestream'): Promise<plugins.stream.Readable>;
+    /**
+     * deletes this file
+     */
+    delete(optionsArg?: {
+        mode: 'trash' | 'permanent';
+    }): Promise<void>;
+    /**
+     * restores
+     */
+    restore(optionsArg?: {
+        useOriginalPath?: boolean;
+        toPath?: string;
+        overwrite?: boolean;
+    }): Promise<void>;
+    /**
+     * allows locking the file
+     * @param optionsArg
+     */
+    lock(optionsArg?: {
+        timeoutMillis?: number;
+    }): Promise<void>;
+    /**
+     * actively unlocks a file
+     *
+     */
+    unlock(optionsArg?: {
+        /**
+         * unlock the file even if not locked from this instance
+         */
+        force?: boolean;
+    }): Promise<void>;
+    updateWithContents(optionsArg: {
+        contents: Buffer | string | plugins.stream.Readable | ReadableStream;
+        encoding?: 'utf8' | 'binary';
+    }): Promise<void>;
+    /**
+     * moves the file to another directory
+     */
+    move(pathDescriptorArg: interfaces.IPathDecriptor): Promise<void>;
+    hasMetaData(): Promise<boolean>;
+    /**
+     * allows updating the metadata of a file
+     * @param updatedMetadata
+     */
+    getMetaData(): Promise<MetaData>;
+    /**
+     * gets the contents as json
+     */
+    getJsonData(): Promise<any>;
+    writeJsonData(dataArg: any): Promise<void>;
+    getMagicBytes(optionsArg: {
+        length: number;
+    }): Promise<Buffer>;
+}