@openclaw/fs-safe 0.2.2 → 0.2.3

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.
Files changed (58) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/dist/permissions.d.ts.map +1 -1
  3. package/dist/permissions.js +2 -8
  4. package/dist/private-file-store.d.ts +5 -7
  5. package/dist/private-file-store.d.ts.map +1 -1
  6. package/dist/private-file-store.js +21 -34
  7. package/package.json +2 -2
  8. package/dist/archive-utils.d.ts +0 -3
  9. package/dist/archive-utils.d.ts.map +0 -1
  10. package/dist/archive-utils.js +0 -26
  11. package/dist/boundary-file-read.d.ts +0 -44
  12. package/dist/boundary-file-read.d.ts.map +0 -1
  13. package/dist/boundary-file-read.js +0 -129
  14. package/dist/boundary-path.d.ts +0 -39
  15. package/dist/boundary-path.d.ts.map +0 -1
  16. package/dist/boundary-path.js +0 -598
  17. package/dist/fs-pinned-path-helper.d.ts +0 -7
  18. package/dist/fs-pinned-path-helper.d.ts.map +0 -1
  19. package/dist/fs-pinned-path-helper.js +0 -182
  20. package/dist/fs-pinned-write-helper.d.ts +0 -21
  21. package/dist/fs-pinned-write-helper.d.ts.map +0 -1
  22. package/dist/fs-pinned-write-helper.js +0 -263
  23. package/dist/hardlink-guards.d.ts +0 -7
  24. package/dist/hardlink-guards.d.ts.map +0 -1
  25. package/dist/hardlink-guards.js +0 -30
  26. package/dist/install-safe-path.d.ts +0 -20
  27. package/dist/install-safe-path.d.ts.map +0 -1
  28. package/dist/install-safe-path.js +0 -94
  29. package/dist/json-file.d.ts +0 -3
  30. package/dist/json-file.d.ts.map +0 -1
  31. package/dist/json-file.js +0 -123
  32. package/dist/json-files.d.ts +0 -20
  33. package/dist/json-files.d.ts.map +0 -1
  34. package/dist/json-files.js +0 -153
  35. package/dist/path-alias-guards.d.ts +0 -19
  36. package/dist/path-alias-guards.d.ts.map +0 -1
  37. package/dist/path-alias-guards.js +0 -21
  38. package/dist/path-guards.d.ts +0 -7
  39. package/dist/path-guards.d.ts.map +0 -1
  40. package/dist/path-guards.js +0 -49
  41. package/dist/path-safety.d.ts +0 -12
  42. package/dist/path-safety.d.ts.map +0 -1
  43. package/dist/path-safety.js +0 -50
  44. package/dist/safe-open-sync.d.ts +0 -24
  45. package/dist/safe-open-sync.d.ts.map +0 -1
  46. package/dist/safe-open-sync.js +0 -71
  47. package/dist/safe-root.d.ts +0 -123
  48. package/dist/safe-root.d.ts.map +0 -1
  49. package/dist/safe-root.js +0 -1060
  50. package/dist/secure-temp-workspace.d.ts +0 -25
  51. package/dist/secure-temp-workspace.d.ts.map +0 -1
  52. package/dist/secure-temp-workspace.js +0 -136
  53. package/dist/sibling-temp-file.d.ts +0 -16
  54. package/dist/sibling-temp-file.d.ts.map +0 -1
  55. package/dist/sibling-temp-file.js +0 -73
  56. package/dist/sibling-temp-write.d.ts +0 -8
  57. package/dist/sibling-temp-write.d.ts.map +0 -1
  58. package/dist/sibling-temp-write.js +0 -40
package/CHANGELOG.md CHANGED
@@ -2,6 +2,12 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ ## 0.2.3 - 2026-05-14
6
+
7
+ ### Fixes
8
+
9
+ - Classify broad Windows ACL identities such as Anonymous Logon, Guests, Interactive, Local, and Network as world-equivalent so writable paths are not downgraded to group-writable findings.
10
+
5
11
  ## 0.2.2 - 2026-05-11
6
12
 
7
13
  ### Fixes
@@ -1 +1 @@
1
- {"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"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"}
@@ -6,13 +6,7 @@ import { promisify } from "node:util";
6
6
  import { normalizeLowercaseStringOrEmpty } from "./string-coerce.js";
7
7
  const execFileAsync = promisify(execFile);
8
8
  const INHERIT_FLAGS = new Set(["I", "OI", "CI", "IO", "NP"]);
9
- const WORLD_PRINCIPALS = new Set([
10
- "everyone",
11
- "users",
12
- "builtin\\users",
13
- "authenticated users",
14
- "nt authority\\authenticated users",
15
- ]);
9
+ const WORLD_PRINCIPALS = new Set(["everyone", "users", "builtin\\users", "authenticated users", "nt authority\\authenticated users", "anonymous logon", "nt authority\\anonymous logon", "guests", "builtin\\guests", "interactive", "nt authority\\interactive", "network", "nt authority\\network", "local"]);
16
10
  const TRUSTED_BASE = new Set([
17
11
  "nt authority\\system",
18
12
  "system",
@@ -31,7 +25,7 @@ const TRUSTED_SIDS = new Set([
31
25
  "s-1-5-32-544",
32
26
  "s-1-5-80-956008885-3418522649-1831038044-1853292631-2271478464",
33
27
  ]);
34
- const WORLD_SIDS = new Set(["s-1-1-0", "s-1-5-11", "s-1-5-32-545"]);
28
+ const WORLD_SIDS = new Set(["s-1-1-0", "s-1-5-11", "s-1-5-32-545", "s-1-5-7", "s-1-5-32-546", "s-1-5-4", "s-1-2-0", "s-1-5-2"]);
35
29
  const STATUS_PREFIXES = [
36
30
  "successfully processed",
37
31
  "processed",
@@ -1,18 +1,16 @@
1
- import { type FileStore } from "./file-store.js";
2
- export type PrivateStateStoreOptions = {
1
+ export type PrivateFileStore = {
3
2
  rootDir: string;
4
- };
5
- export type PrivateStateStore = Omit<FileStore, "readText" | "readJson" | "writeText" | "writeJson"> & {
3
+ path(relativePath: string): string;
6
4
  readText(relativePath: string, options?: {
7
5
  maxBytes?: number;
8
6
  }): Promise<string | null>;
9
7
  readJson<T = unknown>(relativePath: string, options?: {
10
8
  maxBytes?: number;
11
9
  }): Promise<T | null>;
12
- writeText(relativePath: string, content: string | Uint8Array): Promise<string>;
10
+ writeText(relativePath: string, content: string | Uint8Array): Promise<void>;
13
11
  writeJson(relativePath: string, value: unknown, options?: {
14
12
  trailingNewline?: boolean;
15
- }): Promise<string>;
13
+ }): Promise<void>;
16
14
  };
17
15
  export declare function writePrivateTextAtomic(params: {
18
16
  rootDir: string;
@@ -56,5 +54,5 @@ export declare function writePrivateJsonAtomicSync(params: {
56
54
  value: unknown;
57
55
  trailingNewline?: boolean;
58
56
  }): void;
59
- export declare function privateStateStore(options: PrivateStateStoreOptions): PrivateStateStore;
57
+ export declare function privateFileStore(rootDir: string): PrivateFileStore;
60
58
  //# sourceMappingURL=private-file-store.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"private-file-store.d.ts","sourceRoot":"","sources":["../src/private-file-store.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"private-file-store.d.ts","sourceRoot":"","sources":["../src/private-file-store.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxF,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzG,CAAC;AAgBF,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CAC9B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBzB;AAoBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,GAAG,IAAI,CAiBhB;AAED,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAGpB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,CAAC,GAAG,IAAI,CAGX;AAoCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CAC9B,GAAG,IAAI,CA4CP;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,IAAI,CAOP;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAiClE"}
@@ -2,11 +2,10 @@ import { randomUUID } from "node:crypto";
2
2
  import path from "node:path";
3
3
  import fs from "node:fs";
4
4
  import { FsSafeError } from "./errors.js";
5
- import { fileStore } from "./file-store.js";
6
5
  import { isPathInside } from "./path.js";
7
6
  import { readRegularFileSync } from "./regular-file.js";
8
7
  import { root } from "./root.js";
9
- import { writeSecretFileAtomic } from "./secret-file.js";
8
+ import { writePrivateSecretFileAtomic } from "./secret-file.js";
10
9
  function resolvePrivateStorePath(rootDir, relativePath) {
11
10
  const root = path.resolve(rootDir);
12
11
  const raw = relativePath.trim();
@@ -21,7 +20,7 @@ function resolvePrivateStorePath(rootDir, relativePath) {
21
20
  return resolved;
22
21
  }
23
22
  export async function writePrivateTextAtomic(params) {
24
- await writeSecretFileAtomic(params);
23
+ await writePrivateSecretFileAtomic(params);
25
24
  }
26
25
  export async function readPrivateText(params) {
27
26
  const rootDir = path.resolve(params.rootDir);
@@ -173,7 +172,7 @@ export function writePrivateTextAtomicSync(params) {
173
172
  }
174
173
  export async function writePrivateJsonAtomic(params) {
175
174
  const json = JSON.stringify(params.value, null, 2);
176
- await writeSecretFileAtomic({
175
+ await writePrivateSecretFileAtomic({
177
176
  rootDir: params.rootDir,
178
177
  filePath: params.filePath,
179
178
  content: params.trailingNewline && !json.endsWith("\n") ? `${json}\n` : json,
@@ -187,47 +186,35 @@ export function writePrivateJsonAtomicSync(params) {
187
186
  content: params.trailingNewline && !json.endsWith("\n") ? `${json}\n` : json,
188
187
  });
189
188
  }
190
- export function privateStateStore(options) {
191
- const rootDir = path.resolve(options.rootDir);
192
- const store = fileStore({ rootDir, private: true });
189
+ export function privateFileStore(rootDir) {
190
+ const root = path.resolve(rootDir);
193
191
  return {
194
- ...store,
195
- rootDir,
196
- path: (relativePath) => resolvePrivateStorePath(rootDir, relativePath),
197
- readText: async (relativePath, options) => {
198
- const safePath = resolvePrivateStorePath(rootDir, relativePath);
199
- return await readPrivateText({
200
- rootDir,
201
- filePath: safePath,
202
- maxBytes: options?.maxBytes,
203
- });
204
- },
205
- readJson: async (relativePath, options) => {
206
- const safePath = resolvePrivateStorePath(rootDir, relativePath);
207
- return await readPrivateJson({
208
- rootDir,
209
- filePath: safePath,
210
- maxBytes: options?.maxBytes,
211
- });
212
- },
192
+ rootDir: root,
193
+ path: (relativePath) => resolvePrivateStorePath(root, relativePath),
194
+ readText: async (relativePath, options) => await readPrivateText({
195
+ rootDir: root,
196
+ filePath: resolvePrivateStorePath(root, relativePath),
197
+ maxBytes: options?.maxBytes,
198
+ }),
199
+ readJson: async (relativePath, options) => await readPrivateJson({
200
+ rootDir: root,
201
+ filePath: resolvePrivateStorePath(root, relativePath),
202
+ maxBytes: options?.maxBytes,
203
+ }),
213
204
  writeText: async (relativePath, content) => {
214
- const safePath = resolvePrivateStorePath(rootDir, relativePath);
215
205
  await writePrivateTextAtomic({
216
- rootDir,
217
- filePath: safePath,
206
+ rootDir: root,
207
+ filePath: resolvePrivateStorePath(root, relativePath),
218
208
  content,
219
209
  });
220
- return safePath;
221
210
  },
222
211
  writeJson: async (relativePath, value, options) => {
223
- const safePath = resolvePrivateStorePath(rootDir, relativePath);
224
212
  await writePrivateJsonAtomic({
225
- rootDir,
226
- filePath: safePath,
213
+ rootDir: root,
214
+ filePath: resolvePrivateStorePath(root, relativePath),
227
215
  value,
228
216
  trailingNewline: options?.trailingNewline,
229
217
  });
230
- return safePath;
231
218
  },
232
219
  };
233
220
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openclaw/fs-safe",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
4
  "description": "Capability-style filesystem roots for Node.js apps that handle untrusted relative paths.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -105,7 +105,7 @@
105
105
  "prepack": "node scripts/prepack-build.mjs",
106
106
  "test": "vitest run",
107
107
  "test:coverage": "vitest run --coverage",
108
- "test:security": "vitest run test/fs-safe.test.ts test/openclaw-read-bypass-parity.test.ts test/openclaw-write-bypass-parity.test.ts test/additional-bypass-parity.test.ts test/adversarial-boundary-payloads.test.ts",
108
+ "test:security": "vitest run test/fs-safe.test.ts test/read-boundary-bypass.test.ts test/write-boundary-bypass.test.ts test/additional-boundary-bypass.test.ts test/adversarial-boundary-payloads.test.ts",
109
109
  "check": "pnpm lint:file-size && pnpm lint:fs-boundary && pnpm build && pnpm test",
110
110
  "docs:site": "node scripts/build-docs-site.mjs"
111
111
  },
@@ -1,3 +0,0 @@
1
- export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T>;
2
- export declare function fileExists(filePath: string): Promise<boolean>;
3
- //# sourceMappingURL=archive-utils.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../src/archive-utils.ts"],"names":[],"mappings":"AAEA,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE"}
@@ -1,26 +0,0 @@
1
- import fs from "node:fs/promises";
2
- export async function withTimeout(promise, timeoutMs, label) {
3
- let timeoutId;
4
- try {
5
- return await Promise.race([
6
- promise,
7
- new Promise((_, reject) => {
8
- timeoutId = setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs);
9
- }),
10
- ]);
11
- }
12
- finally {
13
- if (timeoutId) {
14
- clearTimeout(timeoutId);
15
- }
16
- }
17
- }
18
- export async function fileExists(filePath) {
19
- try {
20
- await fs.stat(filePath);
21
- return true;
22
- }
23
- catch {
24
- return false;
25
- }
26
- }
@@ -1,44 +0,0 @@
1
- import fs from "node:fs";
2
- import type { PathAliasPolicy } from "./path-alias-guards.js";
3
- import { type SafeOpenSyncAllowedType, type SafeOpenSyncFailureReason } from "./safe-open-sync.js";
4
- type BoundaryReadFs = Pick<typeof fs, "closeSync" | "constants" | "fstatSync" | "lstatSync" | "openSync" | "readFileSync" | "realpathSync">;
5
- export type BoundaryFileOpenFailureReason = SafeOpenSyncFailureReason | "validation";
6
- export type BoundaryFileOpenResult = {
7
- ok: true;
8
- path: string;
9
- fd: number;
10
- stat: fs.Stats;
11
- rootRealPath: string;
12
- } | {
13
- ok: false;
14
- reason: BoundaryFileOpenFailureReason;
15
- error?: unknown;
16
- };
17
- export type BoundaryFileOpenFailure = Extract<BoundaryFileOpenResult, {
18
- ok: false;
19
- }>;
20
- export type OpenBoundaryFileSyncParams = {
21
- absolutePath: string;
22
- rootPath: string;
23
- boundaryLabel: string;
24
- rootRealPath?: string;
25
- maxBytes?: number;
26
- rejectHardlinks?: boolean;
27
- allowedType?: SafeOpenSyncAllowedType;
28
- skipLexicalRootCheck?: boolean;
29
- ioFs?: BoundaryReadFs;
30
- };
31
- export type OpenBoundaryFileParams = OpenBoundaryFileSyncParams & {
32
- aliasPolicy?: PathAliasPolicy;
33
- };
34
- export declare function canUseBoundaryFileOpen(ioFs: typeof fs): boolean;
35
- export declare function openBoundaryFileSync(params: OpenBoundaryFileSyncParams): BoundaryFileOpenResult;
36
- export declare function matchBoundaryFileOpenFailure<T>(failure: BoundaryFileOpenFailure, handlers: {
37
- path?: (failure: BoundaryFileOpenFailure) => T;
38
- validation?: (failure: BoundaryFileOpenFailure) => T;
39
- io?: (failure: BoundaryFileOpenFailure) => T;
40
- fallback: (failure: BoundaryFileOpenFailure) => T;
41
- }): T;
42
- export declare function openBoundaryFile(params: OpenBoundaryFileParams): Promise<BoundaryFileOpenResult>;
43
- export {};
44
- //# sourceMappingURL=boundary-file-read.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"boundary-file-read.d.ts","sourceRoot":"","sources":["../src/boundary-file-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAOzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,KAAK,cAAc,GAAG,IAAI,CACxB,OAAO,EAAE,EACP,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,UAAU,GACV,cAAc,GACd,cAAc,CACjB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,GAAG,YAAY,CAAC;AAErF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,6BAA6B,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,EAAE;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErF,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,GAAG;IAChE,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,CAAC;AAQF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAW/D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,sBAAsB,CAuB/F;AAED,wBAAgB,4BAA4B,CAAC,CAAC,EAC5C,OAAO,EAAE,uBAAuB,EAChC,QAAQ,EAAE;IACR,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,CAAC,CAAC;IAC/C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,CAAC,CAAC;IACrD,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,CAAC,CAAC;IAC7C,QAAQ,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,CAAC,CAAC;CACnD,GACA,CAAC,CAUH;AAoDD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAsBjC"}
@@ -1,129 +0,0 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
- import { resolveBoundaryPath, resolveBoundaryPathSync, } from "./boundary-path.js";
4
- import { openVerifiedFileSync, } from "./safe-open-sync.js";
5
- export function canUseBoundaryFileOpen(ioFs) {
6
- return (typeof ioFs.openSync === "function" &&
7
- typeof ioFs.closeSync === "function" &&
8
- typeof ioFs.fstatSync === "function" &&
9
- typeof ioFs.lstatSync === "function" &&
10
- typeof ioFs.realpathSync === "function" &&
11
- typeof ioFs.readFileSync === "function" &&
12
- typeof ioFs.constants === "object" &&
13
- ioFs.constants !== null);
14
- }
15
- export function openBoundaryFileSync(params) {
16
- const ioFs = params.ioFs ?? fs;
17
- const resolved = resolveBoundaryFilePathGeneric({
18
- absolutePath: params.absolutePath,
19
- resolve: (absolutePath) => resolveBoundaryPathSync({
20
- absolutePath,
21
- rootPath: params.rootPath,
22
- rootCanonicalPath: params.rootRealPath,
23
- boundaryLabel: params.boundaryLabel,
24
- skipLexicalRootCheck: params.skipLexicalRootCheck,
25
- }),
26
- });
27
- if (resolved instanceof Promise) {
28
- return toBoundaryValidationError(new Error("Unexpected async boundary resolution"));
29
- }
30
- return finalizeBoundaryFileOpen({
31
- resolved,
32
- maxBytes: params.maxBytes,
33
- rejectHardlinks: params.rejectHardlinks,
34
- allowedType: params.allowedType,
35
- ioFs,
36
- });
37
- }
38
- export function matchBoundaryFileOpenFailure(failure, handlers) {
39
- switch (failure.reason) {
40
- case "path":
41
- return handlers.path ? handlers.path(failure) : handlers.fallback(failure);
42
- case "validation":
43
- return handlers.validation ? handlers.validation(failure) : handlers.fallback(failure);
44
- case "io":
45
- return handlers.io ? handlers.io(failure) : handlers.fallback(failure);
46
- }
47
- return handlers.fallback(failure);
48
- }
49
- function openBoundaryFileResolved(params) {
50
- const opened = openVerifiedFileSync({
51
- filePath: params.absolutePath,
52
- resolvedPath: params.resolvedPath,
53
- rejectHardlinks: params.rejectHardlinks ?? true,
54
- maxBytes: params.maxBytes,
55
- allowedType: params.allowedType,
56
- ioFs: params.ioFs,
57
- });
58
- if (!opened.ok) {
59
- return opened;
60
- }
61
- return {
62
- ok: true,
63
- path: opened.path,
64
- fd: opened.fd,
65
- stat: opened.stat,
66
- rootRealPath: params.rootRealPath,
67
- };
68
- }
69
- function finalizeBoundaryFileOpen(params) {
70
- if ("ok" in params.resolved) {
71
- return params.resolved;
72
- }
73
- return openBoundaryFileResolved({
74
- absolutePath: params.resolved.absolutePath,
75
- resolvedPath: params.resolved.resolvedPath,
76
- rootRealPath: params.resolved.rootRealPath,
77
- maxBytes: params.maxBytes,
78
- rejectHardlinks: params.rejectHardlinks,
79
- allowedType: params.allowedType,
80
- ioFs: params.ioFs,
81
- });
82
- }
83
- export async function openBoundaryFile(params) {
84
- const ioFs = params.ioFs ?? fs;
85
- const maybeResolved = resolveBoundaryFilePathGeneric({
86
- absolutePath: params.absolutePath,
87
- resolve: (absolutePath) => resolveBoundaryPath({
88
- absolutePath,
89
- rootPath: params.rootPath,
90
- rootCanonicalPath: params.rootRealPath,
91
- boundaryLabel: params.boundaryLabel,
92
- policy: params.aliasPolicy,
93
- skipLexicalRootCheck: params.skipLexicalRootCheck,
94
- }),
95
- });
96
- const resolved = maybeResolved instanceof Promise ? await maybeResolved : maybeResolved;
97
- return finalizeBoundaryFileOpen({
98
- resolved,
99
- maxBytes: params.maxBytes,
100
- rejectHardlinks: params.rejectHardlinks,
101
- allowedType: params.allowedType,
102
- ioFs,
103
- });
104
- }
105
- function toBoundaryValidationError(error) {
106
- return { ok: false, reason: "validation", error };
107
- }
108
- function mapResolvedBoundaryPath(absolutePath, resolved) {
109
- return {
110
- absolutePath,
111
- resolvedPath: resolved.canonicalPath,
112
- rootRealPath: resolved.rootCanonicalPath,
113
- };
114
- }
115
- function resolveBoundaryFilePathGeneric(params) {
116
- const absolutePath = path.resolve(params.absolutePath);
117
- try {
118
- const resolved = params.resolve(absolutePath);
119
- if (resolved instanceof Promise) {
120
- return resolved
121
- .then((value) => mapResolvedBoundaryPath(absolutePath, value))
122
- .catch((error) => toBoundaryValidationError(error));
123
- }
124
- return mapResolvedBoundaryPath(absolutePath, resolved);
125
- }
126
- catch (error) {
127
- return toBoundaryValidationError(error);
128
- }
129
- }
@@ -1,39 +0,0 @@
1
- type BoundaryPathIntent = "read" | "write" | "create" | "delete" | "stat";
2
- export type BoundaryPathAliasPolicy = {
3
- allowFinalSymlinkForUnlink?: boolean;
4
- allowFinalHardlinkForUnlink?: boolean;
5
- };
6
- export declare const BOUNDARY_PATH_ALIAS_POLICIES: {
7
- readonly strict: Readonly<{
8
- allowFinalSymlinkForUnlink: false;
9
- allowFinalHardlinkForUnlink: false;
10
- }>;
11
- readonly unlinkTarget: Readonly<{
12
- allowFinalSymlinkForUnlink: true;
13
- allowFinalHardlinkForUnlink: true;
14
- }>;
15
- };
16
- type ResolveBoundaryPathParams = {
17
- absolutePath: string;
18
- rootPath: string;
19
- boundaryLabel: string;
20
- intent?: BoundaryPathIntent;
21
- policy?: BoundaryPathAliasPolicy;
22
- skipLexicalRootCheck?: boolean;
23
- rootCanonicalPath?: string;
24
- };
25
- type ResolvedBoundaryPathKind = "missing" | "file" | "directory" | "symlink" | "other";
26
- export type ResolvedBoundaryPath = {
27
- absolutePath: string;
28
- canonicalPath: string;
29
- rootPath: string;
30
- rootCanonicalPath: string;
31
- relativePath: string;
32
- exists: boolean;
33
- kind: ResolvedBoundaryPathKind;
34
- };
35
- export declare function resolveBoundaryPath(params: ResolveBoundaryPathParams): Promise<ResolvedBoundaryPath>;
36
- export declare function resolveBoundaryPathSync(params: ResolveBoundaryPathParams): ResolvedBoundaryPath;
37
- export declare function resolvePathViaExistingAncestorSync(targetPath: string): string;
38
- export {};
39
- //# sourceMappingURL=boundary-path.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"boundary-path.d.ts","sourceRoot":"","sources":["../src/boundary-path.ts"],"names":[],"mappings":"AAMA,KAAK,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1E,MAAM,MAAM,uBAAuB,GAAG;IACpC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;CAS/B,CAAC;AAEX,KAAK,yBAAyB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,wBAAwB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,wBAAwB,CAAC;CAChC,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CA+B/B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,oBAAoB,CA+B/F;AAmkBD,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA6B7E"}