source: trip-planner-front/node_modules/memfs/lib/volume.d.ts@ fa375fe

Last change on this file since fa375fe was 6a3a178, checked in by Ema <ema_spirova@…>, 3 years ago

initial commit
  • Property mode set to 100644
File size: 16.4 KB
Line 
1/// <reference types="node" />
2import { PathLike, symlink } from 'fs';
3import { Node, Link, File } from './node';
4import Stats from './Stats';
5import Dirent from './Dirent';
6import { TSetTimeout } from './setTimeoutUnref';
7import { Readable, Writable } from 'stream';
8import { constants } from './constants';
9import { EventEmitter } from 'events';
10import { TEncodingExtended, TDataOut } from './encoding';
11export interface IError extends Error {
12 code?: string;
13}
14export declare type TFileId = PathLike | number;
15export declare type TData = TDataOut | Uint8Array;
16export declare type TFlags = string | number;
17export declare type TMode = string | number;
18export declare type TTime = number | string | Date;
19export declare type TCallback<TData> = (error?: IError | null, data?: TData) => void;
20export declare enum FLAGS {
21 r,
22 'r+',
23 rs,
24 sr,
25 'rs+',
26 'sr+',
27 w,
28 wx,
29 xw,
30 'w+',
31 'wx+',
32 'xw+',
33 a,
34 ax,
35 xa,
36 'a+',
37 'ax+',
38 'xa+'
39}
40export declare type TFlagsCopy = typeof constants.COPYFILE_EXCL | typeof constants.COPYFILE_FICLONE | typeof constants.COPYFILE_FICLONE_FORCE;
41export declare function flagsToNumber(flags: TFlags | undefined): number;
42export interface IOptions {
43 encoding?: BufferEncoding | TEncodingExtended;
44}
45export interface IFileOptions extends IOptions {
46 mode?: TMode;
47 flag?: TFlags;
48}
49export interface IReadFileOptions extends IOptions {
50 flag?: string;
51}
52export interface IWriteFileOptions extends IFileOptions {
53}
54export interface IAppendFileOptions extends IFileOptions {
55}
56export interface IRealpathOptions {
57 encoding?: TEncodingExtended;
58}
59export interface IWatchFileOptions {
60 persistent?: boolean;
61 interval?: number;
62}
63export interface IReadStreamOptions {
64 flags?: TFlags;
65 encoding?: BufferEncoding;
66 fd?: number;
67 mode?: TMode;
68 autoClose?: boolean;
69 start?: number;
70 end?: number;
71}
72export interface IWriteStreamOptions {
73 flags?: TFlags;
74 defaultEncoding?: BufferEncoding;
75 fd?: number;
76 mode?: TMode;
77 autoClose?: boolean;
78 start?: number;
79}
80export interface IWatchOptions extends IOptions {
81 persistent?: boolean;
82 recursive?: boolean;
83}
84export interface IMkdirOptions {
85 mode?: TMode;
86 recursive?: boolean;
87}
88export interface IRmdirOptions {
89 recursive?: boolean;
90}
91export interface IRmOptions {
92 force?: boolean;
93 maxRetries?: number;
94 recursive?: boolean;
95 retryDelay?: number;
96}
97export interface IReaddirOptions extends IOptions {
98 withFileTypes?: boolean;
99}
100export interface IStatOptions {
101 bigint?: boolean;
102}
103export declare function pathToFilename(path: PathLike): string;
104export declare function filenameToSteps(filename: string, base?: string): string[];
105export declare function pathToSteps(path: PathLike): string[];
106export declare function dataToStr(data: TData, encoding?: string): string;
107export declare function dataToBuffer(data: TData, encoding?: string): Buffer;
108export declare function bufferToEncoding(buffer: Buffer, encoding?: TEncodingExtended): TDataOut;
109export declare function toUnixTimestamp(time: any): any;
110declare type DirectoryContent = string | null;
111export interface DirectoryJSON {
112 [key: string]: DirectoryContent;
113}
114export interface NestedDirectoryJSON {
115 [key: string]: DirectoryContent | NestedDirectoryJSON;
116}
117/**
118 * `Volume` represents a file system.
119 */
120export declare class Volume {
121 static fromJSON(json: DirectoryJSON, cwd?: string): Volume;
122 static fromNestedJSON(json: NestedDirectoryJSON, cwd?: string): Volume;
123 /**
124 * Global file descriptor counter. UNIX file descriptors start from 0 and go sequentially
125 * up, so here, in order not to conflict with them, we choose some big number and descrease
126 * the file descriptor of every new opened file.
127 * @type {number}
128 * @todo This should not be static, right?
129 */
130 static fd: number;
131 root: Link;
132 ino: number;
133 inodes: {
134 [ino: number]: Node;
135 };
136 releasedInos: number[];
137 fds: {
138 [fd: number]: File;
139 };
140 releasedFds: number[];
141 maxFiles: number;
142 openFiles: number;
143 StatWatcher: new () => StatWatcher;
144 ReadStream: new (...args: any[]) => IReadStream;
145 WriteStream: new (...args: any[]) => IWriteStream;
146 FSWatcher: new () => FSWatcher;
147 props: {
148 Node: new (...args: any[]) => Node;
149 Link: new (...args: any[]) => Link;
150 File: new (...args: any[]) => File;
151 };
152 private promisesApi;
153 get promises(): import("./promises").IPromisesAPI;
154 constructor(props?: {});
155 createLink(): Link;
156 createLink(parent: Link, name: string, isDirectory?: boolean, perm?: number): Link;
157 deleteLink(link: Link): boolean;
158 private newInoNumber;
159 private newFdNumber;
160 createNode(isDirectory?: boolean, perm?: number): Node;
161 private getNode;
162 private deleteNode;
163 genRndStr(): any;
164 getLink(steps: string[]): Link | null;
165 getLinkOrThrow(filename: string, funcName?: string): Link;
166 getResolvedLink(filenameOrSteps: string | string[]): Link | null;
167 getResolvedLinkOrThrow(filename: string, funcName?: string): Link;
168 resolveSymlinks(link: Link): Link | null;
169 private getLinkAsDirOrThrow;
170 private getLinkParent;
171 private getLinkParentAsDirOrThrow;
172 private getFileByFd;
173 private getFileByFdOrThrow;
174 /**
175 * @todo This is not used anymore. Remove.
176 */
177 private wrapAsync;
178 private _toJSON;
179 toJSON(paths?: PathLike | PathLike[], json?: {}, isRelative?: boolean): DirectoryJSON;
180 fromJSON(json: DirectoryJSON, cwd?: string): void;
181 fromNestedJSON(json: NestedDirectoryJSON, cwd?: string): void;
182 reset(): void;
183 mountSync(mountpoint: string, json: DirectoryJSON): void;
184 private openLink;
185 private openFile;
186 private openBase;
187 openSync(path: PathLike, flags: TFlags, mode?: TMode): number;
188 open(path: PathLike, flags: TFlags, /* ... */ callback: TCallback<number>): any;
189 open(path: PathLike, flags: TFlags, mode: TMode, callback: TCallback<number>): any;
190 private closeFile;
191 closeSync(fd: number): void;
192 close(fd: number, callback: TCallback<void>): void;
193 private openFileOrGetById;
194 private readBase;
195 readSync(fd: number, buffer: Buffer | Uint8Array, offset: number, length: number, position: number): number;
196 read(fd: number, buffer: Buffer | Uint8Array, offset: number, length: number, position: number, callback: (err?: Error | null, bytesRead?: number, buffer?: Buffer | Uint8Array) => void): void;
197 private readFileBase;
198 readFileSync(file: TFileId, options?: IReadFileOptions | string): TDataOut;
199 readFile(id: TFileId, callback: TCallback<TDataOut>): any;
200 readFile(id: TFileId, options: IReadFileOptions | string, callback: TCallback<TDataOut>): any;
201 private writeBase;
202 writeSync(fd: number, buffer: Buffer | Uint8Array, offset?: number, length?: number, position?: number): number;
203 writeSync(fd: number, str: string, position?: number, encoding?: BufferEncoding): number;
204 write(fd: number, buffer: Buffer | Uint8Array, callback: (...args: any[]) => void): any;
205 write(fd: number, buffer: Buffer | Uint8Array, offset: number, callback: (...args: any[]) => void): any;
206 write(fd: number, buffer: Buffer | Uint8Array, offset: number, length: number, callback: (...args: any[]) => void): any;
207 write(fd: number, buffer: Buffer | Uint8Array, offset: number, length: number, position: number, callback: (...args: any[]) => void): any;
208 write(fd: number, str: string, callback: (...args: any[]) => void): any;
209 write(fd: number, str: string, position: number, callback: (...args: any[]) => void): any;
210 write(fd: number, str: string, position: number, encoding: BufferEncoding, callback: (...args: any[]) => void): any;
211 private writeFileBase;
212 writeFileSync(id: TFileId, data: TData, options?: IWriteFileOptions): void;
213 writeFile(id: TFileId, data: TData, callback: TCallback<void>): any;
214 writeFile(id: TFileId, data: TData, options: IWriteFileOptions | string, callback: TCallback<void>): any;
215 private linkBase;
216 private copyFileBase;
217 copyFileSync(src: PathLike, dest: PathLike, flags?: TFlagsCopy): void;
218 copyFile(src: PathLike, dest: PathLike, callback: TCallback<void>): any;
219 copyFile(src: PathLike, dest: PathLike, flags: TFlagsCopy, callback: TCallback<void>): any;
220 linkSync(existingPath: PathLike, newPath: PathLike): void;
221 link(existingPath: PathLike, newPath: PathLike, callback: TCallback<void>): void;
222 private unlinkBase;
223 unlinkSync(path: PathLike): void;
224 unlink(path: PathLike, callback: TCallback<void>): void;
225 private symlinkBase;
226 symlinkSync(target: PathLike, path: PathLike, type?: symlink.Type): void;
227 symlink(target: PathLike, path: PathLike, callback: TCallback<void>): any;
228 symlink(target: PathLike, path: PathLike, type: symlink.Type, callback: TCallback<void>): any;
229 private realpathBase;
230 realpathSync(path: PathLike, options?: IRealpathOptions | string): TDataOut;
231 realpath(path: PathLike, callback: TCallback<TDataOut>): any;
232 realpath(path: PathLike, options: IRealpathOptions | string, callback: TCallback<TDataOut>): any;
233 private lstatBase;
234 lstatSync(path: PathLike): Stats<number>;
235 lstatSync(path: PathLike, options: {
236 bigint: false;
237 }): Stats<number>;
238 lstatSync(path: PathLike, options: {
239 bigint: true;
240 }): Stats<bigint>;
241 lstat(path: PathLike, callback: TCallback<Stats>): any;
242 lstat(path: PathLike, options: IStatOptions, callback: TCallback<Stats>): any;
243 private statBase;
244 statSync(path: PathLike): Stats<number>;
245 statSync(path: PathLike, options: {
246 bigint: false;
247 }): Stats<number>;
248 statSync(path: PathLike, options: {
249 bigint: true;
250 }): Stats<bigint>;
251 stat(path: PathLike, callback: TCallback<Stats>): any;
252 stat(path: PathLike, options: IStatOptions, callback: TCallback<Stats>): any;
253 private fstatBase;
254 fstatSync(fd: number): Stats<number>;
255 fstatSync(fd: number, options: {
256 bigint: false;
257 }): Stats<number>;
258 fstatSync(fd: number, options: {
259 bigint: true;
260 }): Stats<bigint>;
261 fstat(fd: number, callback: TCallback<Stats>): any;
262 fstat(fd: number, options: IStatOptions, callback: TCallback<Stats>): any;
263 private renameBase;
264 renameSync(oldPath: PathLike, newPath: PathLike): void;
265 rename(oldPath: PathLike, newPath: PathLike, callback: TCallback<void>): void;
266 private existsBase;
267 existsSync(path: PathLike): boolean;
268 exists(path: PathLike, callback: (exists: boolean) => void): void;
269 private accessBase;
270 accessSync(path: PathLike, mode?: number): void;
271 access(path: PathLike, callback: TCallback<void>): any;
272 access(path: PathLike, mode: number, callback: TCallback<void>): any;
273 appendFileSync(id: TFileId, data: TData, options?: IAppendFileOptions | string): void;
274 appendFile(id: TFileId, data: TData, callback: TCallback<void>): any;
275 appendFile(id: TFileId, data: TData, options: IAppendFileOptions | string, callback: TCallback<void>): any;
276 private readdirBase;
277 readdirSync(path: PathLike, options?: IReaddirOptions | string): TDataOut[] | Dirent[];
278 readdir(path: PathLike, callback: TCallback<TDataOut[] | Dirent[]>): any;
279 readdir(path: PathLike, options: IReaddirOptions | string, callback: TCallback<TDataOut[] | Dirent[]>): any;
280 private readlinkBase;
281 readlinkSync(path: PathLike, options?: IOptions): TDataOut;
282 readlink(path: PathLike, callback: TCallback<TDataOut>): any;
283 readlink(path: PathLike, options: IOptions, callback: TCallback<TDataOut>): any;
284 private fsyncBase;
285 fsyncSync(fd: number): void;
286 fsync(fd: number, callback: TCallback<void>): void;
287 private fdatasyncBase;
288 fdatasyncSync(fd: number): void;
289 fdatasync(fd: number, callback: TCallback<void>): void;
290 private ftruncateBase;
291 ftruncateSync(fd: number, len?: number): void;
292 ftruncate(fd: number, callback: TCallback<void>): any;
293 ftruncate(fd: number, len: number, callback: TCallback<void>): any;
294 private truncateBase;
295 truncateSync(id: TFileId, len?: number): void;
296 truncate(id: TFileId, callback: TCallback<void>): any;
297 truncate(id: TFileId, len: number, callback: TCallback<void>): any;
298 private futimesBase;
299 futimesSync(fd: number, atime: TTime, mtime: TTime): void;
300 futimes(fd: number, atime: TTime, mtime: TTime, callback: TCallback<void>): void;
301 private utimesBase;
302 utimesSync(path: PathLike, atime: TTime, mtime: TTime): void;
303 utimes(path: PathLike, atime: TTime, mtime: TTime, callback: TCallback<void>): void;
304 private mkdirBase;
305 /**
306 * Creates directory tree recursively.
307 * @param filename
308 * @param modeNum
309 */
310 private mkdirpBase;
311 mkdirSync(path: PathLike, options?: TMode | IMkdirOptions): void;
312 mkdir(path: PathLike, callback: TCallback<void>): any;
313 mkdir(path: PathLike, mode: TMode | IMkdirOptions, callback: TCallback<void>): any;
314 mkdirpSync(path: PathLike, mode?: TMode): void;
315 mkdirp(path: PathLike, callback: TCallback<void>): any;
316 mkdirp(path: PathLike, mode: TMode, callback: TCallback<void>): any;
317 private mkdtempBase;
318 mkdtempSync(prefix: string, options?: IOptions): TDataOut;
319 mkdtemp(prefix: string, callback: TCallback<void>): any;
320 mkdtemp(prefix: string, options: IOptions, callback: TCallback<void>): any;
321 private rmdirBase;
322 rmdirSync(path: PathLike, options?: IRmdirOptions): void;
323 rmdir(path: PathLike, callback: TCallback<void>): any;
324 rmdir(path: PathLike, options: IRmdirOptions, callback: TCallback<void>): any;
325 private rmBase;
326 rmSync(path: PathLike, options?: IRmOptions): void;
327 rm(path: PathLike, callback: TCallback<void>): void;
328 rm(path: PathLike, options: IRmOptions, callback: TCallback<void>): void;
329 private fchmodBase;
330 fchmodSync(fd: number, mode: TMode): void;
331 fchmod(fd: number, mode: TMode, callback: TCallback<void>): void;
332 private chmodBase;
333 chmodSync(path: PathLike, mode: TMode): void;
334 chmod(path: PathLike, mode: TMode, callback: TCallback<void>): void;
335 private lchmodBase;
336 lchmodSync(path: PathLike, mode: TMode): void;
337 lchmod(path: PathLike, mode: TMode, callback: TCallback<void>): void;
338 private fchownBase;
339 fchownSync(fd: number, uid: number, gid: number): void;
340 fchown(fd: number, uid: number, gid: number, callback: TCallback<void>): void;
341 private chownBase;
342 chownSync(path: PathLike, uid: number, gid: number): void;
343 chown(path: PathLike, uid: number, gid: number, callback: TCallback<void>): void;
344 private lchownBase;
345 lchownSync(path: PathLike, uid: number, gid: number): void;
346 lchown(path: PathLike, uid: number, gid: number, callback: TCallback<void>): void;
347 private statWatchers;
348 watchFile(path: PathLike, listener: (curr: Stats, prev: Stats) => void): StatWatcher;
349 watchFile(path: PathLike, options: IWatchFileOptions, listener: (curr: Stats, prev: Stats) => void): StatWatcher;
350 unwatchFile(path: PathLike, listener?: (curr: Stats, prev: Stats) => void): void;
351 createReadStream(path: PathLike, options?: IReadStreamOptions | string): IReadStream;
352 createWriteStream(path: PathLike, options?: IWriteStreamOptions | string): IWriteStream;
353 watch(path: PathLike, options?: IWatchOptions | string, listener?: (eventType: string, filename: string) => void): FSWatcher;
354}
355export declare class StatWatcher extends EventEmitter {
356 vol: Volume;
357 filename: string;
358 interval: number;
359 timeoutRef?: any;
360 setTimeout: TSetTimeout;
361 prev: Stats;
362 constructor(vol: Volume);
363 private loop;
364 private hasChanged;
365 private onInterval;
366 start(path: string, persistent?: boolean, interval?: number): void;
367 stop(): void;
368}
369export interface IReadStream extends Readable {
370 new (path: PathLike, options: IReadStreamOptions): any;
371 open(): any;
372 close(callback: TCallback<void>): any;
373 bytesRead: number;
374 path: string;
375}
376export interface IWriteStream extends Writable {
377 bytesWritten: number;
378 path: string;
379 new (path: PathLike, options: IWriteStreamOptions): any;
380 open(): any;
381 close(): any;
382}
383export declare class FSWatcher extends EventEmitter {
384 _vol: Volume;
385 _filename: string;
386 _steps: string[];
387 _filenameEncoded: TDataOut;
388 _recursive: boolean;
389 _encoding: BufferEncoding;
390 _link: Link;
391 _timer: any;
392 constructor(vol: Volume);
393 private _getName;
394 private _onNodeChange;
395 private _onParentChild;
396 private _emit;
397 private _persist;
398 start(path: PathLike, persistent?: boolean, recursive?: boolean, encoding?: BufferEncoding): void;
399 close(): void;
400}
401export {};
Note: See TracBrowser for help on using the repository browser.