@fgv/ts-utils 5.0.0-8 → 5.0.1-0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.json +10 -7
- package/dist/ts-utils.d.ts +3042 -3133
- package/dist/tsdoc-metadata.json +1 -1
- package/eslint.config.js +37 -0
- package/lib/index.d.ts +2 -2
- package/lib/index.js +3 -3
- package/lib/packlets/base/index.d.ts +0 -2
- package/lib/packlets/base/index.js +1 -25
- package/lib/packlets/base/mapResults.d.ts +8 -1
- package/lib/packlets/base/mapResults.js +19 -0
- package/lib/packlets/base/result.d.ts +81 -3
- package/lib/packlets/base/result.js +71 -3
- package/lib/packlets/collections/collector.d.ts +9 -0
- package/lib/packlets/collections/collector.js +16 -1
- package/lib/packlets/collections/validatingCollector.d.ts +5 -1
- package/lib/packlets/conversion/baseConverter.js +0 -1
- package/lib/packlets/conversion/converters.js +0 -2
- package/lib/packlets/conversion/objectConverter.js +1 -2
- package/lib/packlets/hash/hashingNormalizer.js +4 -3
- package/lib/packlets/logging/index.d.ts +3 -0
- package/lib/packlets/{file-tree/in-memory → logging}/index.js +3 -2
- package/lib/packlets/logging/logReporter.d.ts +88 -0
- package/lib/packlets/logging/logReporter.js +105 -0
- package/lib/packlets/logging/logger.d.ts +205 -0
- package/lib/packlets/logging/logger.js +267 -0
- package/lib/packlets/validation/array.d.ts +2 -1
- package/lib/packlets/validation/array.js +2 -1
- package/lib/packlets/validation/common.d.ts +0 -8
- package/lib/packlets/validation/field.d.ts +1 -1
- package/lib/packlets/validation/field.js +1 -1
- package/lib/packlets/validation/genericValidator.d.ts +1 -6
- package/lib/packlets/validation/genericValidator.js +11 -11
- package/lib/packlets/validation/object.d.ts +1 -1
- package/lib/packlets/validation/object.js +1 -2
- package/lib/packlets/validation/oneOf.d.ts +2 -1
- package/lib/packlets/validation/oneOf.js +2 -1
- package/lib/packlets/validation/typeGuard.d.ts +3 -2
- package/lib/packlets/validation/typeGuard.js +2 -1
- package/lib/packlets/validation/validator.d.ts +7 -0
- package/lib/packlets/validation/validatorBase.d.ts +2 -1
- package/lib/packlets/validation/validatorBase.js +1 -1
- package/lib/packlets/validation/validators.d.ts +2 -2
- package/lib/packlets/validation/validators.js +3 -3
- package/package.json +16 -16
- package/CHANGELOG.md +0 -135
- package/lib/index.d.ts.map +0 -1
- package/lib/index.js.map +0 -1
- package/lib/packlets/base/brand.d.ts.map +0 -1
- package/lib/packlets/base/brand.js.map +0 -1
- package/lib/packlets/base/index.d.ts.map +0 -1
- package/lib/packlets/base/index.js.map +0 -1
- package/lib/packlets/base/logger.d.ts +0 -52
- package/lib/packlets/base/logger.d.ts.map +0 -1
- package/lib/packlets/base/logger.js +0 -128
- package/lib/packlets/base/logger.js.map +0 -1
- package/lib/packlets/base/mapResults.d.ts.map +0 -1
- package/lib/packlets/base/mapResults.js.map +0 -1
- package/lib/packlets/base/messageAggregator.d.ts.map +0 -1
- package/lib/packlets/base/messageAggregator.js.map +0 -1
- package/lib/packlets/base/normalize.d.ts.map +0 -1
- package/lib/packlets/base/normalize.js.map +0 -1
- package/lib/packlets/base/result.d.ts.map +0 -1
- package/lib/packlets/base/result.js.map +0 -1
- package/lib/packlets/base/utils.d.ts.map +0 -1
- package/lib/packlets/base/utils.js.map +0 -1
- package/lib/packlets/collections/collectible.d.ts.map +0 -1
- package/lib/packlets/collections/collectible.js.map +0 -1
- package/lib/packlets/collections/collector.d.ts.map +0 -1
- package/lib/packlets/collections/collector.js.map +0 -1
- package/lib/packlets/collections/collectorValidator.d.ts.map +0 -1
- package/lib/packlets/collections/collectorValidator.js.map +0 -1
- package/lib/packlets/collections/common.d.ts.map +0 -1
- package/lib/packlets/collections/common.js.map +0 -1
- package/lib/packlets/collections/convertingCollector.d.ts.map +0 -1
- package/lib/packlets/collections/convertingCollector.js.map +0 -1
- package/lib/packlets/collections/convertingCollectorValidator.d.ts.map +0 -1
- package/lib/packlets/collections/convertingCollectorValidator.js.map +0 -1
- package/lib/packlets/collections/index.d.ts.map +0 -1
- package/lib/packlets/collections/index.js.map +0 -1
- package/lib/packlets/collections/keyValueConverters.d.ts.map +0 -1
- package/lib/packlets/collections/keyValueConverters.js.map +0 -1
- package/lib/packlets/collections/readonlyResultMap.d.ts.map +0 -1
- package/lib/packlets/collections/readonlyResultMap.js.map +0 -1
- package/lib/packlets/collections/resultMap.d.ts.map +0 -1
- package/lib/packlets/collections/resultMap.js.map +0 -1
- package/lib/packlets/collections/resultMapValidator.d.ts.map +0 -1
- package/lib/packlets/collections/resultMapValidator.js.map +0 -1
- package/lib/packlets/collections/utils.d.ts.map +0 -1
- package/lib/packlets/collections/utils.js.map +0 -1
- package/lib/packlets/collections/validatingCollector.d.ts.map +0 -1
- package/lib/packlets/collections/validatingCollector.js.map +0 -1
- package/lib/packlets/collections/validatingConvertingCollector.d.ts.map +0 -1
- package/lib/packlets/collections/validatingConvertingCollector.js.map +0 -1
- package/lib/packlets/collections/validatingResultMap.d.ts.map +0 -1
- package/lib/packlets/collections/validatingResultMap.js.map +0 -1
- package/lib/packlets/conversion/baseConverter.d.ts.map +0 -1
- package/lib/packlets/conversion/baseConverter.js.map +0 -1
- package/lib/packlets/conversion/converter.d.ts.map +0 -1
- package/lib/packlets/conversion/converter.js.map +0 -1
- package/lib/packlets/conversion/converters.d.ts.map +0 -1
- package/lib/packlets/conversion/converters.js.map +0 -1
- package/lib/packlets/conversion/defaultingConverter.d.ts.map +0 -1
- package/lib/packlets/conversion/defaultingConverter.js.map +0 -1
- package/lib/packlets/conversion/index.d.ts.map +0 -1
- package/lib/packlets/conversion/index.js.map +0 -1
- package/lib/packlets/conversion/objectConverter.d.ts.map +0 -1
- package/lib/packlets/conversion/objectConverter.js.map +0 -1
- package/lib/packlets/conversion/stringConverter.d.ts.map +0 -1
- package/lib/packlets/conversion/stringConverter.js.map +0 -1
- package/lib/packlets/file-tree/directoryItem.d.ts +0 -47
- package/lib/packlets/file-tree/directoryItem.d.ts.map +0 -1
- package/lib/packlets/file-tree/directoryItem.js +0 -71
- package/lib/packlets/file-tree/directoryItem.js.map +0 -1
- package/lib/packlets/file-tree/fileItem.d.ts +0 -64
- package/lib/packlets/file-tree/fileItem.d.ts.map +0 -1
- package/lib/packlets/file-tree/fileItem.js +0 -93
- package/lib/packlets/file-tree/fileItem.js.map +0 -1
- package/lib/packlets/file-tree/fileTree.d.ts +0 -84
- package/lib/packlets/file-tree/fileTree.d.ts.map +0 -1
- package/lib/packlets/file-tree/fileTree.js +0 -135
- package/lib/packlets/file-tree/fileTree.js.map +0 -1
- package/lib/packlets/file-tree/fileTreeAccessors.d.ts +0 -134
- package/lib/packlets/file-tree/fileTreeAccessors.d.ts.map +0 -1
- package/lib/packlets/file-tree/fileTreeAccessors.js +0 -24
- package/lib/packlets/file-tree/fileTreeAccessors.js.map +0 -1
- package/lib/packlets/file-tree/fsTree.d.ts +0 -45
- package/lib/packlets/file-tree/fsTree.d.ts.map +0 -1
- package/lib/packlets/file-tree/fsTree.js +0 -116
- package/lib/packlets/file-tree/fsTree.js.map +0 -1
- package/lib/packlets/file-tree/in-memory/inMemoryTree.d.ts +0 -67
- package/lib/packlets/file-tree/in-memory/inMemoryTree.d.ts.map +0 -1
- package/lib/packlets/file-tree/in-memory/inMemoryTree.js +0 -150
- package/lib/packlets/file-tree/in-memory/inMemoryTree.js.map +0 -1
- package/lib/packlets/file-tree/in-memory/index.d.ts +0 -2
- package/lib/packlets/file-tree/in-memory/index.d.ts.map +0 -1
- package/lib/packlets/file-tree/in-memory/index.js.map +0 -1
- package/lib/packlets/file-tree/in-memory/treeBuilder.d.ts +0 -106
- package/lib/packlets/file-tree/in-memory/treeBuilder.d.ts.map +0 -1
- package/lib/packlets/file-tree/in-memory/treeBuilder.js +0 -170
- package/lib/packlets/file-tree/in-memory/treeBuilder.js.map +0 -1
- package/lib/packlets/file-tree/index.d.ts +0 -8
- package/lib/packlets/file-tree/index.d.ts.map +0 -1
- package/lib/packlets/file-tree/index.js +0 -46
- package/lib/packlets/file-tree/index.js.map +0 -1
- package/lib/packlets/hash/crcNormalizer.d.ts.map +0 -1
- package/lib/packlets/hash/crcNormalizer.js.map +0 -1
- package/lib/packlets/hash/hashingNormalizer.d.ts.map +0 -1
- package/lib/packlets/hash/hashingNormalizer.js.map +0 -1
- package/lib/packlets/hash/index.d.ts.map +0 -1
- package/lib/packlets/hash/index.js.map +0 -1
- package/lib/packlets/validation/array.d.ts.map +0 -1
- package/lib/packlets/validation/array.js.map +0 -1
- package/lib/packlets/validation/boolean.d.ts.map +0 -1
- package/lib/packlets/validation/boolean.js.map +0 -1
- package/lib/packlets/validation/classes.d.ts.map +0 -1
- package/lib/packlets/validation/classes.js.map +0 -1
- package/lib/packlets/validation/common.d.ts.map +0 -1
- package/lib/packlets/validation/common.js.map +0 -1
- package/lib/packlets/validation/field.d.ts.map +0 -1
- package/lib/packlets/validation/field.js.map +0 -1
- package/lib/packlets/validation/genericValidator.d.ts.map +0 -1
- package/lib/packlets/validation/genericValidator.js.map +0 -1
- package/lib/packlets/validation/index.d.ts.map +0 -1
- package/lib/packlets/validation/index.js.map +0 -1
- package/lib/packlets/validation/number.d.ts.map +0 -1
- package/lib/packlets/validation/number.js.map +0 -1
- package/lib/packlets/validation/object.d.ts.map +0 -1
- package/lib/packlets/validation/object.js.map +0 -1
- package/lib/packlets/validation/oneOf.d.ts.map +0 -1
- package/lib/packlets/validation/oneOf.js.map +0 -1
- package/lib/packlets/validation/string.d.ts.map +0 -1
- package/lib/packlets/validation/string.js.map +0 -1
- package/lib/packlets/validation/traits.d.ts.map +0 -1
- package/lib/packlets/validation/traits.js.map +0 -1
- package/lib/packlets/validation/typeGuard.d.ts.map +0 -1
- package/lib/packlets/validation/typeGuard.js.map +0 -1
- package/lib/packlets/validation/validator.d.ts.map +0 -1
- package/lib/packlets/validation/validator.js.map +0 -1
- package/lib/packlets/validation/validatorBase.d.ts.map +0 -1
- package/lib/packlets/validation/validatorBase.js.map +0 -1
- package/lib/packlets/validation/validators.d.ts.map +0 -1
- package/lib/packlets/validation/validators.js.map +0 -1
|
@@ -1,134 +0,0 @@
|
|
|
1
|
-
import { Result } from '../base';
|
|
2
|
-
import { Converter } from '../conversion';
|
|
3
|
-
import { Validator } from '../validation';
|
|
4
|
-
/**
|
|
5
|
-
* Type of item in a file tree.
|
|
6
|
-
* @public
|
|
7
|
-
*/
|
|
8
|
-
export type FileTreeItemType = 'directory' | 'file';
|
|
9
|
-
/**
|
|
10
|
-
* Interface for a file in a file tree.
|
|
11
|
-
* @public
|
|
12
|
-
*/
|
|
13
|
-
export interface IFileTreeFileItem {
|
|
14
|
-
/**
|
|
15
|
-
* Indicates that this {@link FileTree.FileTreeItem | file tree item} is a file.
|
|
16
|
-
*/
|
|
17
|
-
readonly type: 'file';
|
|
18
|
-
/**
|
|
19
|
-
* The absolute path of the file.
|
|
20
|
-
*/
|
|
21
|
-
readonly absolutePath: string;
|
|
22
|
-
/**
|
|
23
|
-
* The name of the file
|
|
24
|
-
*/
|
|
25
|
-
readonly name: string;
|
|
26
|
-
/**
|
|
27
|
-
* The base name of the file (without extension)
|
|
28
|
-
*/
|
|
29
|
-
readonly baseName: string;
|
|
30
|
-
/**
|
|
31
|
-
* The extension of the file
|
|
32
|
-
*/
|
|
33
|
-
readonly extension: string;
|
|
34
|
-
/**
|
|
35
|
-
* Gets the contents of the file as parsed JSON.
|
|
36
|
-
* @returns {@link Success | Success} with the parsed contents if successful, or
|
|
37
|
-
* {@link Failure | Failure}with an error message otherwise.
|
|
38
|
-
*/
|
|
39
|
-
getContents(): Result<unknown>;
|
|
40
|
-
/**
|
|
41
|
-
* Gets the contents of the file as parsed JSON, converted to a specific type.
|
|
42
|
-
* @param converter - A {@link Validation.Validator | Validator} or {@link Conversion.Converter | Converter}
|
|
43
|
-
* to convert the parsed JSON contents to the desired type.
|
|
44
|
-
* @returns {@link Success | Success} with the converted contents if successful, or
|
|
45
|
-
* {@link Failure | Failure} with an error message otherwise.
|
|
46
|
-
*/
|
|
47
|
-
getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;
|
|
48
|
-
/**
|
|
49
|
-
* Gets the raw contents of the file as a string.
|
|
50
|
-
* @returns {@link Success | Success} with the raw contents if successful, or
|
|
51
|
-
* {@link Failure | Failure} with an error message otherwise.
|
|
52
|
-
*/
|
|
53
|
-
getRawContents(): Result<string>;
|
|
54
|
-
}
|
|
55
|
-
/**
|
|
56
|
-
* Interface for a directory in a file tree.
|
|
57
|
-
* @public
|
|
58
|
-
*/
|
|
59
|
-
export interface IFileTreeDirectoryItem {
|
|
60
|
-
/**
|
|
61
|
-
* Indicates that this {@link FileTree.FileTreeItem | file tree item} is a directory
|
|
62
|
-
*/
|
|
63
|
-
readonly type: 'directory';
|
|
64
|
-
/**
|
|
65
|
-
* The absolute path of the directory.
|
|
66
|
-
*/
|
|
67
|
-
readonly absolutePath: string;
|
|
68
|
-
/**
|
|
69
|
-
* The name of the directory
|
|
70
|
-
*/
|
|
71
|
-
readonly name: string;
|
|
72
|
-
/**
|
|
73
|
-
* Gets the children of the directory.
|
|
74
|
-
* @returns {@link Success | Success} with the children of the directory if successful,
|
|
75
|
-
* or {@link Failure | Failure} with an error message otherwise.
|
|
76
|
-
*/
|
|
77
|
-
getChildren(): Result<ReadonlyArray<FileTreeItem>>;
|
|
78
|
-
}
|
|
79
|
-
/**
|
|
80
|
-
* Type for an item in a file tree.
|
|
81
|
-
* @public
|
|
82
|
-
*/
|
|
83
|
-
export type FileTreeItem = IFileTreeFileItem | IFileTreeDirectoryItem;
|
|
84
|
-
/**
|
|
85
|
-
* Common abstraction layer interface for a tree of files
|
|
86
|
-
* (e.g. a file system or a zip file).
|
|
87
|
-
* @public
|
|
88
|
-
*/
|
|
89
|
-
export interface IFileTreeAccessors {
|
|
90
|
-
/**
|
|
91
|
-
* Resolves paths to an absolute path.
|
|
92
|
-
* @param paths - Paths to resolve.
|
|
93
|
-
* @returns The resolved absolute path.
|
|
94
|
-
*/
|
|
95
|
-
resolveAbsolutePath(...paths: string[]): string;
|
|
96
|
-
/**
|
|
97
|
-
* Gets the extension of a path.
|
|
98
|
-
* @param path - Path to get the extension of.
|
|
99
|
-
* @returns The extension of the path.
|
|
100
|
-
*/
|
|
101
|
-
getExtension(path: string): string;
|
|
102
|
-
/**
|
|
103
|
-
* Gets the base name of a path.
|
|
104
|
-
* @param path - Path to get the base name of.
|
|
105
|
-
* @param suffix - Optional suffix to remove from the base name.
|
|
106
|
-
* @returns The base name of the path.
|
|
107
|
-
*/
|
|
108
|
-
getBaseName(path: string, suffix?: string): string;
|
|
109
|
-
/**
|
|
110
|
-
* Joins paths together.
|
|
111
|
-
* @param paths - Paths to join.
|
|
112
|
-
* @returns The joined paths.
|
|
113
|
-
*/
|
|
114
|
-
joinPaths(...paths: string[]): string;
|
|
115
|
-
/**
|
|
116
|
-
* Gets an item from the file tree.
|
|
117
|
-
* @param path - Path of the item to get.
|
|
118
|
-
* @returns The item if it exists.
|
|
119
|
-
*/
|
|
120
|
-
getItem(path: string): Result<FileTreeItem>;
|
|
121
|
-
/**
|
|
122
|
-
* Gets the contents of a file in the file tree.
|
|
123
|
-
* @param path - Absolute path of the file.
|
|
124
|
-
* @returns The contents of the file.
|
|
125
|
-
*/
|
|
126
|
-
getFileContents(path: string): Result<string>;
|
|
127
|
-
/**
|
|
128
|
-
* Gets the children of a directory in the file tree.
|
|
129
|
-
* @param path - Path of the directory.
|
|
130
|
-
* @returns The children of the directory.
|
|
131
|
-
*/
|
|
132
|
-
getChildren(path: string): Result<ReadonlyArray<FileTreeItem>>;
|
|
133
|
-
}
|
|
134
|
-
//# sourceMappingURL=fileTreeAccessors.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"fileTreeAccessors.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileTreeAccessors.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,WAAW,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/B;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAElE;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,WAAW,IAAI,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEhD;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnD;;;;OAIG;IACH,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEtC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAE5C;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9C;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;CAChE"}
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
/*
|
|
3
|
-
* Copyright (c) 2025 Erik Fortune
|
|
4
|
-
*
|
|
5
|
-
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
* of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
* in the Software without restriction, including without limitation the rights
|
|
8
|
-
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
* copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
* furnished to do so, subject to the following conditions:
|
|
11
|
-
*
|
|
12
|
-
* The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
* copies or substantial portions of the Software.
|
|
14
|
-
*
|
|
15
|
-
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
* SOFTWARE.
|
|
22
|
-
*/
|
|
23
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
24
|
-
//# sourceMappingURL=fileTreeAccessors.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"fileTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileTreeAccessors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result } from '../base';\nimport { Converter } from '../conversion';\nimport { Validator } from '../validation';\n\n/**\n * Type of item in a file tree.\n * @public\n */\nexport type FileTreeItemType = 'directory' | 'file';\n\n/**\n * Interface for a file in a file tree.\n * @public\n */\nexport interface IFileTreeFileItem {\n /**\n * Indicates that this {@link FileTree.FileTreeItem | file tree item} is a file.\n */\n readonly type: 'file';\n\n /**\n * The absolute path of the file.\n */\n readonly absolutePath: string;\n\n /**\n * The name of the file\n */\n readonly name: string;\n\n /**\n * The base name of the file (without extension)\n */\n readonly baseName: string;\n\n /**\n * The extension of the file\n */\n readonly extension: string;\n\n /**\n * Gets the contents of the file as parsed JSON.\n * @returns {@link Success | Success} with the parsed contents if successful, or\n * {@link Failure | Failure}with an error message otherwise.\n */\n getContents(): Result<unknown>;\n\n /**\n * Gets the contents of the file as parsed JSON, converted to a specific type.\n * @param converter - A {@link Validation.Validator | Validator} or {@link Conversion.Converter | Converter}\n * to convert the parsed JSON contents to the desired type.\n * @returns {@link Success | Success} with the converted contents if successful, or\n * {@link Failure | Failure} with an error message otherwise.\n */\n getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;\n\n /**\n * Gets the raw contents of the file as a string.\n * @returns {@link Success | Success} with the raw contents if successful, or\n * {@link Failure | Failure} with an error message otherwise.\n */\n getRawContents(): Result<string>;\n}\n\n/**\n * Interface for a directory in a file tree.\n * @public\n */\nexport interface IFileTreeDirectoryItem {\n /**\n * Indicates that this {@link FileTree.FileTreeItem | file tree item} is a directory\n */\n readonly type: 'directory';\n\n /**\n * The absolute path of the directory.\n */\n readonly absolutePath: string;\n\n /**\n * The name of the directory\n */\n readonly name: string;\n\n /**\n * Gets the children of the directory.\n * @returns {@link Success | Success} with the children of the directory if successful,\n * or {@link Failure | Failure} with an error message otherwise.\n */\n getChildren(): Result<ReadonlyArray<FileTreeItem>>;\n}\n\n/**\n * Type for an item in a file tree.\n * @public\n */\nexport type FileTreeItem = IFileTreeFileItem | IFileTreeDirectoryItem;\n\n/**\n * Common abstraction layer interface for a tree of files\n * (e.g. a file system or a zip file).\n * @public\n */\nexport interface IFileTreeAccessors {\n /**\n * Resolves paths to an absolute path.\n * @param paths - Paths to resolve.\n * @returns The resolved absolute path.\n */\n resolveAbsolutePath(...paths: string[]): string;\n\n /**\n * Gets the extension of a path.\n * @param path - Path to get the extension of.\n * @returns The extension of the path.\n */\n getExtension(path: string): string;\n\n /**\n * Gets the base name of a path.\n * @param path - Path to get the base name of.\n * @param suffix - Optional suffix to remove from the base name.\n * @returns The base name of the path.\n */\n getBaseName(path: string, suffix?: string): string;\n\n /**\n * Joins paths together.\n * @param paths - Paths to join.\n * @returns The joined paths.\n */\n joinPaths(...paths: string[]): string;\n\n /**\n * Gets an item from the file tree.\n * @param path - Path of the item to get.\n * @returns The item if it exists.\n */\n getItem(path: string): Result<FileTreeItem>;\n\n /**\n * Gets the contents of a file in the file tree.\n * @param path - Absolute path of the file.\n * @returns The contents of the file.\n */\n getFileContents(path: string): Result<string>;\n\n /**\n * Gets the children of a directory in the file tree.\n * @param path - Path of the directory.\n * @returns The children of the directory.\n */\n getChildren(path: string): Result<ReadonlyArray<FileTreeItem>>;\n}\n"]}
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
import { FileTreeItem, IFileTreeAccessors } from './fileTreeAccessors';
|
|
2
|
-
import { Result } from '../base';
|
|
3
|
-
/**
|
|
4
|
-
* Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses the
|
|
5
|
-
* file system to access files and directories.
|
|
6
|
-
* @public
|
|
7
|
-
*/
|
|
8
|
-
export declare class FsFileTreeAccessors implements IFileTreeAccessors {
|
|
9
|
-
readonly prefix: string | undefined;
|
|
10
|
-
/**
|
|
11
|
-
* Protected constructor for derived classes.
|
|
12
|
-
* @param prefix - Optional prefix for the tree.
|
|
13
|
-
* @public
|
|
14
|
-
*/
|
|
15
|
-
constructor(prefix?: string);
|
|
16
|
-
/**
|
|
17
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
|
|
18
|
-
*/
|
|
19
|
-
resolveAbsolutePath(...paths: string[]): string;
|
|
20
|
-
/**
|
|
21
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
|
|
22
|
-
*/
|
|
23
|
-
getExtension(itemPath: string): string;
|
|
24
|
-
/**
|
|
25
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
|
|
26
|
-
*/
|
|
27
|
-
getBaseName(itemPath: string, suffix?: string): string;
|
|
28
|
-
/**
|
|
29
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
|
|
30
|
-
*/
|
|
31
|
-
joinPaths(...paths: string[]): string;
|
|
32
|
-
/**
|
|
33
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getItem}
|
|
34
|
-
*/
|
|
35
|
-
getItem(itemPath: string): Result<FileTreeItem>;
|
|
36
|
-
/**
|
|
37
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
|
|
38
|
-
*/
|
|
39
|
-
getFileContents(filePath: string): Result<string>;
|
|
40
|
-
/**
|
|
41
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
|
|
42
|
-
*/
|
|
43
|
-
getChildren(dirPath: string): Result<ReadonlyArray<FileTreeItem>>;
|
|
44
|
-
}
|
|
45
|
-
//# sourceMappingURL=fsTree.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"fsTree.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fsTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAiB,MAAM,EAAE,MAAM,SAAS,CAAC;AAIhD;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,kBAAkB;IAC5D,SAAgB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3C;;;;OAIG;gBACgB,MAAM,CAAC,EAAE,MAAM;IAIlC;;OAEG;IACI,mBAAmB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAOtD;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAI7D;;OAEG;IACI,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAI5C;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;IAYtD;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAIxD;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;CAezE"}
|
|
@@ -1,116 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
/*
|
|
3
|
-
* Copyright (c) 2025 Erik Fortune
|
|
4
|
-
*
|
|
5
|
-
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
* of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
* in the Software without restriction, including without limitation the rights
|
|
8
|
-
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
* copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
* furnished to do so, subject to the following conditions:
|
|
11
|
-
*
|
|
12
|
-
* The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
* copies or substantial portions of the Software.
|
|
14
|
-
*
|
|
15
|
-
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
* SOFTWARE.
|
|
22
|
-
*/
|
|
23
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
24
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
25
|
-
};
|
|
26
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
27
|
-
exports.FsFileTreeAccessors = void 0;
|
|
28
|
-
const path_1 = __importDefault(require("path"));
|
|
29
|
-
const fs_1 = __importDefault(require("fs"));
|
|
30
|
-
const base_1 = require("../base");
|
|
31
|
-
const directoryItem_1 = require("./directoryItem");
|
|
32
|
-
const fileItem_1 = require("./fileItem");
|
|
33
|
-
/**
|
|
34
|
-
* Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses the
|
|
35
|
-
* file system to access files and directories.
|
|
36
|
-
* @public
|
|
37
|
-
*/
|
|
38
|
-
class FsFileTreeAccessors {
|
|
39
|
-
/**
|
|
40
|
-
* Protected constructor for derived classes.
|
|
41
|
-
* @param prefix - Optional prefix for the tree.
|
|
42
|
-
* @public
|
|
43
|
-
*/
|
|
44
|
-
constructor(prefix) {
|
|
45
|
-
this.prefix = prefix;
|
|
46
|
-
}
|
|
47
|
-
/**
|
|
48
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
|
|
49
|
-
*/
|
|
50
|
-
resolveAbsolutePath(...paths) {
|
|
51
|
-
if (this.prefix && !path_1.default.isAbsolute(paths[0])) {
|
|
52
|
-
return path_1.default.resolve(this.prefix, ...paths);
|
|
53
|
-
}
|
|
54
|
-
return path_1.default.resolve(...paths);
|
|
55
|
-
}
|
|
56
|
-
/**
|
|
57
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getExtension}
|
|
58
|
-
*/
|
|
59
|
-
getExtension(itemPath) {
|
|
60
|
-
return path_1.default.extname(itemPath);
|
|
61
|
-
}
|
|
62
|
-
/**
|
|
63
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}
|
|
64
|
-
*/
|
|
65
|
-
getBaseName(itemPath, suffix) {
|
|
66
|
-
return path_1.default.basename(itemPath, suffix);
|
|
67
|
-
}
|
|
68
|
-
/**
|
|
69
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}
|
|
70
|
-
*/
|
|
71
|
-
joinPaths(...paths) {
|
|
72
|
-
return path_1.default.join(...paths);
|
|
73
|
-
}
|
|
74
|
-
/**
|
|
75
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getItem}
|
|
76
|
-
*/
|
|
77
|
-
getItem(itemPath) {
|
|
78
|
-
return (0, base_1.captureResult)(() => {
|
|
79
|
-
const stat = fs_1.default.statSync(this.resolveAbsolutePath(itemPath));
|
|
80
|
-
if (stat.isDirectory()) {
|
|
81
|
-
return directoryItem_1.DirectoryItem.create(itemPath, this).orThrow();
|
|
82
|
-
}
|
|
83
|
-
else if (stat.isFile()) {
|
|
84
|
-
return fileItem_1.FileItem.create(itemPath, this).orThrow();
|
|
85
|
-
}
|
|
86
|
-
throw new Error(`${itemPath}: not a file or directory`);
|
|
87
|
-
});
|
|
88
|
-
}
|
|
89
|
-
/**
|
|
90
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
|
|
91
|
-
*/
|
|
92
|
-
getFileContents(filePath) {
|
|
93
|
-
return (0, base_1.captureResult)(() => fs_1.default.readFileSync(this.resolveAbsolutePath(filePath), 'utf8'));
|
|
94
|
-
}
|
|
95
|
-
/**
|
|
96
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
|
|
97
|
-
*/
|
|
98
|
-
getChildren(dirPath) {
|
|
99
|
-
return (0, base_1.captureResult)(() => {
|
|
100
|
-
const children = [];
|
|
101
|
-
const files = fs_1.default.readdirSync(this.resolveAbsolutePath(dirPath), { withFileTypes: true });
|
|
102
|
-
files.forEach((file) => {
|
|
103
|
-
const fullPath = this.resolveAbsolutePath(dirPath, file.name);
|
|
104
|
-
if (file.isDirectory()) {
|
|
105
|
-
children.push(directoryItem_1.DirectoryItem.create(fullPath, this).orThrow());
|
|
106
|
-
}
|
|
107
|
-
else if (file.isFile()) {
|
|
108
|
-
children.push(fileItem_1.FileItem.create(fullPath, this).orThrow());
|
|
109
|
-
}
|
|
110
|
-
});
|
|
111
|
-
return children;
|
|
112
|
-
});
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
exports.FsFileTreeAccessors = FsFileTreeAccessors;
|
|
116
|
-
//# sourceMappingURL=fsTree.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"fsTree.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fsTree.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { FileTreeItem, IFileTreeAccessors } from './fileTreeAccessors';\nimport path from 'path';\nimport fs from 'fs';\nimport { captureResult, Result } from '../base';\nimport { DirectoryItem } from './directoryItem';\nimport { FileItem } from './fileItem';\n\n/**\n * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses the\n * file system to access files and directories.\n * @public\n */\nexport class FsFileTreeAccessors implements IFileTreeAccessors {\n public readonly prefix: string | undefined;\n\n /**\n * Protected constructor for derived classes.\n * @param prefix - Optional prefix for the tree.\n * @public\n */\n public constructor(prefix?: string) {\n this.prefix = prefix;\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}\n */\n public resolveAbsolutePath(...paths: string[]): string {\n if (this.prefix && !path.isAbsolute(paths[0])) {\n return path.resolve(this.prefix, ...paths);\n }\n return path.resolve(...paths);\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getExtension}\n */\n public getExtension(itemPath: string): string {\n return path.extname(itemPath);\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getBaseName}\n */\n public getBaseName(itemPath: string, suffix?: string): string {\n return path.basename(itemPath, suffix);\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.joinPaths}\n */\n public joinPaths(...paths: string[]): string {\n return path.join(...paths);\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getItem}\n */\n public getItem(itemPath: string): Result<FileTreeItem> {\n return captureResult(() => {\n const stat = fs.statSync(this.resolveAbsolutePath(itemPath));\n if (stat.isDirectory()) {\n return DirectoryItem.create(itemPath, this).orThrow();\n } else if (stat.isFile()) {\n return FileItem.create(itemPath, this).orThrow();\n }\n throw new Error(`${itemPath}: not a file or directory`);\n });\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}\n */\n public getFileContents(filePath: string): Result<string> {\n return captureResult(() => fs.readFileSync(this.resolveAbsolutePath(filePath), 'utf8'));\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}\n */\n public getChildren(dirPath: string): Result<ReadonlyArray<FileTreeItem>> {\n return captureResult(() => {\n const children: FileTreeItem[] = [];\n const files = fs.readdirSync(this.resolveAbsolutePath(dirPath), { withFileTypes: true });\n files.forEach((file) => {\n const fullPath = this.resolveAbsolutePath(dirPath, file.name);\n if (file.isDirectory()) {\n children.push(DirectoryItem.create(fullPath, this).orThrow());\n } else if (file.isFile()) {\n children.push(FileItem.create(fullPath, this).orThrow());\n }\n });\n return children;\n });\n }\n}\n"]}
|
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
import { Result } from '../../base';
|
|
2
|
-
import { FileTreeItem, IFileTreeAccessors } from '../fileTreeAccessors';
|
|
3
|
-
/**
|
|
4
|
-
* Represents a single file in an in-memory {@link FileTree.FileTree | file tree}.
|
|
5
|
-
* @public
|
|
6
|
-
*/
|
|
7
|
-
export interface IInMemoryFile {
|
|
8
|
-
/**
|
|
9
|
-
* The absolute path of the file in the tree.
|
|
10
|
-
*/
|
|
11
|
-
readonly path: string;
|
|
12
|
-
/**
|
|
13
|
-
* The contents of the file
|
|
14
|
-
*/
|
|
15
|
-
readonly contents: unknown;
|
|
16
|
-
}
|
|
17
|
-
/**
|
|
18
|
-
* Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses an in-memory
|
|
19
|
-
* tree to access files and directories.
|
|
20
|
-
* @public
|
|
21
|
-
*/
|
|
22
|
-
export declare class InMemoryTreeAccessors implements IFileTreeAccessors {
|
|
23
|
-
private readonly _tree;
|
|
24
|
-
/**
|
|
25
|
-
* Protected constructor for derived classes.
|
|
26
|
-
* @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
|
|
27
|
-
* @param prefix - Optional prefix for the tree.
|
|
28
|
-
* @public
|
|
29
|
-
*/
|
|
30
|
-
protected constructor(files: IInMemoryFile[], prefix?: string);
|
|
31
|
-
/**
|
|
32
|
-
* Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied
|
|
33
|
-
* in-memory files.
|
|
34
|
-
* @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
|
|
35
|
-
* @param prefix - Optional prefix for the tree.
|
|
36
|
-
*/
|
|
37
|
-
static create(files: IInMemoryFile[], prefix?: string): Result<InMemoryTreeAccessors>;
|
|
38
|
-
/**
|
|
39
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
|
|
40
|
-
*/
|
|
41
|
-
resolveAbsolutePath(...paths: string[]): string;
|
|
42
|
-
/**
|
|
43
|
-
* {@inheritdoc FileTree.IFileTreeAccessors.getExtension}
|
|
44
|
-
*/
|
|
45
|
-
getExtension(path: string): string;
|
|
46
|
-
/**
|
|
47
|
-
* {@inheritdoc FileTree.IFileTreeAccessors.getBaseName}
|
|
48
|
-
*/
|
|
49
|
-
getBaseName(path: string, suffix?: string): string;
|
|
50
|
-
/**
|
|
51
|
-
* {@inheritdoc FileTree.IFileTreeAccessors.joinPaths}
|
|
52
|
-
*/
|
|
53
|
-
joinPaths(...paths: string[]): string;
|
|
54
|
-
/**
|
|
55
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getItem}
|
|
56
|
-
*/
|
|
57
|
-
getItem(itemPath: string): Result<FileTreeItem>;
|
|
58
|
-
/**
|
|
59
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
|
|
60
|
-
*/
|
|
61
|
-
getFileContents(path: string): Result<string>;
|
|
62
|
-
/**
|
|
63
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
|
|
64
|
-
*/
|
|
65
|
-
getChildren(path: string): Result<ReadonlyArray<FileTreeItem>>;
|
|
66
|
-
}
|
|
67
|
-
//# sourceMappingURL=inMemoryTree.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"inMemoryTree.d.ts","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/inMemoryTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAuB,MAAM,EAAW,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC;;;;;OAKG;IACH,SAAS,aAAa,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM;IAO7D;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAI5F;;OAEG;IACI,mBAAmB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAMtD;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQzC;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IASzD;;OAEG;IACI,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAI5C;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;IAYtD;;OAEG;IACI,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAepD;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;CAoBtE"}
|
|
@@ -1,150 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
/*
|
|
3
|
-
* Copyright (c) 2025 Erik Fortune
|
|
4
|
-
*
|
|
5
|
-
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
* of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
* in the Software without restriction, including without limitation the rights
|
|
8
|
-
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
* copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
* furnished to do so, subject to the following conditions:
|
|
11
|
-
*
|
|
12
|
-
* The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
* copies or substantial portions of the Software.
|
|
14
|
-
*
|
|
15
|
-
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
* SOFTWARE.
|
|
22
|
-
*/
|
|
23
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
24
|
-
exports.InMemoryTreeAccessors = void 0;
|
|
25
|
-
const base_1 = require("../../base");
|
|
26
|
-
const directoryItem_1 = require("../directoryItem");
|
|
27
|
-
const fileItem_1 = require("../fileItem");
|
|
28
|
-
const treeBuilder_1 = require("./treeBuilder");
|
|
29
|
-
/**
|
|
30
|
-
* Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses an in-memory
|
|
31
|
-
* tree to access files and directories.
|
|
32
|
-
* @public
|
|
33
|
-
*/
|
|
34
|
-
class InMemoryTreeAccessors {
|
|
35
|
-
/**
|
|
36
|
-
* Protected constructor for derived classes.
|
|
37
|
-
* @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
|
|
38
|
-
* @param prefix - Optional prefix for the tree.
|
|
39
|
-
* @public
|
|
40
|
-
*/
|
|
41
|
-
constructor(files, prefix) {
|
|
42
|
-
this._tree = treeBuilder_1.TreeBuilder.create(prefix).orThrow();
|
|
43
|
-
for (const file of files) {
|
|
44
|
-
this._tree.addFile(file.path, file.contents).orThrow();
|
|
45
|
-
}
|
|
46
|
-
}
|
|
47
|
-
/**
|
|
48
|
-
* Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied
|
|
49
|
-
* in-memory files.
|
|
50
|
-
* @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.
|
|
51
|
-
* @param prefix - Optional prefix for the tree.
|
|
52
|
-
*/
|
|
53
|
-
static create(files, prefix) {
|
|
54
|
-
return (0, base_1.captureResult)(() => new InMemoryTreeAccessors(files, prefix));
|
|
55
|
-
}
|
|
56
|
-
/**
|
|
57
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}
|
|
58
|
-
*/
|
|
59
|
-
resolveAbsolutePath(...paths) {
|
|
60
|
-
const parts = paths[0].startsWith('/') ? paths : [this._tree.prefix, ...paths];
|
|
61
|
-
const joined = parts.flatMap((p) => p.split('/').filter((s) => s.length > 0)).join('/');
|
|
62
|
-
return `/${joined}`;
|
|
63
|
-
}
|
|
64
|
-
/**
|
|
65
|
-
* {@inheritdoc FileTree.IFileTreeAccessors.getExtension}
|
|
66
|
-
*/
|
|
67
|
-
getExtension(path) {
|
|
68
|
-
const parts = path.split('.');
|
|
69
|
-
if (parts.length === 1) {
|
|
70
|
-
return '';
|
|
71
|
-
}
|
|
72
|
-
return `.${parts.pop()}`;
|
|
73
|
-
}
|
|
74
|
-
/**
|
|
75
|
-
* {@inheritdoc FileTree.IFileTreeAccessors.getBaseName}
|
|
76
|
-
*/
|
|
77
|
-
getBaseName(path, suffix) {
|
|
78
|
-
var _a;
|
|
79
|
-
/* c8 ignore next 1 - ?? is defense in depth should never happen */
|
|
80
|
-
const base = (_a = path.split('/').pop()) !== null && _a !== void 0 ? _a : '';
|
|
81
|
-
if (suffix && base.endsWith(suffix)) {
|
|
82
|
-
return base.slice(0, base.length - suffix.length);
|
|
83
|
-
}
|
|
84
|
-
return base;
|
|
85
|
-
}
|
|
86
|
-
/**
|
|
87
|
-
* {@inheritdoc FileTree.IFileTreeAccessors.joinPaths}
|
|
88
|
-
*/
|
|
89
|
-
joinPaths(...paths) {
|
|
90
|
-
return paths.join('/');
|
|
91
|
-
}
|
|
92
|
-
/**
|
|
93
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getItem}
|
|
94
|
-
*/
|
|
95
|
-
getItem(itemPath) {
|
|
96
|
-
const existing = this._tree.byAbsolutePath.get(itemPath);
|
|
97
|
-
if (existing) {
|
|
98
|
-
if (existing instanceof treeBuilder_1.InMemoryFile) {
|
|
99
|
-
return fileItem_1.FileItem.create(existing.absolutePath, this);
|
|
100
|
-
}
|
|
101
|
-
else if (existing instanceof treeBuilder_1.InMemoryDirectory) {
|
|
102
|
-
return directoryItem_1.DirectoryItem.create(existing.absolutePath, this);
|
|
103
|
-
}
|
|
104
|
-
}
|
|
105
|
-
return (0, base_1.fail)(`${itemPath}: not found`);
|
|
106
|
-
}
|
|
107
|
-
/**
|
|
108
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}
|
|
109
|
-
*/
|
|
110
|
-
getFileContents(path) {
|
|
111
|
-
const item = this._tree.byAbsolutePath.get(path);
|
|
112
|
-
if (item === undefined) {
|
|
113
|
-
return (0, base_1.fail)(`${path}: not found`);
|
|
114
|
-
}
|
|
115
|
-
if (!(item instanceof treeBuilder_1.InMemoryFile)) {
|
|
116
|
-
return (0, base_1.fail)(`${path}: not a file`);
|
|
117
|
-
}
|
|
118
|
-
// if the body is a string we don't want to add quotes
|
|
119
|
-
if (typeof item.contents === 'string') {
|
|
120
|
-
return (0, base_1.succeed)(item.contents);
|
|
121
|
-
}
|
|
122
|
-
return (0, base_1.captureResult)(() => JSON.stringify(item.contents));
|
|
123
|
-
}
|
|
124
|
-
/**
|
|
125
|
-
* {@inheritDoc FileTree.IFileTreeAccessors.getChildren}
|
|
126
|
-
*/
|
|
127
|
-
getChildren(path) {
|
|
128
|
-
const item = this._tree.byAbsolutePath.get(path);
|
|
129
|
-
if (item === undefined) {
|
|
130
|
-
return (0, base_1.fail)(`${path}: not found`);
|
|
131
|
-
}
|
|
132
|
-
if (!(item instanceof treeBuilder_1.InMemoryDirectory)) {
|
|
133
|
-
return (0, base_1.fail)(`${path}: not a directory`);
|
|
134
|
-
}
|
|
135
|
-
return (0, base_1.captureResult)(() => {
|
|
136
|
-
const children = [];
|
|
137
|
-
for (const child of item.children.values()) {
|
|
138
|
-
if (child instanceof treeBuilder_1.InMemoryFile) {
|
|
139
|
-
children.push(fileItem_1.FileItem.create(child.absolutePath, this).orThrow());
|
|
140
|
-
}
|
|
141
|
-
else if (child instanceof treeBuilder_1.InMemoryDirectory) {
|
|
142
|
-
children.push(directoryItem_1.DirectoryItem.create(child.absolutePath, this).orThrow());
|
|
143
|
-
}
|
|
144
|
-
}
|
|
145
|
-
return children;
|
|
146
|
-
});
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
exports.InMemoryTreeAccessors = InMemoryTreeAccessors;
|
|
150
|
-
//# sourceMappingURL=inMemoryTree.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"inMemoryTree.js","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/inMemoryTree.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, fail, Result, succeed } from '../../base';\nimport { DirectoryItem } from '../directoryItem';\nimport { FileItem } from '../fileItem';\nimport { FileTreeItem, IFileTreeAccessors } from '../fileTreeAccessors';\nimport { InMemoryDirectory, InMemoryFile, TreeBuilder } from './treeBuilder';\n\n/**\n * Represents a single file in an in-memory {@link FileTree.FileTree | file tree}.\n * @public\n */\nexport interface IInMemoryFile {\n /**\n * The absolute path of the file in the tree.\n */\n readonly path: string;\n\n /**\n * The contents of the file\n */\n readonly contents: unknown;\n}\n\n/**\n * Implementation of {@link FileTree.IFileTreeAccessors | IFileTreeAccessors} that uses an in-memory\n * tree to access files and directories.\n * @public\n */\nexport class InMemoryTreeAccessors implements IFileTreeAccessors {\n private readonly _tree: TreeBuilder;\n\n /**\n * Protected constructor for derived classes.\n * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n * @param prefix - Optional prefix for the tree.\n * @public\n */\n protected constructor(files: IInMemoryFile[], prefix?: string) {\n this._tree = TreeBuilder.create(prefix).orThrow();\n for (const file of files) {\n this._tree.addFile(file.path, file.contents).orThrow();\n }\n }\n\n /**\n * Creates a new {@link FileTree.InMemoryTreeAccessors | InMemoryTreeAccessors} instance with the supplied\n * in-memory files.\n * @param files - An array of {@link FileTree.IInMemoryFile | in-memory files} to include in the tree.\n * @param prefix - Optional prefix for the tree.\n */\n public static create(files: IInMemoryFile[], prefix?: string): Result<InMemoryTreeAccessors> {\n return captureResult(() => new InMemoryTreeAccessors(files, prefix));\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.resolveAbsolutePath}\n */\n public resolveAbsolutePath(...paths: string[]): string {\n const parts = paths[0].startsWith('/') ? paths : [this._tree.prefix, ...paths];\n const joined = parts.flatMap((p) => p.split('/').filter((s) => s.length > 0)).join('/');\n return `/${joined}`;\n }\n\n /**\n * {@inheritdoc FileTree.IFileTreeAccessors.getExtension}\n */\n public getExtension(path: string): string {\n const parts = path.split('.');\n if (parts.length === 1) {\n return '';\n }\n return `.${parts.pop()}`;\n }\n\n /**\n * {@inheritdoc FileTree.IFileTreeAccessors.getBaseName}\n */\n public getBaseName(path: string, suffix?: string): string {\n /* c8 ignore next 1 - ?? is defense in depth should never happen */\n const base = path.split('/').pop() ?? '';\n if (suffix && base.endsWith(suffix)) {\n return base.slice(0, base.length - suffix.length);\n }\n return base;\n }\n\n /**\n * {@inheritdoc FileTree.IFileTreeAccessors.joinPaths}\n */\n public joinPaths(...paths: string[]): string {\n return paths.join('/');\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getItem}\n */\n public getItem(itemPath: string): Result<FileTreeItem> {\n const existing = this._tree.byAbsolutePath.get(itemPath);\n if (existing) {\n if (existing instanceof InMemoryFile) {\n return FileItem.create(existing.absolutePath, this);\n } else if (existing instanceof InMemoryDirectory) {\n return DirectoryItem.create(existing.absolutePath, this);\n }\n }\n return fail(`${itemPath}: not found`);\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getFileContents}\n */\n public getFileContents(path: string): Result<string> {\n const item = this._tree.byAbsolutePath.get(path);\n if (item === undefined) {\n return fail(`${path}: not found`);\n }\n if (!(item instanceof InMemoryFile)) {\n return fail(`${path}: not a file`);\n }\n // if the body is a string we don't want to add quotes\n if (typeof item.contents === 'string') {\n return succeed(item.contents);\n }\n return captureResult(() => JSON.stringify(item.contents));\n }\n\n /**\n * {@inheritDoc FileTree.IFileTreeAccessors.getChildren}\n */\n public getChildren(path: string): Result<ReadonlyArray<FileTreeItem>> {\n const item = this._tree.byAbsolutePath.get(path);\n if (item === undefined) {\n return fail(`${path}: not found`);\n }\n if (!(item instanceof InMemoryDirectory)) {\n return fail(`${path}: not a directory`);\n }\n return captureResult(() => {\n const children: FileTreeItem[] = [];\n for (const child of item.children.values()) {\n if (child instanceof InMemoryFile) {\n children.push(FileItem.create(child.absolutePath, this).orThrow());\n } else if (child instanceof InMemoryDirectory) {\n children.push(DirectoryItem.create(child.absolutePath, this).orThrow());\n }\n }\n return children;\n });\n }\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/index.ts"],"names":[],"mappings":"AAsBA,cAAc,gBAAgB,CAAC"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/file-tree/in-memory/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,iDAA+B","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './inMemoryTree';\n"]}
|