@flystorage/file-storage 0.1.1 → 0.1.3

package/README.md

@@ -41,7 +41,7 @@ to, simply because they cannot be abstracted over in a reasonable manner.
 ### Implemented
 - [x] [Local Filesystem](https://www.npmjs.com/package/@flystorage/local-fs)
 - [x] [AWS S3 (using the V3 SDK)](https://www.npmjs.com/package/@flystorage/aws-s3)
-- [x] [Azure Blob Storage](https://www.npmjs.com/package/@flystorage/file-storage)
+- [x] [Azure Blob Storage](https://www.npmjs.com/package/@flystorage/azure-storage-blob)
 - [x] [Test implementation (in-memory)](https://www.npmjs.com/package/@flystorage/in-memory)
 - [x] [Google Cloud Storage](https://www.npmjs.com/package/@flystorage/google-cloud-storage)
 - [x] [Chaos adapter decorator](https://www.npmjs.com/package/@flystorage/chaos)
@@ -75,7 +75,7 @@ import {LocalStorageAdapter} from '@flystorage/local-fs';
  **/
 
 const rootDirectory = resolve(process.cwd(), 'my-files');
-const storage = new FileStorage(new LocalFileStorage(rootDirectory));
+const storage = new FileStorage(new LocalStorageAdapter(rootDirectory));
 
 /**
  * USAGE

package/dist/cjs/checksum-from-stream.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checksumFromStream = void 0;
-const crypto_1 = require("crypto");
-async function checksumFromStream(stream, options) {
+import { createHash } from 'crypto';
+export async function checksumFromStream(stream, options) {
     return new Promise(async (resolve, reject) => {
-        const hash = (0, crypto_1.createHash)(options.algo ?? 'md5');
+        const hash = createHash(options.algo ?? 'md5');
         stream.on('error', reject);
         stream.pipe(hash, { end: false });
         stream.on('end', () => {
@@ -13,4 +10,3 @@ async function checksumFromStream(stream, options) {
         });
     });
 }
-exports.checksumFromStream = checksumFromStream;

package/dist/cjs/errors.js

@@ -1,11 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnableToListDirectory = exports.UnableToCheckDirectoryExistence = exports.UnableToCheckFileExistence = exports.UnableToDeleteFile = exports.UnableToDeleteDirectory = exports.UnableToCreateDirectory = exports.UnableToGetStat = exports.UnableToMoveFile = exports.UnableToCopyFile = exports.UnableToGetTemporaryUrl = exports.UnableToGetPublicUrl = exports.UnableToGetVisibility = exports.UnableToSetVisibility = exports.UnableToReadFile = exports.UnableToWriteFile = exports.UnableToGetFileSize = exports.UnableToGetLastModified = exports.UnableToGetMimeType = exports.UnableToGetChecksum = exports.ChecksumIsNotAvailable = exports.FlystorageError = exports.errorToMessage = void 0;
-function errorToMessage(error) {
+export function errorToMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
-exports.errorToMessage = errorToMessage;
-class FlystorageError extends Error {
+export class FlystorageError extends Error {
     context;
     code = 'unknown_error';
     constructor(message, context = {}, cause = undefined) {
@@ -15,12 +11,11 @@ class FlystorageError extends Error {
         this.context = context;
     }
 }
-exports.FlystorageError = FlystorageError;
 /**
  * Thrown when the checksum algo is not supported or not pre-computed. This error
  * is thrown with the intention of falling back to computing it based on a file read.
  */
-class ChecksumIsNotAvailable extends FlystorageError {
+export class ChecksumIsNotAvailable extends FlystorageError {
     algo;
     code = 'flystorage.checksum_not_supported';
     constructor(message, algo, context = {}, cause = undefined) {
@@ -29,100 +24,80 @@ class ChecksumIsNotAvailable extends FlystorageError {
     }
     static checksumNotSupported = (algo, { context = {}, cause = undefined } = {}) => new ChecksumIsNotAvailable(`Checksum algo "${algo}" is not supported`, algo, { ...context, algo }, cause);
 }
-exports.ChecksumIsNotAvailable = ChecksumIsNotAvailable;
-class UnableToGetChecksum extends FlystorageError {
+export class UnableToGetChecksum extends FlystorageError {
     code = 'flystorage.unable_to_get_checksum';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetChecksum(`Unable to write the file. Reason: ${reason}`, context, cause);
 }
-exports.UnableToGetChecksum = UnableToGetChecksum;
-class UnableToGetMimeType extends FlystorageError {
+export class UnableToGetMimeType extends FlystorageError {
     code = 'flystorage.unable_to_get_mimetype';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetMimeType(`Unable to get mime-type. Reason: ${reason}`, context, cause);
 }
-exports.UnableToGetMimeType = UnableToGetMimeType;
-class UnableToGetLastModified extends FlystorageError {
+export class UnableToGetLastModified extends FlystorageError {
     code = 'flystorage.unable_to_get_last_modified';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetLastModified(`Unable to get last modified. Reason: ${reason}`, context, cause);
 }
-exports.UnableToGetLastModified = UnableToGetLastModified;
-class UnableToGetFileSize extends FlystorageError {
+export class UnableToGetFileSize extends FlystorageError {
     code = 'flystorage.unable_to_get_file_size';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetFileSize(`Unable to get file size. Reason: ${reason}`, context, cause);
 }
-exports.UnableToGetFileSize = UnableToGetFileSize;
-class UnableToWriteFile extends FlystorageError {
+export class UnableToWriteFile extends FlystorageError {
     code = 'flystorage.unable_to_write_file';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToWriteFile(`Unable to write the file. Reason: ${reason}`, context, cause);
 }
-exports.UnableToWriteFile = UnableToWriteFile;
-class UnableToReadFile extends FlystorageError {
+export class UnableToReadFile extends FlystorageError {
     code = 'flystorage.unable_to_read_file';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToReadFile(`Unable to read the file. Reason: ${reason}`, context, cause);
 }
-exports.UnableToReadFile = UnableToReadFile;
-class UnableToSetVisibility extends FlystorageError {
+export class UnableToSetVisibility extends FlystorageError {
     code = 'flystorage.unable_to_set_visibility';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToSetVisibility(`Unable to set visibility. Reason: ${reason}`, context, cause);
 }
-exports.UnableToSetVisibility = UnableToSetVisibility;
-class UnableToGetVisibility extends FlystorageError {
+export class UnableToGetVisibility extends FlystorageError {
     code = 'flystorage.unable_to_get_visibility';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetVisibility(`Unable to get visibility. Reason: ${reason}`, context, cause);
 }
-exports.UnableToGetVisibility = UnableToGetVisibility;
-class UnableToGetPublicUrl extends FlystorageError {
+export class UnableToGetPublicUrl extends FlystorageError {
     code = 'flystorage.unable_to_get_public_url';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetPublicUrl(`Unable to get public URL. Reason: ${reason}`, context, cause);
 }
-exports.UnableToGetPublicUrl = UnableToGetPublicUrl;
-class UnableToGetTemporaryUrl extends FlystorageError {
+export class UnableToGetTemporaryUrl extends FlystorageError {
     code = 'flystorage.unable_to_get_temporary_url';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetTemporaryUrl(`Unable to get temporary URL. Reason: ${reason}`, context, cause);
 }
-exports.UnableToGetTemporaryUrl = UnableToGetTemporaryUrl;
-class UnableToCopyFile extends FlystorageError {
+export class UnableToCopyFile extends FlystorageError {
     code = 'flystorage.unable_to_copy_file';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToCopyFile(`Unable to copy file. Reason: ${reason}`, context, cause);
 }
-exports.UnableToCopyFile = UnableToCopyFile;
-class UnableToMoveFile extends FlystorageError {
+export class UnableToMoveFile extends FlystorageError {
     code = 'flystorage.unable_to_move_file';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToMoveFile(`Unable to move file. Reason: ${reason}`, context, cause);
 }
-exports.UnableToMoveFile = UnableToMoveFile;
-class UnableToGetStat extends FlystorageError {
+export class UnableToGetStat extends FlystorageError {
     code = 'flystorage.unable_to_get_stat';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToGetStat(`Unable to get stat. Reason: ${reason}`, context, cause);
     static noFileStatResolved = ({ context = {}, cause = undefined }) => new UnableToGetStat(`Stat was not a file.`, context, cause);
 }
-exports.UnableToGetStat = UnableToGetStat;
-class UnableToCreateDirectory extends FlystorageError {
+export class UnableToCreateDirectory extends FlystorageError {
     code = 'flystorage.unable_to_create_directory';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToCreateDirectory(`Unable to create directory. Reason: ${reason}`, context, cause);
 }
-exports.UnableToCreateDirectory = UnableToCreateDirectory;
-class UnableToDeleteDirectory extends FlystorageError {
+export class UnableToDeleteDirectory extends FlystorageError {
     code = 'flystorage.unable_to_delete_directory';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToDeleteDirectory(`Unable to delete directory. Reason: ${reason}`, context, cause);
 }
-exports.UnableToDeleteDirectory = UnableToDeleteDirectory;
-class UnableToDeleteFile extends FlystorageError {
+export class UnableToDeleteFile extends FlystorageError {
     code = 'flystorage.unable_to_delete_file';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToDeleteFile(`Unable to delete file. Reason: ${reason}`, context, cause);
 }
-exports.UnableToDeleteFile = UnableToDeleteFile;
-class UnableToCheckFileExistence extends FlystorageError {
+export class UnableToCheckFileExistence extends FlystorageError {
     code = 'flystorage.unable_to_check_file_existence';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToCheckFileExistence(`Unable to check file existence. Reason: ${reason}`, context, cause);
 }
-exports.UnableToCheckFileExistence = UnableToCheckFileExistence;
-class UnableToCheckDirectoryExistence extends FlystorageError {
+export class UnableToCheckDirectoryExistence extends FlystorageError {
     code = 'flystorage.unable_to_check_directory_existence';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToCheckDirectoryExistence(`Unable to check directory existence. Reason: ${reason}`, context, cause);
 }
-exports.UnableToCheckDirectoryExistence = UnableToCheckDirectoryExistence;
-class UnableToListDirectory extends FlystorageError {
+export class UnableToListDirectory extends FlystorageError {
     code = 'flystorage.unable_to_list_directory_contents';
     static because = (reason, { context = {}, cause = undefined }) => new UnableToListDirectory(`Unable to list directory contents. Reason: ${reason}`, context, cause);
 }
-exports.UnableToListDirectory = UnableToListDirectory;

package/dist/cjs/file-storage.js

@@ -1,21 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readableToUint8Array = exports.readableToString = exports.closeReadable = exports.normalizeExpiryToMilliseconds = exports.normalizeExpiryToDate = exports.FileStorage = exports.toReadable = exports.DirectoryListing = exports.isDirectory = exports.isFile = void 0;
-const stream_1 = require("stream");
-const checksum_from_stream_js_1 = require("./checksum-from-stream.js");
-const errors = require("./errors.js");
-const errors_js_1 = require("./errors.js");
-const path_normalizer_js_1 = require("./path-normalizer.js");
-const util_1 = require("util");
-function isFile(stat) {
+import { Readable } from 'stream';
+import { checksumFromStream } from './checksum-from-stream.js';
+import * as errors from './errors.js';
+import { ChecksumIsNotAvailable } from './errors.js';
+import { PathNormalizerV1 } from './path-normalizer.js';
+import { TextEncoder } from "util";
+export function isFile(stat) {
     return stat.isFile;
 }
-exports.isFile = isFile;
-function isDirectory(stat) {
+export function isDirectory(stat) {
     return stat.isDirectory;
 }
-exports.isDirectory = isDirectory;
-class DirectoryListing {
+export class DirectoryListing {
     listing;
     path;
     deep;
@@ -53,23 +48,21 @@ class DirectoryListing {
         }
     }
 }
-exports.DirectoryListing = DirectoryListing;
-function toReadable(contents) {
-    if (contents instanceof stream_1.Readable) {
+export function toReadable(contents) {
+    if (contents instanceof Readable) {
         return contents;
     }
-    return stream_1.Readable.from(contents);
+    return Readable.from(contents);
 }
-exports.toReadable = toReadable;
 const naturalSorting = new Intl.Collator(undefined, {
     numeric: true,
     sensitivity: 'base'
 });
-class FileStorage {
+export class FileStorage {
     adapter;
     pathNormalizer;
     options;
-    constructor(adapter, pathNormalizer = new path_normalizer_js_1.PathNormalizerV1(), options = {}) {
+    constructor(adapter, pathNormalizer = new PathNormalizerV1(), options = {}) {
         this.adapter = adapter;
         this.pathNormalizer = pathNormalizer;
         this.options = options;
@@ -86,7 +79,7 @@ class FileStorage {
     }
     async read(path) {
         try {
-            return stream_1.Readable.from(await this.adapter.read(this.pathNormalizer.normalizePath(path)));
+            return Readable.from(await this.adapter.read(this.pathNormalizer.normalizePath(path)));
         }
         catch (error) {
             throw errors.UnableToReadFile.because(errors.errorToMessage(error), { cause: error, context: { path } });
@@ -218,7 +211,7 @@ class FileStorage {
             return await this.adapter.checksum(this.pathNormalizer.normalizePath(path), { ...this.options.checksums, ...options });
         }
         catch (error) {
-            if (error instanceof errors_js_1.ChecksumIsNotAvailable) {
+            if (error instanceof ChecksumIsNotAvailable) {
                 return this.calculateChecksum(path, options);
             }
             throw errors.UnableToGetChecksum.because(errors.errorToMessage(error), { cause: error, context: { path, options } });
@@ -250,23 +243,20 @@ class FileStorage {
     }
     async calculateChecksum(path, options) {
         try {
-            return await (0, checksum_from_stream_js_1.checksumFromStream)(await this.read(path), options);
+            return await checksumFromStream(await this.read(path), options);
         }
         catch (error) {
             throw errors.UnableToGetChecksum.because(errors.errorToMessage(error), { cause: error, context: { path, options } });
         }
     }
 }
-exports.FileStorage = FileStorage;
-function normalizeExpiryToDate(expiresAt) {
+export function normalizeExpiryToDate(expiresAt) {
     return expiresAt instanceof Date ? expiresAt : new Date(expiresAt);
 }
-exports.normalizeExpiryToDate = normalizeExpiryToDate;
-function normalizeExpiryToMilliseconds(expiresAt) {
+export function normalizeExpiryToMilliseconds(expiresAt) {
     return expiresAt instanceof Date ? expiresAt.getTime() : expiresAt;
 }
-exports.normalizeExpiryToMilliseconds = normalizeExpiryToMilliseconds;
-async function closeReadable(body) {
+export async function closeReadable(body) {
     if (body.closed) {
         return;
     }
@@ -277,16 +267,14 @@ async function closeReadable(body) {
         body.destroy();
     });
 }
-exports.closeReadable = closeReadable;
 const decoder = new TextDecoder();
-async function readableToString(stream) {
+export async function readableToString(stream) {
     const contents = decoder.decode(await readableToUint8Array(stream));
     await closeReadable(stream);
     return contents;
 }
-exports.readableToString = readableToString;
-const encoder = new util_1.TextEncoder();
-function readableToUint8Array(stream) {
+const encoder = new TextEncoder();
+export function readableToUint8Array(stream) {
     return new Promise((resolve, reject) => {
         const parts = [];
         stream.on('data', (chunk) => {
@@ -303,7 +291,6 @@ function readableToUint8Array(stream) {
         stream.on('end', () => resolve(concatUint8Arrays(parts)));
     });
 }
-exports.readableToUint8Array = readableToUint8Array;
 function concatUint8Arrays(input) {
     const length = input.reduce((l, a) => l + (a.byteLength), 0);
     const output = new Uint8Array(length);

package/dist/cjs/index.js

@@ -1,22 +1,6 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./checksum-from-stream.js"), exports);
-__exportStar(require("./file-storage.js"), exports);
-__exportStar(require("./errors.js"), exports);
-__exportStar(require("./path-normalizer.js"), exports);
-__exportStar(require("./path-prefixer.js"), exports);
-__exportStar(require("./portable-visibility.js"), exports);
+export * from './checksum-from-stream.js';
+export * from './file-storage.js';
+export * from './errors.js';
+export * from './path-normalizer.js';
+export * from './path-prefixer.js';
+export * from './portable-visibility.js';

package/dist/cjs/path-normalizer.js

@@ -1,26 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PathTraversalDetected = exports.CorruptedPathDetected = exports.PathNormalizerV1 = void 0;
-const node_path_1 = require("node:path");
+import { join } from 'node:path';
 const funkyWhiteSpaceRegex = new RegExp('\\p{C}+', 'u');
-class PathNormalizerV1 {
+export class PathNormalizerV1 {
     normalizePath(path) {
         if (funkyWhiteSpaceRegex.test(path)) {
             throw CorruptedPathDetected.unexpectedWhitespace(path);
         }
-        const normalized = (0, node_path_1.join)(...(path.split('/')));
+        const normalized = join(...(path.split('/')));
         if (normalized.indexOf('../') !== -1 || normalized == '..') {
             throw PathTraversalDetected.forPath(path);
         }
         return normalized === '.' ? '' : normalized;
     }
 }
-exports.PathNormalizerV1 = PathNormalizerV1;
-class CorruptedPathDetected extends Error {
+export class CorruptedPathDetected extends Error {
     static unexpectedWhitespace = (path) => new CorruptedPathDetected(`Corrupted path detected with unexpected whitespace: ${path}`);
 }
-exports.CorruptedPathDetected = CorruptedPathDetected;
-class PathTraversalDetected extends Error {
+export class PathTraversalDetected extends Error {
     static forPath = (path) => new PathTraversalDetected(`Path traversal detected for: ${path}`);
 }
-exports.PathTraversalDetected = PathTraversalDetected;

package/dist/cjs/path-prefixer.js

@@ -1,12 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PathPrefixer = void 0;
-const node_path_1 = require("node:path");
-class PathPrefixer {
+import { join } from 'node:path';
+export class PathPrefixer {
     separator;
     joinFunc;
     prefix = '';
-    constructor(prefix = '', separator = '/', joinFunc = node_path_1.join) {
+    constructor(prefix = '', separator = '/', joinFunc = join) {
         this.separator = separator;
         this.joinFunc = joinFunc;
         if (prefix.length > 0) {
@@ -26,4 +23,3 @@ class PathPrefixer {
         return this.stripFilePath(path).replace(/\/+$/g, '');
     }
 }
-exports.PathPrefixer = PathPrefixer;

package/dist/cjs/portable-visibility.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Visibility = void 0;
-var Visibility;
+export var Visibility;
 (function (Visibility) {
     Visibility["PUBLIC"] = "public";
     Visibility["PRIVATE"] = "private";
-})(Visibility || (exports.Visibility = Visibility = {}));
+})(Visibility || (Visibility = {}));

package/dist/types/errors.d.ts

@@ -20,144 +20,144 @@ export declare class ChecksumIsNotAvailable extends FlystorageError {
     readonly code = "flystorage.checksum_not_supported";
     constructor(message: string, algo: string, context?: ErrorContext, cause?: unknown);
     static checksumNotSupported: (algo: string, { context, cause }?: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => ChecksumIsNotAvailable;
 }
 export declare class UnableToGetChecksum extends FlystorageError {
     readonly code = "flystorage.unable_to_get_checksum";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetChecksum;
 }
 export declare class UnableToGetMimeType extends FlystorageError {
     readonly code = "flystorage.unable_to_get_mimetype";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetMimeType;
 }
 export declare class UnableToGetLastModified extends FlystorageError {
     readonly code = "flystorage.unable_to_get_last_modified";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetLastModified;
 }
 export declare class UnableToGetFileSize extends FlystorageError {
     readonly code = "flystorage.unable_to_get_file_size";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetFileSize;
 }
 export declare class UnableToWriteFile extends FlystorageError {
     readonly code = "flystorage.unable_to_write_file";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToWriteFile;
 }
 export declare class UnableToReadFile extends FlystorageError {
     readonly code = "flystorage.unable_to_read_file";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToReadFile;
 }
 export declare class UnableToSetVisibility extends FlystorageError {
     readonly code = "flystorage.unable_to_set_visibility";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToSetVisibility;
 }
 export declare class UnableToGetVisibility extends FlystorageError {
     readonly code = "flystorage.unable_to_get_visibility";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetVisibility;
 }
 export declare class UnableToGetPublicUrl extends FlystorageError {
     readonly code = "flystorage.unable_to_get_public_url";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetPublicUrl;
 }
 export declare class UnableToGetTemporaryUrl extends FlystorageError {
     readonly code = "flystorage.unable_to_get_temporary_url";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetTemporaryUrl;
 }
 export declare class UnableToCopyFile extends FlystorageError {
     readonly code = "flystorage.unable_to_copy_file";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToCopyFile;
 }
 export declare class UnableToMoveFile extends FlystorageError {
     readonly code = "flystorage.unable_to_move_file";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToMoveFile;
 }
 export declare class UnableToGetStat extends FlystorageError {
     readonly code = "flystorage.unable_to_get_stat";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetStat;
     static noFileStatResolved: ({ context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToGetStat;
 }
 export declare class UnableToCreateDirectory extends FlystorageError {
     readonly code = "flystorage.unable_to_create_directory";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToCreateDirectory;
 }
 export declare class UnableToDeleteDirectory extends FlystorageError {
     readonly code = "flystorage.unable_to_delete_directory";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToDeleteDirectory;
 }
 export declare class UnableToDeleteFile extends FlystorageError {
     readonly code = "flystorage.unable_to_delete_file";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToDeleteFile;
 }
 export declare class UnableToCheckFileExistence extends FlystorageError {
     readonly code = "flystorage.unable_to_check_file_existence";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToCheckFileExistence;
 }
 export declare class UnableToCheckDirectoryExistence extends FlystorageError {
     readonly code = "flystorage.unable_to_check_directory_existence";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToCheckDirectoryExistence;
 }
 export declare class UnableToListDirectory extends FlystorageError {
     readonly code = "flystorage.unable_to_list_directory_contents";
     static because: (reason: string, { context, cause }: {
-        context?: ErrorContext | undefined;
+        context?: ErrorContext;
         cause?: unknown;
     }) => UnableToListDirectory;
 }

package/dist/types/file-storage.d.ts

@@ -72,6 +72,7 @@ export type VisibilityOptions = {
 export type WriteOptions = VisibilityOptions & MiscellaneousOptions & {
     mimeType?: string;
     size?: number;
+    cacheControl?: string;
 };
 export type CreateDirectoryOptions = MiscellaneousOptions & Pick<VisibilityOptions, 'directoryVisibility'> & {};
 export type PublicUrlOptions = MiscellaneousOptions & {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@flystorage/file-storage",
   "type": "module",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "File-storage abstraction: multiple filesystems, one API.",
   "main": "./dist/cjs/index.js",
   "types": "./dist/types/index.d.ts",
@@ -20,7 +20,7 @@
   "scripts": {
     "compile": "rm -rf ./dist/ && concurrently npm:compile:* && echo '{\"type\": \"commonjs\"}' > ./dist/cjs/package.json",
     "compile:esm": "tsc --outDir ./dist/esm/ --declaration false",
-    "compile:cjs": "tsc --outDir ./dist/cjs/ --declaration false --module commonjs --moduleResolution node",
+    "compile:cjs": "tsc --outDir ./dist/cjs/ --declaration false --module node16 --moduleResolution node16",
     "compile:types": "tsc --outDir ./dist/types/ --declaration --emitDeclarationOnly",
     "watch": "tsc --watch"
   },