@harperfast/harper 5.0.0-alpha.10

package/dist/components/Component.d.ts

@@ -0,0 +1,21 @@
+import { FastGlobOptions, FilesOption } from './deriveGlobOptions';
+interface ComponentConfig {
+    files: FilesOption;
+    urlPath?: string;
+    [key: string]: unknown;
+}
+export type FileAndURLPathConfig = Pick<ComponentConfig, 'files' | 'urlPath'>;
+export declare class ComponentInvalidPatternError extends Error {
+    constructor(pattern: string);
+}
+export declare class Component {
+    readonly globOptions: FastGlobOptions;
+    readonly baseURLPath: string;
+    readonly patternBases: string[];
+    readonly directory: string;
+    readonly name: string;
+    readonly config: ComponentConfig;
+    readonly commonPatternBase: string;
+    constructor(name: string, directory: string, config: ComponentConfig);
+}
+export {};

package/dist/components/Component.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Component = exports.ComponentInvalidPatternError = void 0;
+const resolveBaseURLPath_1 = require("./resolveBaseURLPath");
+const deriveCommonPatternBase_1 = require("./deriveCommonPatternBase");
+const deriveGlobOptions_1 = require("./deriveGlobOptions");
+const micromatch_1 = require("micromatch");
+class ComponentInvalidPatternError extends Error {
+    constructor(pattern) {
+        super(`Config 'files' option glob pattern must not contain '..' or start with '/'. Received: '${pattern}'`);
+        this.name = 'ComponentInvalidPatternError';
+    }
+}
+exports.ComponentInvalidPatternError = ComponentInvalidPatternError;
+class Component {
+    globOptions;
+    baseURLPath;
+    patternBases;
+    directory;
+    name;
+    config;
+    commonPatternBase;
+    constructor(name, directory, config) {
+        this.name = name;
+        this.directory = directory;
+        this.config = config;
+        this.baseURLPath = (0, resolveBaseURLPath_1.resolveBaseURLPath)(this.name, this.config.urlPath);
+        this.globOptions = (0, deriveGlobOptions_1.deriveGlobOptions)(this.config.files);
+        this.globOptions.source = this.globOptions.source.map((pattern) => {
+            if (pattern.includes('..') || pattern.startsWith('/')) {
+                throw new ComponentInvalidPatternError(pattern);
+            }
+            if (pattern === '.' || pattern === './') {
+                return '**/*';
+            }
+            return pattern;
+        });
+        this.patternBases = this.globOptions.source.map((pattern) => (0, micromatch_1.scan)(pattern).base);
+        this.commonPatternBase = (0, deriveCommonPatternBase_1.deriveCommonPatternBase)(this.patternBases);
+    }
+}
+exports.Component = Component;
+//# sourceMappingURL=Component.js.map

package/dist/components/Component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.js","sourceRoot":"","sources":["../../components/Component.ts"],"names":[],"mappings":";;;AAAA,6DAA0D;AAC1D,uEAAoE;AACpE,2DAAsF;AACtF,2CAAkC;AAUlC,MAAa,4BAA6B,SAAQ,KAAK;IACtD,YAAY,OAAe;QAC1B,KAAK,CAAC,0FAA0F,OAAO,GAAG,CAAC,CAAC;QAC5G,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC5C,CAAC;CACD;AALD,oEAKC;AAED,MAAa,SAAS;IACZ,WAAW,CAAkB;IAC7B,WAAW,CAAS;IACpB,YAAY,CAAW;IACvB,SAAS,CAAS;IAClB,IAAI,CAAS;IACb,MAAM,CAAkB;IACxB,iBAAiB,CAAS;IAEnC,YAAY,IAAY,EAAE,SAAiB,EAAE,MAAuB;QACnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,WAAW,GAAG,IAAA,uCAAkB,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEtE,IAAI,CAAC,WAAW,GAAG,IAAA,qCAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YAED,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACzC,OAAO,MAAM,CAAC;YACf,CAAC;YAED,OAAO,OAAO,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAA,iBAAI,EAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,iBAAiB,GAAG,IAAA,iDAAuB,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrE,CAAC;CACD;AAhCD,8BAgCC"}

package/dist/components/ComponentV1.d.ts

@@ -0,0 +1,69 @@
+import { Resources } from '../resources/Resources.ts';
+import { FastGlobOptions, FilesOption } from './deriveGlobOptions.ts';
+interface ComponentV1Config {
+    files: string | string[] | FilesOption;
+    /** @deprecated */ path?: string;
+    urlPath?: string;
+    /** @deprecated */ root?: string;
+    [key: string]: any;
+}
+interface ComponentV1Module {
+    setupDirectory?: (urlPath: string, absolutePath: string, resources: Resources) => Promise<undefined | boolean>;
+    handleDirectory?: (urlPath: string, absolutePath: string, resources: Resources) => Promise<undefined | boolean>;
+    setupFile?: (contents: Buffer, urlPath: string, absolutePath: string, resources: Resources) => Promise<void>;
+    handleFile?: (contents: Buffer, urlPath: string, absolutePath: string, resources: Resources) => Promise<void>;
+}
+interface ComponentV1Details {
+    config: ComponentV1Config;
+    name: string;
+    directory: string;
+    module: ComponentV1Module;
+    resources: Resources;
+}
+export declare class ComponentV1 {
+    readonly config: Readonly<ComponentV1Config>;
+    readonly name: string;
+    readonly directory: string;
+    readonly module: Readonly<ComponentV1Module>;
+    readonly resources: Resources;
+    readonly globOptions: FastGlobOptions;
+    readonly patternBases: string[];
+    readonly baseURLPath: string;
+    constructor(options: ComponentV1Details);
+}
+export declare class ComponentV1ProcessingError extends Error {
+    constructor(message: string, component: ComponentV1Details);
+}
+export declare class InvalidFilesOptionError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+export declare class InvalidFilesSourceOptionError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+export declare class InvalidFilesOnlyOptionError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+export declare class InvalidFileIgnoreOptionError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+export declare class InvalidGlobPattern extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details, pattern: string);
+}
+export declare class InvalidRootOptionError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+export declare class InvalidRootOptionUseError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+export declare class InvalidPathOptionError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+export declare class InvalidURLPathOptionError extends ComponentV1ProcessingError {
+    constructor(component: ComponentV1Details);
+}
+/**
+ * Process a Resource Extension component by evaluating the files glob pattern
+ * and then calling the appropriate setup/handle functions.
+ */
+export declare function processResourceExtensionComponent(component: ComponentV1): Promise<boolean>;
+export {};

package/dist/components/ComponentV1.js

@@ -0,0 +1,263 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidURLPathOptionError = exports.InvalidPathOptionError = exports.InvalidRootOptionUseError = exports.InvalidRootOptionError = exports.InvalidGlobPattern = exports.InvalidFileIgnoreOptionError = exports.InvalidFilesOnlyOptionError = exports.InvalidFilesSourceOptionError = exports.InvalidFilesOptionError = exports.ComponentV1ProcessingError = exports.ComponentV1 = void 0;
+exports.processResourceExtensionComponent = processResourceExtensionComponent;
+const node_worker_threads_1 = require("node:worker_threads");
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const harper_logger_js_1 = __importDefault(require("../utility/logging/harper_logger.js"));
+const resolveBaseURLPath_ts_1 = require("./resolveBaseURLPath.js");
+const deriveGlobOptions_ts_1 = require("./deriveGlobOptions.js");
+const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const deriveURLPath_ts_1 = require("./deriveURLPath.js");
+const micromatch_1 = require("micromatch");
+class ComponentV1 {
+    config;
+    name;
+    directory;
+    module;
+    resources;
+    globOptions;
+    patternBases;
+    baseURLPath;
+    constructor(options) {
+        // TO DO: Unfortunately `readonly` is a TS only thing and doesn't actually enforce that these properties can't be modified.
+        // Freeze these things so they can't be changed. likely do this at the end of the constructor
+        this.config = options.config;
+        this.name = options.name;
+        this.directory = options.directory;
+        this.module = options.module;
+        this.resources = options.resources;
+        // Config option basic validation
+        if (!isNonEmptyString(this.config.files) &&
+            !isArrayOfNonEmptyStrings(this.config.files) &&
+            !isObject(this.config.files)) {
+            throw new InvalidFilesOptionError(this);
+        }
+        // Validating the `files` object
+        if (typeof this.config.files === 'object' && !Array.isArray(this.config.files)) {
+            if (this.config.files.source === undefined ||
+                (!isArrayOfNonEmptyStrings(this.config.files.source) && !isNonEmptyString(this.config.files.source))) {
+                throw new InvalidFilesSourceOptionError(this);
+            }
+            if (this.config.files.only !== undefined &&
+                (typeof this.config.files.only !== 'string' ||
+                    !['all', 'files', 'directories'].includes(this.config.files.only))) {
+                throw new InvalidFilesOnlyOptionError(this);
+            }
+            if (this.config.files.ignore !== undefined &&
+                !isArrayOfNonEmptyStrings(this.config.files.ignore) &&
+                !isNonEmptyString(this.config.files.ignore)) {
+                throw new InvalidFileIgnoreOptionError(this);
+            }
+        }
+        // Validate the deprecated options too
+        if (this.config.root !== undefined && !isNonEmptyString(this.config.root)) {
+            throw new InvalidRootOptionError(this);
+        }
+        if (this.config.path !== undefined && !isNonEmptyString(this.config.path)) {
+            throw new InvalidPathOptionError(this);
+        }
+        // Handle deprecated `path` option
+        if (this.config.path) {
+            harper_logger_js_1.default.warn(`Resource extension 'path' option is deprecated. Please replace with 'urlPath'.`);
+            this.config.urlPath = this.config.path;
+        }
+        // Validate the `urlPath`
+        if (this.config.urlPath !== undefined &&
+            (!isNonEmptyString(this.config.urlPath) ||
+                (typeof this.config.urlPath === 'string' && this.config.urlPath.includes('..')))) {
+            throw new InvalidURLPathOptionError(this);
+        }
+        this.globOptions = (0, deriveGlobOptions_ts_1.deriveGlobOptions)(this.config.files);
+        // Validate and transform glob patterns
+        this.globOptions.source = this.globOptions.source.map((pattern) => {
+            if (pattern.includes('..')) {
+                throw new InvalidGlobPattern(this, pattern);
+            }
+            if (pattern.startsWith('/')) {
+                harper_logger_js_1.default.warn(`Leading '/' in 'files' glob pattern is deprecated. For backwards compatibility purposes, it is currently transformed to the relative path of the component, but in the future will result in an error. Paths are automatically derived from the root of the component directory. Please remove (e.g. '/web/*' -> 'web/*').`);
+                pattern = pattern === '/' ? '.' : pattern.slice(1);
+            }
+            return pattern;
+        });
+        this.patternBases = this.globOptions.source.map((pattern) => (0, micromatch_1.scan)(pattern).base);
+        this.baseURLPath = (0, resolveBaseURLPath_ts_1.resolveBaseURLPath)(this.name, this.config.urlPath);
+    }
+}
+exports.ComponentV1 = ComponentV1;
+class ComponentV1ProcessingError extends Error {
+    constructor(message, component) {
+        super(`Component ${component.name} (from ${(0, node_path_1.basename)(component.directory)}) ${message}`);
+    }
+}
+exports.ComponentV1ProcessingError = ComponentV1ProcessingError;
+class InvalidFilesOptionError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`'files' option must be a non-empty string, an array of non-empty strings, or an object.`, component);
+    }
+}
+exports.InvalidFilesOptionError = InvalidFilesOptionError;
+class InvalidFilesSourceOptionError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`'files' object must have a non-empty 'source' property.`, component);
+    }
+}
+exports.InvalidFilesSourceOptionError = InvalidFilesSourceOptionError;
+class InvalidFilesOnlyOptionError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`'files.only' option must be one of 'all', 'files', or 'directories'.`, component);
+    }
+}
+exports.InvalidFilesOnlyOptionError = InvalidFilesOnlyOptionError;
+class InvalidFileIgnoreOptionError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`'files.ignore' option must be a non-empty string or an array of non-empty strings.`, component);
+    }
+}
+exports.InvalidFileIgnoreOptionError = InvalidFileIgnoreOptionError;
+class InvalidGlobPattern extends ComponentV1ProcessingError {
+    constructor(component, pattern) {
+        super(`'files' glob pattern must not contain '..'. Received: '${pattern}'`, component);
+    }
+}
+exports.InvalidGlobPattern = InvalidGlobPattern;
+class InvalidRootOptionError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`deprecated 'root' option must be a non-empty string. Consider removing and updating 'files' glob pattern instead.`, component);
+    }
+}
+exports.InvalidRootOptionError = InvalidRootOptionError;
+class InvalidRootOptionUseError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`the 'root' option is deprecated and only supported if 'files' is a singular, non-empty string. Please remove the 'root' option and modify the 'files' glob pattern instead.`, component);
+    }
+}
+exports.InvalidRootOptionUseError = InvalidRootOptionUseError;
+class InvalidPathOptionError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`deprecated 'path' option must be a non-empty string. Consider replacing with 'urlPath'.`, component);
+    }
+}
+exports.InvalidPathOptionError = InvalidPathOptionError;
+class InvalidURLPathOptionError extends ComponentV1ProcessingError {
+    constructor(component) {
+        super(`'urlPath' option must be a non-empty string that must not contain '..'.`, component);
+    }
+}
+exports.InvalidURLPathOptionError = InvalidURLPathOptionError;
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+function isArrayOfNonEmptyStrings(value) {
+    return Array.isArray(value) && value.length !== 0 && value.every((item) => isNonEmptyString(item));
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+async function handleRoots(component) {
+    if (component.config.root) {
+        harper_logger_js_1.default.warn(`Resource extension 'root' option is deprecated. Due to backwards compatibility reasons it does not act as assumed. The glob pattern will always be evaluated from the component directory root. The option is only used for the initial root directory handling. Please remove and modify the 'files' glob pattern instead.`);
+    }
+    // For backwards compatibility, we need to evaluate the root path via the existing logic. This is only valid if `root` is defined, and `files` is a strings that doesn't contain `**/*`,
+    // And if that existing logic does not produce a reasonable root path to evaluate, we can consider the configure "new" and evaluate it based on a new process
+    let rootPaths = [];
+    if (component.config.root && typeof component.config.files !== 'string') {
+        throw new InvalidRootOptionUseError(component);
+    }
+    // This starts old root handling
+    let rootPath = component.config.root;
+    if (rootPath) {
+        // trim any leading slashes
+        if (rootPath.startsWith('/')) {
+            rootPath = rootPath.slice(1);
+        }
+        // add a trailing slash if it doesn't exist
+        if (!rootPath.endsWith('/')) {
+            rootPath += '/';
+        }
+    }
+    const pattern = component.config.files;
+    // This is still old root handling logic - operate only a singular pattern
+    if (typeof pattern === 'string' && !pattern.includes('**/*')) {
+        if (pattern.indexOf('/*') > -1) {
+            rootPath = pattern.slice(0, pattern.indexOf('/*') + 1);
+        }
+        else if (pattern.indexOf('/') > -1) {
+            rootPath = pattern.slice(0, pattern.lastIndexOf('/') + 1);
+        }
+    }
+    if (rootPath)
+        rootPaths.push(rootPath);
+    // If old handling did not result in a root path, now use the patternRoots derived from the processed glob patterns
+    if (rootPaths.length === 0) {
+        // Return early if we are only processing files
+        if (isObject(component.config.files) && component.config.files.only === 'files') {
+            return false;
+        }
+        rootPaths = component.patternBases;
+    }
+    let hasFunctionality = false;
+    for (const rootPath of rootPaths) {
+        const rootPathAbsolute = (0, node_path_1.join)(component.directory, rootPath);
+        if (node_worker_threads_1.isMainThread && component.module.setupDirectory) {
+            hasFunctionality = await component.module.setupDirectory(component.baseURLPath, rootPathAbsolute, component.resources);
+        }
+        if (component.resources.isWorker && component.module.handleDirectory) {
+            hasFunctionality = await component.module.handleDirectory(component.baseURLPath, rootPathAbsolute, component.resources);
+        }
+    }
+    return hasFunctionality;
+}
+/**
+ * Process a Resource Extension component by evaluating the files glob pattern
+ * and then calling the appropriate setup/handle functions.
+ */
+async function processResourceExtensionComponent(component) {
+    let hasFunctionality = false;
+    hasFunctionality = await handleRoots(component);
+    // Return early if roots were functional
+    if (hasFunctionality)
+        return hasFunctionality;
+    const matches = await (0, fast_glob_1.default)(component.globOptions.source, {
+        cwd: component.directory,
+        objectMode: true,
+        onlyFiles: component.globOptions.onlyFiles,
+        onlyDirectories: component.globOptions.onlyDirectories,
+        ignore: component.globOptions.ignore,
+    });
+    for (const entry of matches) {
+        const absolutePath = (0, node_path_1.join)(component.directory, entry.path);
+        if (entry.dirent.isDirectory()) {
+            const urlPath = (0, deriveURLPath_ts_1.deriveURLPath)(component, entry.path, 'directory');
+            if (node_worker_threads_1.isMainThread && component.module.setupDirectory) {
+                await component.module.setupDirectory(urlPath, absolutePath, component.resources);
+                hasFunctionality = true;
+            }
+            if (component.resources.isWorker && component.module.handleDirectory) {
+                await component.module.handleDirectory(urlPath, absolutePath, component.resources);
+                hasFunctionality = true;
+            }
+        }
+        else if (entry.dirent.isFile()) {
+            const urlPath = (0, deriveURLPath_ts_1.deriveURLPath)(component, entry.path, 'file');
+            const contents = await (0, promises_1.readFile)(absolutePath);
+            if (node_worker_threads_1.isMainThread && component.module.setupFile) {
+                await component.module.setupFile(contents, urlPath, absolutePath, component.resources);
+                hasFunctionality = true;
+            }
+            else if (component.resources.isWorker && component.module.handleFile) {
+                await component.module.handleFile(contents, urlPath, absolutePath, component.resources);
+                hasFunctionality = true;
+            }
+        }
+        else {
+            harper_logger_js_1.default.error(`Entry received from glob pattern match for component ${component.name} is neither a file nor a directory:`, entry);
+        }
+    }
+    return hasFunctionality;
+}
+//# sourceMappingURL=ComponentV1.js.map

package/dist/components/ComponentV1.js.map

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

package/dist/components/DEFAULT_CONFIG.d.ts

@@ -0,0 +1,18 @@
+export declare const DEFAULT_CONFIG: {
+    rest: boolean;
+    graphqlSchema: {
+        files: string;
+    };
+    roles: {
+        files: string;
+    };
+    jsResource: {
+        files: string;
+    };
+    fastifyRoutes: {
+        files: string;
+    };
+    static: {
+        files: string;
+    };
+};

package/dist/components/DEFAULT_CONFIG.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.DEFAULT_CONFIG = {
+    rest: true,
+    graphqlSchema: {
+        files: '*.graphql',
+    },
+    roles: {
+        files: 'roles.yaml',
+    },
+    jsResource: {
+        files: 'resources.js',
+    },
+    fastifyRoutes: {
+        files: 'routes/*.js',
+    },
+    static: {
+        files: 'web/**',
+    },
+};
+//# sourceMappingURL=DEFAULT_CONFIG.js.map

package/dist/components/DEFAULT_CONFIG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEFAULT_CONFIG.js","sourceRoot":"","sources":["../../components/DEFAULT_CONFIG.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG;IAC7B,IAAI,EAAE,IAAI;IACV,aAAa,EAAE;QACd,KAAK,EAAE,WAAW;KAClB;IACD,KAAK,EAAE;QACN,KAAK,EAAE,YAAY;KACnB;IACD,UAAU,EAAE;QACX,KAAK,EAAE,cAAc;KACrB;IACD,aAAa,EAAE;QACd,KAAK,EAAE,aAAa;KACpB;IACD,MAAM,EAAE;QACP,KAAK,EAAE,QAAQ;KACf;CACD,CAAC"}

package/dist/components/EntryHandler.d.ts

@@ -0,0 +1,61 @@
+import { type Logger } from '../utility/logging/logger.ts';
+import type { Stats } from 'node:fs';
+import { EventEmitter } from 'node:events';
+import { FileAndURLPathConfig } from './Component.js';
+import { FilesOption } from './deriveGlobOptions.js';
+export interface BaseEntry {
+    stats?: Stats;
+    urlPath: string;
+    absolutePath: string;
+}
+export interface FileEntry extends BaseEntry {
+    contents: Buffer;
+}
+export interface EntryEvent extends BaseEntry {
+    eventType: string;
+    entryType: string;
+}
+export interface AddFileEvent extends EntryEvent, FileEntry {
+    eventType: 'add';
+    entryType: 'file';
+}
+export interface ChangeFileEvent extends EntryEvent, FileEntry {
+    eventType: 'change';
+    entryType: 'file';
+}
+export interface UnlinkFileEvent extends EntryEvent {
+    eventType: 'unlink';
+    entryType: 'file';
+}
+export type FileEntryEvent = AddFileEvent | ChangeFileEvent | UnlinkFileEvent;
+export interface AddDirectoryEvent extends EntryEvent {
+    eventType: 'addDir';
+    entryType: 'directory';
+}
+export interface UnlinkDirectoryEvent extends EntryEvent {
+    eventType: 'unlinkDir';
+    entryType: 'directory';
+}
+export type DirectoryEntryEvent = AddDirectoryEvent | UnlinkDirectoryEvent;
+export type onEntryEventHandler = (entry: FileEntryEvent | DirectoryEntryEvent) => void | Promise<void>;
+export type EntryHandlerEventMap = {
+    all: [entry: FileEntryEvent | DirectoryEntryEvent];
+    close: [];
+    error: [error: unknown];
+    ready: [];
+    initialLoadComplete: [];
+    add: [entry: AddFileEvent];
+    change: [entry: ChangeFileEvent];
+    unlink: [entry: UnlinkFileEvent];
+    addDir: [entry: AddDirectoryEvent];
+    unlinkDir: [entry: UnlinkDirectoryEvent];
+};
+export declare class EntryHandler extends EventEmitter<EntryHandlerEventMap> {
+    #private;
+    ready: Promise<any[]>;
+    constructor(name: string, directory: string, config: FilesOption | FileAndURLPathConfig, logger?: Logger);
+    get name(): string;
+    get directory(): string;
+    close(): this;
+    update(config: FilesOption | FileAndURLPathConfig): Promise<any[]>;
+}