@ocfl/ocfl 0.4.0 → 1.0.0-beta.1

package/dist/store.js.map

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

package/dist/transaction.d.ts

@@ -0,0 +1,155 @@
+import type { Writable } from 'node:stream';
+import type { OcflObjectInventoryMut } from './inventory.ts';
+import type { OcflObject } from './object.ts';
+import type { OcflStore, WriteFileData } from './store.ts';
+export interface CommitOptions {
+    /** Freeform text used to record the rationale for creating the current version */
+    message?: string | undefined;
+    /** Identify the user or agent that created the current Version */
+    user?: {
+        /** Any readable name of the user, e.g., a proper name, user ID, agent ID. */
+        name: string;
+        /** A URI: either a mailto URI [RFC6068] with the e-mail address of the user or a URL to a personal identifier, e.g., an ORCID iD. */
+        address?: string;
+    } | undefined;
+    /** If true, force to commit. Use it after a purge. */
+    force?: boolean | undefined;
+}
+export interface RemoveOptions {
+    /** If true, completely remove the content from all versions */
+    purge?: boolean | undefined;
+}
+type TrackedPromise<T> = Promise<T> & {
+    done?: boolean;
+};
+/**
+ * A Transaction represent an atomic update on an OCFL Object.
+ * When a transaction is commited, all changes are saved as a new version.
+ * This is a wrapper class to hide all the storage specific implementation.
+ */
+declare class OcflObjectTransaction {
+    /**
+     * Discard all the changes made in this transaction,
+     * @abstract
+     */
+    rollback(): Promise<void>;
+    /**
+     * Commit all the changes made in this transaction to the actual OCFL Object.
+     * @abstract
+     * @param options - Commit options. message and user will be included in the version entry of the inventory.json
+     */
+    commit(_options?: CommitOptions): Promise<void>;
+    /**
+     * Completely remove a file path and corresponding content from all versions of an OCFL Object.
+     * This is a special case that is not supported as part of regular OCFL versioning operations.
+     */
+    purge(logicalPath: string): Promise<void>;
+    /**
+     * Write data to a file at `logicalPath`
+     * @abstract
+     * @param logicalPath - A path relative to the object content directory
+     * @param data - Data to be written to the file
+     * @param options - The same options as https://nodejs.org/api/fs.html#fs_fs_writefile_file_data_options_callback
+     */
+    write(_logicalPath: string, _data: WriteFileData, _options?: object | string): Promise<void>;
+    /**
+     * Import content by recursively copying a file or directory from local file system to the
+     * OCFL Object content. For example, `object.import('/home/john/data/b','data/b')` will
+     * copy `/home/john/data/b` from the local filesystem to the content `data/b` in the OFCL Object.
+     * Set target to empty string ('') to copy a directory content to the object's content root.
+     * If target is not specified, the base name of the source will be used.
+     * For examples:
+     * To copy '/src/data' directory as 'data' use import('/src/data', 'data').
+     * To copy all files inside '/src/data' directory to the logical root, use import('/src/data', '').
+     * @abstract
+     * @param source - A path to a file or directory in the local filesystem to be copied
+     * @param target - A logical path in the OCFL Object content.
+     */
+    import(_source: string, _target?: string): Promise<void>;
+    /**
+     * Duplicate the logical path `source` as a different logical path `target`, both paths will then point
+     * to the same content path and bitstreams.
+     * @abstract
+     * @param source - The logical path to be copied
+     * @param target - The target logical path
+     */
+    copy(_source: string, _target: string): Promise<void>;
+    /**
+     * Changes the logical path of existing content. This is similar to move operation in file systems
+     * Unless renaming files that are not yet commited, this operation will NOT rename the actual file name referenced by the manifest.
+     * @abstract
+     */
+    rename(_source: string, _target: string): Promise<void>;
+    /**
+     * Alias of {@link OcflObjectTransaction.rename}
+     */
+    move(source: string, target: string): Promise<void>;
+    /**
+     * Remove a file or directory
+     * @abstract
+     * @param logicalPath - A path relative to the object content directory
+     */
+    remove(_logicalPath: string, _options?: RemoveOptions): Promise<void>;
+    /**
+     * Remove a file or directory. Alias of {@link OcflObjectTransaction.remove}
+     * @param logicalPath - A path relative to the object content directory
+     */
+    delete(logicalPath: string, options?: RemoveOptions): Promise<void>;
+    /**
+     * Makes content from a version earlier than the previous version available in the current version of an OCFL Object.
+     * @abstract
+     */
+    reinstate(_logicalPath: string, _versionName: string): Promise<number>;
+    /**
+     * Create a NodeJS writable stream
+     * @abstract
+     * @deprecated Use {@link OcflObjectTransaction.createWritable} instead
+     */
+    createWriteStream(_logicalPath: string, _options?: unknown): Promise<Writable>;
+    /**
+     * Create a writable stream
+     * @abstract
+     */
+    createWritable(_logicalPath: string, _options?: unknown): Promise<WritableStream>;
+}
+/**
+ * Base class for any transaction implementation on different storage backend
+ */
+declare class OcflObjectTransactionImpl extends OcflObjectTransaction {
+    _workspaceVersionPath: string;
+    _contentRoot: string;
+    _object: OcflObject;
+    _store: OcflStore;
+    _inventory: OcflObjectInventoryMut;
+    _createdDir: string;
+    _queue: TrackedPromise<unknown>[];
+    _committed: boolean;
+    constructor(ocflObject: OcflObject, ocflStore: OcflStore, inventory: OcflObjectInventoryMut, workspaceVersionPath: string, createdDir: string);
+    /**
+     * Create a new transaction instance.
+     */
+    static create(ocflObject: OcflObject, ocflStore: OcflStore, inventory: OcflObjectInventoryMut, workspacePath: string): Promise<OcflObjectTransactionImpl>;
+    _getRealPath(logicalPath: string): string;
+    rollback(): Promise<void>;
+    commit(options?: CommitOptions): Promise<void>;
+    _commit(options?: CommitOptions): Promise<void>;
+    createWritable(logicalPath: string, options?: unknown): Promise<WritableStream>;
+    write(logicalPath: string, data: WriteFileData, options?: object | string): Promise<void>;
+    /**
+     * Import a single file from source. This is a helper method for {@link OcflObjectTransaction.import | import()} method.
+     */
+    importFile(source: string, target: string): Promise<void>;
+    import(source: string, target?: string): Promise<void>;
+    copy(source: string, target: string): Promise<void>;
+    rename(source: string, target: string): Promise<void>;
+    reinstate(logicalPath: string, versionName: string): Promise<number>;
+    remove(logicalPath: string, options?: RemoveOptions): Promise<void>;
+    /**
+     * A function wrapper to provide safe mutating operation that
+     * will check if a transaction is already committed and track any unfinished promises.
+     */
+    _transact<T>(op: () => Promise<T>): Promise<T>;
+    private _track;
+}
+export { OcflObjectTransaction, OcflObjectTransactionImpl };
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

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

package/dist/transaction.js

@@ -0,0 +1,395 @@
+/** Models a set of ocfl object modifying operations as a transaction that is as close as atomic as possible */
+import path from 'node:path';
+import { OcflConstants } from './constants.js';
+import { OcflDigest } from './digest.js';
+import { isErrnoException, parallelize } from './utils.js';
+const { INVENTORY_NAME } = OcflConstants;
+/** Split the digests into the content digest and the remaining fixity digests */
+function splitDigests(digests, algorithm) {
+    const { [algorithm]: digest, ...fixity } = digests;
+    if (!digest) {
+        throw new Error(`Digest "${algorithm}" was not calculated.`);
+    }
+    return [digest, fixity];
+}
+/**
+ * A Transaction represent an atomic update on an OCFL Object.
+ * When a transaction is commited, all changes are saved as a new version.
+ * This is a wrapper class to hide all the storage specific implementation.
+ */
+class OcflObjectTransaction {
+    /**
+     * Discard all the changes made in this transaction,
+     * @abstract
+     */
+    async rollback() {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Commit all the changes made in this transaction to the actual OCFL Object.
+     * @abstract
+     * @param options - Commit options. message and user will be included in the version entry of the inventory.json
+     */
+    async commit(_options) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Completely remove a file path and corresponding content from all versions of an OCFL Object.
+     * This is a special case that is not supported as part of regular OCFL versioning operations.
+     */
+    async purge(logicalPath) {
+        return await this.remove(logicalPath, { purge: true });
+    }
+    /**
+     * Write data to a file at `logicalPath`
+     * @abstract
+     * @param logicalPath - A path relative to the object content directory
+     * @param data - Data to be written to the file
+     * @param options - The same options as https://nodejs.org/api/fs.html#fs_fs_writefile_file_data_options_callback
+     */
+    async write(_logicalPath, _data, _options) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Import content by recursively copying a file or directory from local file system to the
+     * OCFL Object content. For example, `object.import('/home/john/data/b','data/b')` will
+     * copy `/home/john/data/b` from the local filesystem to the content `data/b` in the OFCL Object.
+     * Set target to empty string ('') to copy a directory content to the object's content root.
+     * If target is not specified, the base name of the source will be used.
+     * For examples:
+     * To copy '/src/data' directory as 'data' use import('/src/data', 'data').
+     * To copy all files inside '/src/data' directory to the logical root, use import('/src/data', '').
+     * @abstract
+     * @param source - A path to a file or directory in the local filesystem to be copied
+     * @param target - A logical path in the OCFL Object content.
+     */
+    async import(_source, _target) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Duplicate the logical path `source` as a different logical path `target`, both paths will then point
+     * to the same content path and bitstreams.
+     * @abstract
+     * @param source - The logical path to be copied
+     * @param target - The target logical path
+     */
+    async copy(_source, _target) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Changes the logical path of existing content. This is similar to move operation in file systems
+     * Unless renaming files that are not yet commited, this operation will NOT rename the actual file name referenced by the manifest.
+     * @abstract
+     */
+    async rename(_source, _target) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Alias of {@link OcflObjectTransaction.rename}
+     */
+    async move(source, target) {
+        return this.rename(source, target);
+    }
+    /**
+     * Remove a file or directory
+     * @abstract
+     * @param logicalPath - A path relative to the object content directory
+     */
+    async remove(_logicalPath, _options) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Remove a file or directory. Alias of {@link OcflObjectTransaction.remove}
+     * @param logicalPath - A path relative to the object content directory
+     */
+    async delete(logicalPath, options) {
+        return this.remove(logicalPath, options);
+    }
+    /**
+     * Makes content from a version earlier than the previous version available in the current version of an OCFL Object.
+     * @abstract
+     */
+    async reinstate(_logicalPath, _versionName) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Create a NodeJS writable stream
+     * @abstract
+     * @deprecated Use {@link OcflObjectTransaction.createWritable} instead
+     */
+    async createWriteStream(_logicalPath, _options) {
+        throw new Error('Not Implemented');
+    }
+    /**
+     * Create a writable stream
+     * @abstract
+     */
+    async createWritable(_logicalPath, _options) {
+        throw new Error('Not Implemented');
+    }
+}
+/**
+ * Base class for any transaction implementation on different storage backend
+ */
+class OcflObjectTransactionImpl extends OcflObjectTransaction {
+    _workspaceVersionPath;
+    _contentRoot;
+    _object;
+    _store;
+    _inventory;
+    _createdDir;
+    _queue = [];
+    _committed = false;
+    constructor(ocflObject, ocflStore, inventory, workspaceVersionPath, createdDir) {
+        super();
+        this._workspaceVersionPath = workspaceVersionPath;
+        this._contentRoot = path.join(workspaceVersionPath, inventory.contentDirectory);
+        this._object = ocflObject;
+        this._store = ocflStore;
+        this._inventory = inventory;
+        this._createdDir = createdDir;
+    }
+    /**
+     * Create a new transaction instance.
+     */
+    static async create(ocflObject, ocflStore, inventory, workspacePath) {
+        // @todo: validate existing object
+        const workspaceVersionPath = path.join(workspacePath, inventory.head);
+        if (await ocflStore.exists(workspaceVersionPath)) {
+            throw new Error('Uncommitted changes detected. Object is being updated by other process or there has been a failed update attempt');
+        }
+        await ocflStore.mkdir(workspacePath);
+        return new OcflObjectTransactionImpl(ocflObject, ocflStore, inventory, workspaceVersionPath, workspacePath);
+    }
+    _getRealPath(logicalPath) {
+        const p = path.normalize(logicalPath);
+        if (p.startsWith('/') || p.startsWith('..')) {
+            throw new Error('logicalPath must be a relative path without `..`');
+        }
+        return path.join(this._contentRoot, p);
+    }
+    async rollback() {
+        if (!this._committed) {
+            await Promise.all(this._queue);
+            if (this._createdDir) {
+                await this._store.remove(this._createdDir);
+            }
+            this._committed = true;
+        }
+    }
+    async commit(options) {
+        if (!this._committed) {
+            const count = this._queue.filter((p) => !p.done).length;
+            if (count > 0) {
+                await this.rollback();
+                throw new Error(`Unfinished operations detected (${count}). Make sure that updater callback is async function and there are no floating promises inside.`);
+            }
+            // if there is no changes, abort commit
+            if (!options?.force && !this._inventory.isChanged) {
+                return await this.rollback();
+            }
+            await this._commit(options);
+            this._object._setInventory(this._inventory);
+            this._committed = true;
+        }
+    }
+    async _commit(options = {}) {
+        const inventory = this._inventory;
+        const digestAlgorithm = inventory.digestAlgorithm;
+        // set commit info
+        inventory.created = new Date().toISOString();
+        if (options.message) {
+            inventory.message = options.message;
+        }
+        if (options.user) {
+            inventory.user = options.user;
+        }
+        const workspaceVersionPath = this._workspaceVersionPath;
+        const objectVersionPath = path.join(this._object.root, inventory.head);
+        /* eg: /workspace/aa/bb/cc/object-1/v1/inventory.json */
+        let invPath = path.join(workspaceVersionPath, INVENTORY_NAME);
+        /* eg: /workspace/aa/bb/cc/object-1/v1/inventory.json.sha512 */
+        let invDigestPath = `${invPath}.${digestAlgorithm}`;
+        const inventoryContent = inventory.toString();
+        const digest = `${await OcflDigest.digest(digestAlgorithm, inventoryContent)} ${INVENTORY_NAME}`;
+        // write inventory.json to workspace
+        await this._store.writeFile(invPath, inventoryContent);
+        await this._store.writeFile(invDigestPath, digest);
+        if (workspaceVersionPath !== objectVersionPath) {
+            try {
+                await this._object._ensureNamaste();
+                await this._store.move(workspaceVersionPath, objectVersionPath);
+                await this._store.remove(this._createdDir);
+            }
+            catch (error) {
+                await this.rollback();
+                throw error;
+            }
+        }
+        // replace root inventory
+        /* eg: /data/aa/bb/cc/object-1/inventory.json */
+        const rootInvPath = path.join(this._object.root, INVENTORY_NAME);
+        /* eg: /data/aa/bb/cc/object-1/v1/inventory.json */
+        invPath = path.join(objectVersionPath, INVENTORY_NAME);
+        invDigestPath = `${invPath}.${digestAlgorithm}`;
+        const rootInvDigestPath = `${rootInvPath}.${digestAlgorithm}`;
+        await this._store.copyFile(invPath, `${rootInvPath}.tmp`);
+        await Promise.all([this._store.move(`${rootInvPath}.tmp`, rootInvPath), this._store.copyFile(invDigestPath, rootInvDigestPath)]);
+    }
+    async createWritable(logicalPath, options) {
+        if (this._committed) {
+            throw new Error('Transaction already commited');
+        }
+        const digestAlgo = this._inventory.digestAlgorithm;
+        const digestAlgos = [digestAlgo, ...(this._object.fixityAlgorithms || [])];
+        const hs = await OcflDigest.createStream(digestAlgos);
+        const realPath = this._getRealPath(logicalPath);
+        const writer = (await this._store.createWritable(realPath, options)).getWriter();
+        const inv = this._inventory;
+        const store = this._store;
+        const ws = new WritableStream({
+            write(chunk) {
+                hs.update(chunk);
+                return writer.write(chunk);
+            },
+            async close() {
+                await writer.close();
+                const [digest, fixity] = splitDigests(hs.digest(), digestAlgo);
+                if (inv.getContentPath(digest)) {
+                    await store.remove(realPath);
+                }
+                inv.add(logicalPath, digest, fixity);
+            },
+        });
+        this._track(writer.closed);
+        return ws;
+    }
+    async write(logicalPath, data, options) {
+        return this._transact(async () => {
+            const realPath = this._getRealPath(logicalPath);
+            const digestAlgo = this._inventory.digestAlgorithm;
+            const digestAlgos = [digestAlgo, ...(this._object.fixityAlgorithms || [])];
+            let digest;
+            let fixity;
+            if (typeof data === 'string' || ArrayBuffer.isView(data)) {
+                // if data is not stream, check digest first
+                if (ArrayBuffer.isView(data) && !(data instanceof Uint8Array || data instanceof Uint16Array || data instanceof Uint32Array)) {
+                    data = new Uint8Array(data.buffer);
+                }
+                const hashes = await OcflDigest.digest(digestAlgos, data);
+                [digest, fixity] = splitDigests(hashes, digestAlgo);
+                if (!this._inventory.getContentPath(digest)) {
+                    // no digest yet, write the file to storage backend
+                    await this._store.writeFile(realPath, data, options);
+                }
+            }
+            else if (data instanceof ReadableStream) {
+                // save the stream first
+                const hs = await OcflDigest.createStreamThrough(digestAlgos);
+                const rs = data.pipeThrough(hs);
+                await this._store.writeFile(realPath, rs, options);
+                [digest, fixity] = splitDigests(hs.digest(), digestAlgo);
+                // already exists, delete temp file
+                if (this._inventory.getContentPath(digest)) {
+                    await this._store.remove(realPath);
+                }
+            }
+            else {
+                throw new TypeError(`Unsupported data type: ${Object.prototype.toString.call(data)}`);
+            }
+            this._inventory.add(logicalPath, digest, fixity);
+        });
+    }
+    /**
+     * Import a single file from source. This is a helper method for {@link OcflObjectTransaction.import | import()} method.
+     */
+    async importFile(source, target) {
+        if (!target) {
+            throw new TypeError('Target logical path must not be empty if source is a file.');
+        }
+        const realPath = this._getRealPath(target);
+        const rs = await this._store.createReadable(source);
+        const digestAlgo = this._inventory.digestAlgorithm;
+        const digestAlgos = [digestAlgo, ...(this._object.fixityAlgorithms || [])];
+        const [digest, fixity] = splitDigests(await OcflDigest.digest(digestAlgos, rs), digestAlgo);
+        if (!this._inventory.getContentPath(digest)) {
+            await this._store.copyFile(source, realPath);
+        }
+        this._inventory.add(target, digest, fixity);
+    }
+    async import(source, target) {
+        return this._transact(async () => {
+            const dest = target ?? path.basename(source);
+            const srcStat = await this._store.stat(source);
+            if (srcStat.isFile()) {
+                await this.importFile(source, dest);
+            }
+            else if (srcStat.isDirectory()) {
+                const files = await this._store.readdir(source);
+                await parallelize(files, async (filename) => {
+                    await this.import(path.join(source, filename), path.join(dest, filename));
+                });
+            }
+        });
+    }
+    async copy(source, target) {
+        return this._transact(async () => {
+            this._inventory.copy(source, target);
+        });
+    }
+    async rename(source, target) {
+        return this._transact(async () => {
+            // if file already exists in the workspace, rename the actual file
+            try {
+                const realSource = this._getRealPath(source);
+                const realTarget = this._getRealPath(target);
+                await this._store.move(realSource, realTarget);
+            }
+            catch (error) {
+                if (!isErrnoException(error) || error.code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+            this._inventory.rename(source, target);
+        });
+    }
+    async reinstate(logicalPath, versionName) {
+        return this._inventory.reinstate(logicalPath, versionName);
+    }
+    async remove(logicalPath, options) {
+        return this._transact(async () => {
+            if (options?.purge) {
+                // completely remove content from all versions
+                let ver = this._inventory.versionNumber.previous();
+                while (ver) {
+                    this._inventory.delete(logicalPath, ver.toString());
+                    ver = ver.previous();
+                }
+            }
+            if (this._inventory.delete(logicalPath)) {
+                return this._store.remove(this._getRealPath(logicalPath));
+            }
+        });
+    }
+    /**
+     * A function wrapper to provide safe mutating operation that
+     * will check if a transaction is already committed and track any unfinished promises.
+     */
+    async _transact(op) {
+        if (this._committed) {
+            throw new Error('Transaction already commited');
+        }
+        return this._track(op());
+    }
+    _track(p) {
+        const markDone = () => {
+            p.done = true;
+        };
+        // then(f, f), not finally(f): finally's derived promise would reject unhandled.
+        p.then(markDone, markDone);
+        this._queue.push(p);
+        return p;
+    }
+}
+export { OcflObjectTransaction, OcflObjectTransactionImpl };
+//# sourceMappingURL=transaction.js.map

package/dist/transaction.js.map

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