@spinajs/fs 2.0.481 → 2.0.482

package/lib/mjs/file-info.d.ts

@@ -1,11 +1,100 @@
-import { Log } from '@spinajs/log';
+import { ChildProcessWithoutNullStreams } from 'node:child_process';
+import { Log } from '@spinajs/log-common';
 import { FileInfoService, IFileInfo } from './interfaces.js';
+import { DateTime } from 'luxon';
+/**
+ * A single extracted metadata value.
+ */
+type ExifValue = string | number | DateTime;
+/**
+ * Resolves the path to the exiftool binary.
+ *
+ * Prefers the vendored binary shipped with the `exiftool-vendored` platform
+ * packages ( no system installation required ), and falls back to `exiftool`
+ * available on PATH.
+ */
+export declare function resolveExifToolPath(): Promise<string>;
+/**
+ * Default {@link FileInfoService} implementation backed by the `exiftool`
+ * command line tool.
+ *
+ * The binary is auto-resolved ( vendored, then PATH ) unless overridden with
+ * the `fs.fileInfo.exifToolPath` configuration key. The invocation is bounded
+ * by the `fs.fileInfo.timeout` configuration ( default {@link DEFAULT_TIMEOUT} ).
+ */
 export declare class DefaultFileInfo extends FileInfoService {
     protected Log: Log;
+    /**
+     * Optional exiftool binary path override from configuration. When unset, the
+     * binary is auto-resolved via {@link resolveExifToolPath}.
+     */
+    protected ConfiguredPath?: string;
+    /**
+     * Timeout ( ms ) for the exiftool process, from configuration.
+     */
+    protected Timeout: number;
+    /**
+     * exiftool arguments controlling extraction breadth, from configuration
+     * ( default {@link DEFAULT_ARGS} ). The file spec ( path or `-` ) is appended
+     * automatically. NOTE: some flags ( eg. `-G` ) change the output tag names.
+     */
+    protected ExifArgs: string[];
+    /**
+     * Auto-resolved exiftool binary path, cached after first use.
+     */
+    protected ExifToolPath: string;
+    /**
+     * Extracts file information from a file on disk.
+     *
+     * @param pathToFile absolute path to the file
+     * @throws {IOFail} when the file does not exist or exiftool fails
+     */
     getInfo(pathToFile: string): Promise<IFileInfo>;
-    protected spawnExifProcess(file: string): Promise<string>;
-    protected getMetadata(file: string): Promise<{
-        [key: string]: string | number;
-    }>;
+    /**
+     * Extracts file information from a readable stream by piping its content to
+     * exiftool via stdin ( `exiftool -n -` ).
+     *
+     * @param stream readable stream with the file content
+     * @throws {IOFail} when exiftool fails or the stream errors
+     */
+    getInfoFromStream(stream: NodeJS.ReadableStream): Promise<IFileInfo>;
+    /**
+     * Resolves the exiftool binary path, preferring the configured override.
+     */
+    protected binaryPath(): Promise<string>;
+    /**
+     * Spawns the exiftool process. Extracted so it can be overridden ( eg. in tests ).
+     */
+    protected spawnExif(binary: string, args: string[]): ChildProcessWithoutNullStreams;
+    /**
+     * Runs exiftool against a file spec ( a path, or `-` for stdin ) and returns
+     * its stdout.
+     *
+     * Success/failure is determined by the process exit code ( not by the mere
+     * presence of stderr, which exiftool uses for non-fatal warnings ). The call
+     * is bounded by {@link Timeout} and any failure is surfaced as {@link IOFail}.
+     *
+     * @param fileArg file path or `-` to read from stdin
+     * @param input optional readable stream piped to the process stdin
+     */
+    protected runExifTool(fileArg: string, input?: NodeJS.ReadableStream): Promise<string>;
+    /**
+     * Parses raw exiftool text output into a `{ normalisedTag: value }` map with
+     * EVERY emitted tag ( nothing is filtered ).
+     *
+     * Each line is split on the FIRST `': '` only, so values that themselves
+     * contain `': '` are preserved. Values are coerced by {@link coerceValue}
+     * ( numbers and date-shaped strings ).
+     */
+    protected parseMetadata(raw: string): Record<string, ExifValue>;
+    /**
+     * Projects a parsed metadata map onto {@link IFileInfo}.
+     *
+     * Every extracted tag is promoted: known tags via their {@link TAG_ALIASES}
+     * friendly field name, all others under their PascalCased tag name. The full
+     * unmodified map is always available under `Raw`.
+     */
+    protected toFileInfo(metadata: Record<string, ExifValue>): IFileInfo;
 }
+export {};
 //# sourceMappingURL=file-info.d.ts.map

package/lib/mjs/file-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-info.d.ts","sourceRoot":"","sources":["../../src/file-info.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA4C7D,qBACa,eAAgB,SAAQ,eAAe;IAElD,SAAS,CAAC,GAAG,EAAG,GAAG,CAAC;IAEP,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;cAsB5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAa/C,WAAW,CAAC,IAAI,EAAE,MAAM;;;CAsCzC"}
+{"version":3,"file":"file-info.d.ts","sourceRoot":"","sources":["../../src/file-info.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAI3E,OAAO,EAAE,GAAG,EAAU,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAcjC;;GAEG;AACH,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAmF5C;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAa3D;AAED;;;;;;;GAOG;AACH,qBACa,eAAgB,SAAQ,eAAe;IAElD,SAAS,CAAC,GAAG,EAAG,GAAG,CAAC;IAEpB;;;OAGG;IAEH,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IAEH,SAAS,CAAC,OAAO,EAAG,MAAM,CAAC;IAE3B;;;;OAIG;IAEH,SAAS,CAAC,QAAQ,EAAG,MAAM,EAAE,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,YAAY,EAAG,MAAM,CAAC;IAEhC;;;;;OAKG;IACU,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAS5D;;;;;;OAMG;IACU,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAKjF;;OAEG;cACa,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAa7C;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,8BAA8B;IAInF;;;;;;;;;;OAUG;cACa,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA8C5F;;;;;;;OAOG;IACH,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAqB/D;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS;CAarE"}

package/lib/mjs/file-info.js

@@ -7,114 +7,274 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { spawn } from "node:child_process";
+/// <reference path="./typings/exiftool.d.ts" />
+import { spawn } from 'node:child_process';
 import { Injectable } from '@spinajs/di';
-import { Log, Logger } from '@spinajs/log';
+import { Config } from '@spinajs/configuration';
+import { Log, Logger } from '@spinajs/log-common';
 import { IOFail } from '@spinajs/exceptions';
 import { existsSync } from 'fs';
 import { FileInfoService } from './interfaces.js';
-import { DateTime } from "luxon";
-const EXIFTOOL_MAPPINGS = {
-    audioChannels: "AudioChannels",
-    imageHeight: 'Height',
+import { DateTime } from 'luxon';
+/**
+ * Default process timeout ( ms ) for the exiftool invocation.
+ */
+const DEFAULT_TIMEOUT = 30_000;
+/**
+ * Default exiftool arguments. `-n` disables print-conversion ( numeric values ).
+ * Extend via the `fs.fileInfo.args` configuration ( eg. add `-a`, `-G`, `-ee`,
+ * `-All` ) to widen what is extracted.
+ */
+const DEFAULT_ARGS = ['-n'];
+/**
+ * Friendly aliases: normalised exiftool tag -> {@link IFileInfo} field name.
+ *
+ * This is NOT an allow-list - every tag emitted by exiftool is extracted and
+ * promoted ( see {@link DefaultFileInfo.toFileInfo} ). Aliases only give the
+ * most common tags stable, typed names and keep existing consumers working.
+ * Several source tags may collapse onto one field ( eg. duration / playDuration ).
+ */
+const TAG_ALIASES = {
     imageWidth: 'Width',
+    imageHeight: 'Height',
     duration: 'Duration',
     playDuration: 'Duration',
     frameCount: 'FrameCount',
     frameRate: 'FrameRate',
     videoFrameRate: 'FrameRate',
+    audioChannels: 'AudioChannels',
     maxBitrate: 'Bitrate',
     maxDataRate: 'Bitrate',
     avgBitrate: 'Bitrate',
     compressorID: 'Codec',
-    fileSize: ["FileSize", (val) => (parseInt(val))],
-    'fileAccessDate/Time': ["AccessDate", (val) => { return DateTime.fromFormat(val, "yyyy:MM:dd HH:mm:ssZZ"); }],
-    'fileCreationDate/Time': ["CreationDate", (val) => { return DateTime.fromFormat(val, "yyyy:MM:dd HH:mm:ssZZ"); }],
-    'fileModificationDate/Time': ["ModificationDate", (val) => { return DateTime.fromFormat(val, "yyyy:MM:dd HH:mm:ssZZ"); }],
-    mimeType: "MimeType",
-    mimeEncoding: "Encoding",
-    wordCount: "WordCount",
-    lineCount: "LineCount"
+    fileSize: 'FileSize',
+    mimeType: 'MimeType',
+    mimeEncoding: 'Encoding',
+    wordCount: 'WordCount',
+    lineCount: 'LineCount',
+    fileAccessDateTime: 'AccessDate',
+    fileCreationDateTime: 'CreationDate',
+    fileModificationDateTime: 'ModificationDate',
 };
-function _fInfoInit() {
-    return {
-        FileSize: 0,
-        Height: undefined,
-        Width: undefined,
-        Duration: undefined,
-        FrameCount: undefined,
-        FrameRate: undefined,
-        Bitrate: undefined,
-        Codec: undefined,
-        Raw: undefined
-    };
+/**
+ * Matches the leading part of an exiftool date value, eg. `2024:01:15 10:30:45`.
+ */
+const EXIFTOOL_DATE = /^\d{4}:\d{2}:\d{2} \d{2}:\d{2}:\d{2}/;
+/**
+ * Date formats exiftool may emit ( with/without sub-seconds and timezone ).
+ */
+const EXIFTOOL_DATE_FORMATS = [
+    'yyyy:MM:dd HH:mm:ssZZ',
+    'yyyy:MM:dd HH:mm:ss.SSSZZ',
+    'yyyy:MM:dd HH:mm:ss.SSS',
+    'yyyy:MM:dd HH:mm:ss',
+];
+/**
+ * Normalises a raw exiftool tag name ( eg. "Image Width", "File
+ * Modification Date/Time" ) into a stable camelCase key ( "imageWidth",
+ * "fileModificationDateTime" ) by splitting on any non-alphanumeric run.
+ */
+function normalizeTag(rawTag) {
+    return rawTag
+        .split(/[^a-zA-Z0-9]+/)
+        .filter((token) => token.length > 0)
+        .map((token, index) => (index === 0 ? token.toLowerCase() : token[0].toUpperCase() + token.slice(1)))
+        .join('');
 }
+/**
+ * Coerces a raw exiftool string value into a typed value: date-shaped strings
+ * become {@link DateTime} ( detected by value shape, not by a hardcoded field
+ * list ), purely numeric strings become numbers, everything else stays a string.
+ */
+function coerceValue(value) {
+    if (EXIFTOOL_DATE.test(value)) {
+        for (const format of EXIFTOOL_DATE_FORMATS) {
+            const parsed = DateTime.fromFormat(value, format);
+            if (parsed.isValid) {
+                return parsed;
+            }
+        }
+    }
+    if (value !== '' && +value === +value) {
+        return parseFloat(value);
+    }
+    return value;
+}
+/**
+ * Resolves the path to the exiftool binary.
+ *
+ * Prefers the vendored binary shipped with the `exiftool-vendored` platform
+ * packages ( no system installation required ), and falls back to `exiftool`
+ * available on PATH.
+ */
+export async function resolveExifToolPath() {
+    try {
+        const mod = process.platform === 'win32' ? await import('exiftool-vendored.exe') : await import('exiftool-vendored.pl');
+        const binaryPath = (mod.default ?? mod);
+        if (typeof binaryPath === 'string' && existsSync(binaryPath)) {
+            return binaryPath;
+        }
+    }
+    catch {
+        /* vendored package not installed for this platform - fall back to PATH */
+    }
+    return 'exiftool';
+}
+/**
+ * Default {@link FileInfoService} implementation backed by the `exiftool`
+ * command line tool.
+ *
+ * The binary is auto-resolved ( vendored, then PATH ) unless overridden with
+ * the `fs.fileInfo.exifToolPath` configuration key. The invocation is bounded
+ * by the `fs.fileInfo.timeout` configuration ( default {@link DEFAULT_TIMEOUT} ).
+ */
 let DefaultFileInfo = class DefaultFileInfo extends FileInfoService {
+    /**
+     * Extracts file information from a file on disk.
+     *
+     * @param pathToFile absolute path to the file
+     * @throws {IOFail} when the file does not exist or exiftool fails
+     */
     async getInfo(pathToFile) {
         if (!existsSync(pathToFile)) {
             throw new IOFail(`Path ${pathToFile} not exists`);
         }
-        const fInfo = _fInfoInit();
-        const metadata = await this.getMetadata(pathToFile);
-        fInfo.Raw = metadata;
-        for (const key in EXIFTOOL_MAPPINGS) {
-            if (metadata[key]) {
-                const mKey = EXIFTOOL_MAPPINGS[key];
-                if (Array.isArray(mKey)) {
-                    fInfo[mKey[0]] = mKey[1](metadata[key]);
-                }
-                else {
-                    fInfo[EXIFTOOL_MAPPINGS[key]] = metadata[key];
-                }
-            }
+        const raw = await this.runExifTool(pathToFile);
+        return this.toFileInfo(this.parseMetadata(raw));
+    }
+    /**
+     * Extracts file information from a readable stream by piping its content to
+     * exiftool via stdin ( `exiftool -n -` ).
+     *
+     * @param stream readable stream with the file content
+     * @throws {IOFail} when exiftool fails or the stream errors
+     */
+    async getInfoFromStream(stream) {
+        const raw = await this.runExifTool('-', stream);
+        return this.toFileInfo(this.parseMetadata(raw));
+    }
+    /**
+     * Resolves the exiftool binary path, preferring the configured override.
+     */
+    async binaryPath() {
+        if (this.ConfiguredPath) {
+            return this.ConfiguredPath;
         }
-        return fInfo;
+        if (!this.ExifToolPath) {
+            this.ExifToolPath = await resolveExifToolPath();
+            this.Log.trace(`Using exiftool binary: ${this.ExifToolPath}`);
+        }
+        return this.ExifToolPath;
+    }
+    /**
+     * Spawns the exiftool process. Extracted so it can be overridden ( eg. in tests ).
+     */
+    spawnExif(binary, args) {
+        return spawn(binary, args);
     }
-    async spawnExifProcess(file) {
+    /**
+     * Runs exiftool against a file spec ( a path, or `-` for stdin ) and returns
+     * its stdout.
+     *
+     * Success/failure is determined by the process exit code ( not by the mere
+     * presence of stderr, which exiftool uses for non-fatal warnings ). The call
+     * is bounded by {@link Timeout} and any failure is surfaced as {@link IOFail}.
+     *
+     * @param fileArg file path or `-` to read from stdin
+     * @param input optional readable stream piped to the process stdin
+     */
+    async runExifTool(fileArg, input) {
+        const binary = await this.binaryPath();
+        const child = this.spawnExif(binary, [...this.ExifArgs, fileArg]);
         return new Promise((resolve, reject) => {
-            const process = spawn("exiftool", [file, "-n"]);
-            let stdOutBuffer = "";
-            let stdErrBuffer = "";
-            process.on("error", (err) => (reject(err)));
-            process.on("close", () => (stdErrBuffer ? reject(stdErrBuffer) : resolve(stdOutBuffer)));
-            process.stdout.on("data", (data) => (stdOutBuffer += data.toString("utf-8")));
-            process.stderr.on("data", (data) => (stdErrBuffer += data.toString("utf-8")));
+            let stdout = '';
+            let stderr = '';
+            let settled = false;
+            const finish = (fn) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                clearTimeout(timer);
+                fn();
+            };
+            const timer = setTimeout(() => {
+                child.kill('SIGKILL');
+                finish(() => reject(new IOFail(`exiftool timed out after ${this.Timeout}ms`)));
+            }, this.Timeout);
+            child.on('error', (err) => finish(() => reject(new IOFail(`Cannot run exiftool ( ${binary} )`, err))));
+            child.on('close', (code) => finish(() => code === 0
+                ? resolve(stdout)
+                : reject(new IOFail(`exiftool exited with code ${code}${stderr ? `: ${stderr.trim()}` : ''}`))));
+            child.stdout.on('data', (data) => (stdout += data.toString('utf-8')));
+            child.stderr.on('data', (data) => (stderr += data.toString('utf-8')));
+            if (input) {
+                input.on('error', (err) => finish(() => {
+                    child.kill('SIGKILL');
+                    reject(new IOFail('Error reading input stream for exiftool', err));
+                }));
+                input.pipe(child.stdin);
+            }
         });
     }
-    async getMetadata(file) {
-        const raw = await this.spawnExifProcess(file);
-        // Split the response into lines.
-        const response = raw.split("\n");
-        //For each line of the response extract the meta data into a nice associative array
+    /**
+     * Parses raw exiftool text output into a `{ normalisedTag: value }` map with
+     * EVERY emitted tag ( nothing is filtered ).
+     *
+     * Each line is split on the FIRST `': '` only, so values that themselves
+     * contain `': '` are preserved. Values are coerced by {@link coerceValue}
+     * ( numbers and date-shaped strings ).
+     */
+    parseMetadata(raw) {
         const metaData = {};
-        response.forEach(function (responseLine) {
-            var pieces = responseLine.split(": ");
-            //Is this a line with a meta data pair on it?
-            if (pieces.length == 2) {
-                //Turn the plain text data key into a camel case key.
-                var key = pieces[0].trim().split(' ').map(function (tokenInKey, tokenNumber) {
-                    if (tokenNumber === 0)
-                        return tokenInKey.toLowerCase();
-                    else
-                        return tokenInKey[0].toUpperCase() + tokenInKey.slice(1);
-                }).join('');
-                //Trim the value associated with the key to make it nice.
-                var value = pieces[1].trim();
-                if (+value === +value) {
-                    metaData[key] = parseFloat(value);
-                }
-                else {
-                    metaData[key] = value;
-                }
+        for (const line of raw.split('\n')) {
+            const sep = line.indexOf(': ');
+            if (sep === -1) {
+                continue;
             }
-        });
+            const rawKey = line.slice(0, sep).trim();
+            const value = line.slice(sep + 2).trim();
+            if (!rawKey) {
+                continue;
+            }
+            metaData[normalizeTag(rawKey)] = coerceValue(value);
+        }
         return metaData;
     }
+    /**
+     * Projects a parsed metadata map onto {@link IFileInfo}.
+     *
+     * Every extracted tag is promoted: known tags via their {@link TAG_ALIASES}
+     * friendly field name, all others under their PascalCased tag name. The full
+     * unmodified map is always available under `Raw`.
+     */
+    toFileInfo(metadata) {
+        const fInfo = { FileSize: 0 };
+        for (const tag in metadata) {
+            const field = TAG_ALIASES[tag] ?? tag[0].toUpperCase() + tag.slice(1);
+            fInfo[field] = metadata[tag];
+        }
+        // set Raw last so a stray `Raw` tag can never clobber the full map
+        fInfo.Raw = metadata;
+        return fInfo;
+    }
 };
 __decorate([
     Logger('fs'),
     __metadata("design:type", Log)
 ], DefaultFileInfo.prototype, "Log", void 0);
+__decorate([
+    Config('fs.fileInfo.exifToolPath'),
+    __metadata("design:type", String)
+], DefaultFileInfo.prototype, "ConfiguredPath", void 0);
+__decorate([
+    Config('fs.fileInfo.timeout', { defaultValue: DEFAULT_TIMEOUT }),
+    __metadata("design:type", Number)
+], DefaultFileInfo.prototype, "Timeout", void 0);
+__decorate([
+    Config('fs.fileInfo.args', { defaultValue: DEFAULT_ARGS }),
+    __metadata("design:type", Array)
+], DefaultFileInfo.prototype, "ExifArgs", void 0);
 DefaultFileInfo = __decorate([
     Injectable(FileInfoService)
 ], DefaultFileInfo);

package/lib/mjs/file-info.js.map

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

package/lib/mjs/fp.d.ts

@@ -1,4 +1,4 @@
-import { fs, IFileInfo } from './interfaces.js';
+import { fs, IFileInfo, IStat } from './interfaces.js';
 import { Abortable } from 'events';
 /**
  * Gets filesystem by its name
@@ -31,7 +31,85 @@ export declare function _fileInfo(path: string): Promise<IFileInfo>;
  * @returns
  */
 export declare function _file_hash(path: string): Promise<string>;
-export declare function _exists(path: string): () => Promise<boolean>;
+/**
+ * Checks if a path exists.
+ *
+ * Without a filesystem, checks an absolute local path directly. With a filesystem
+ * ( name or instance ), delegates to that provider ( path relative to its base ).
+ *
+ * @param path path to check
+ * @param fileSystem optional provider name / instance
+ */
+export declare function _exists(path: string, fileSystem?: string | fs): () => Promise<boolean>;
+/**
+ * Reads whole file content through a filesystem provider.
+ *
+ * @param path path relative to provider base
+ * @param encoding optional encoding ( raw Buffer when omitted )
+ * @param fileSystem provider name / instance, or default provider
+ */
+export declare function _read(path: string, encoding?: BufferEncoding, fileSystem?: string | fs): Promise<string | Buffer>;
+/**
+ * Writes data to a file through a filesystem provider.
+ */
+export declare function _write(path: string, data: string | Uint8Array, encoding?: BufferEncoding, fileSystem?: string | fs): Promise<void>;
+/**
+ * Appends data to a file through a filesystem provider.
+ */
+export declare function _append(path: string, data: string | Uint8Array, encoding?: BufferEncoding, fileSystem?: string | fs): Promise<void>;
+/**
+ * Copies a file / dir, optionally into another filesystem.
+ *
+ * @param src source path ( relative to srcFs )
+ * @param dst destination path
+ * @param srcFs source provider name / instance ( default provider when omitted )
+ * @param dstFs optional destination provider - copy within srcFs when omitted
+ */
+export declare function _copy(src: string, dst: string, srcFs?: string | fs, dstFs?: string | fs): Promise<void>;
+/**
+ * Moves a file / dir, optionally into another filesystem.
+ */
+export declare function _move(src: string, dst: string, srcFs?: string | fs, dstFs?: string | fs): Promise<void>;
+/**
+ * Renames a file within a single filesystem.
+ */
+export declare function _rename(oldPath: string, newPath: string, fileSystem?: string | fs): Promise<void>;
+/**
+ * Removes a file or a directory ( recursively ).
+ */
+export declare function _rm(path: string, fileSystem?: string | fs): Promise<void>;
+/**
+ * Creates a directory ( recursively ).
+ */
+export declare function _mkdir(path: string, fileSystem?: string | fs): Promise<void>;
+/**
+ * Lists directory content.
+ */
+export declare function _list(path: string, fileSystem?: string | fs): Promise<string[]>;
+/**
+ * Returns file / dir statistics.
+ */
+export declare function _stat(path: string, fileSystem?: string | fs): Promise<IStat>;
+/**
+ * Checks if a path is an existing directory.
+ */
+export declare function _dir_exists(path: string, fileSystem?: string | fs): Promise<boolean>;
+/**
+ * Checks if a path is a directory.
+ */
+export declare function _is_dir(path: string, fileSystem?: string | fs): Promise<boolean>;
+/**
+ * Downloads a file to local storage and returns the local path.
+ */
+export declare function _download(path: string, fileSystem?: string | fs): Promise<string>;
+/**
+ * Uploads a local file into a filesystem provider.
+ */
+export declare function _upload(srcPath: string, dstPath?: string, fileSystem?: string | fs): Promise<void>;
+/**
+ * Hashes a file through a filesystem provider.
+ */
+export declare function _hash(path: string, algo?: string, fileSystem?: string | fs): Promise<string>;
 export declare function _is_of_type(path: string, extension: string): () => Promise<void>;
 export declare function _is_of_mimetype(path: string, mimetype: string): () => Promise<void>;
 export declare function _read_file(path: string, options?: ({

package/lib/mjs/fp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fp.d.ts","sourceRoot":"","sources":["../../src/fp.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,EAAE,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAUjE;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,oBAI3E;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,oBAI3E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,0BAQnC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAQ1D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,uBAQ7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAC7C,CAAC;IACD,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,GAAG,SAAS,CAAC,GACZ,SAAS,GACT,IAAI,GAAI,MAAM,OAAO,CAAC,MAAM,CAAC,CAahC"}
+{"version":3,"file":"fp.d.ts","sourceRoot":"","sources":["../../src/fp.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AA2BnC;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAUjE;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,oBAI3E;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,oBAI3E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,0BAY7D;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAEjH;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAElI;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnI;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvG;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvG;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjG;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE/E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAElG;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5F;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAQ1D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,uBAQ7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAC7C,CAAC;IACD,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,GAAG,SAAS,CAAC,GACZ,SAAS,GACT,IAAI,GAAI,MAAM,OAAO,CAAC,MAAM,CAAC,CAahC"}