simple-fs-rotator/lib/types.d.ts

Automated stream rotation useful for log files

import { KeepLogFiles, Frequency } from "./enums";
export declare type KeepSettings = {
    type?: KeepLogFiles;
    amount?: number;
};
export declare type AuditSettings = {
    keepSettings?: KeepSettings;
    auditFilename?: string;
    hashType: string;
    extension: string;
    files: Array<AuditEntry>;
};
export declare type RotationSettings = {
    filename: string;
    frequency: Frequency;
    amount?: number;
    maxSize?: number;
    format?: string;
    utc: boolean;
    extension?: string;
    keepSettings?: KeepSettings;
};
export declare type FileOptions = {
    flags?: string;
    encoding?: string;
    mode?: number;
    autoClose?: boolean;
    emitClose?: boolean;
};
export declare type FileStreamRotatorOptions = {
    /** Filename including full path used by the stream */
    filename: string;
    /**
     * How often to rotate. Options are '*daily*' for daily rotation, '*date*' based on *date_format*, '*[1-12]h*' to rotate every 1-12 hours,
     * '*[1-30]m*' to rotate every 1-30 minutes.
     */
    frequency?: string;
    /** If set, it will use console.log to provide extra information when events happen. Default is false  */
    verbose?: boolean;
    /**
     * Use 'Y' for full year, 'M' for month, 'D' for day, 'H' for hour, 'm' for minutes, 's' for seconds
     * If using '*date*' frequency, it is used to trigger file change when the string representation changes.
     * It will be used to replace %DATE% in the filename. All replacements are numeric only.
     */
    date_format?: string;
    /**
     * Max size of the file after which it will rotate. It can be combined with frequency or date format.
     * The size units are 'k', 'm' and 'g'. Units need to directly follow a number e.g. 1g, 100m, 20k.
     */
    size?: string;
    /**
     * Max number of logs to keep. If not set, it won't remove past logs. It uses its own log audit file
     * to keep track of the log files in a json format. It won't delete any file not contained in it.
     * It can be a number of files or number of days. If using days, add 'd' as the suffix. e.g., '10d' for 10 days.
     */
    max_logs?: string;
    /** Location to store the log audit file. If not set, it will be stored in the root of the application. */
    audit_file?: string;
    /**
     * End stream (true) instead of the default behaviour of destroy (false). Set value to true if when writing to the
     * stream in a loop, if the application terminates or log rotates, data pending to be flushed might be lost.
     */
    end_stream?: boolean;
    /**
     * An object passed to the stream. This can be used to specify flags, encoding, and mode.
     * See https://nodejs.org/api/fs.html#fs_fs_createwritestream_path_options. Default `{ flags: 'a' }`.
     */
    file_options?: FileOptions;
    /** Use UTC time for date in filename. Defaults to 'false' */
    utc?: boolean;
    /**
     * File extension to be appended to the filename. This is useful when using size restrictions as the rotation
     * adds a count (1,2,3,4,...) at the end of the filename when the required size is met.
     */
    extension?: string;
    /**
     * Create a tailable symlink to the current active log file. Defaults to 'false'
     */
    create_symlink?: boolean;
    /**
     * Name to use when creating the symbolic link. Defaults to 'current.log'
     */
    symlink_name?: string;
    /** Use specified hashing algorithm for audit. Defaults to 'md5'. Use 'sha256' for FIPS compliance. */
    audit_hash_type?: "md5" | "sha256";
    rotate?: (path: string) => Promise<void>;
};
export declare type FileStreamRotatorConfig = {
    options?: FileStreamRotatorOptions;
    auditSettings?: AuditSettings;
    fileOptions?: FileOptions;
    rotationSettings?: RotationSettings;
};
export declare type NumberAlphaParam = {
    number: number;
    letter?: string;
};
export declare type DateComponents = {
    year: number;
    month: number;
    day: number;
    hour: number;
    minute: number;
    second: number;
    utc: boolean;
    source: Date;
};
export declare type AuditConfigFile = {
    keep: {
        type: KeepLogFiles;
        amount: number;
    };
    auditLog: string;
    files: Array<AuditEntry>;
    hashType: string;
    extension: string;
};
export declare type AuditEntry = {
    date: number;
    name: string;
    hash: string;
};