@chriscdn/file-cache 0.0.14 → 2.0.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/lib/index.d.ts CHANGED
@@ -2,7 +2,7 @@ type DirectoryPath = string;
2
2
  type FileName = string;
3
3
  type FilePath = string;
4
4
  type Milliseconds = number;
5
- export type FileCacheOptions<T extends Record<string, any>> = {
5
+ type FileCacheOptions<T extends Record<string, any>> = {
6
6
  cachePath: DirectoryPath;
7
7
  autoCreateCachePath?: boolean;
8
8
  cb: (filePath: FilePath, args: T, cache: FileCache<T>) => Promise<void>;
@@ -58,4 +58,5 @@ declare class FileCache<T extends Record<string, any>> {
58
58
  */
59
59
  cleanup(): Promise<void>;
60
60
  }
61
- export { type DirectoryPath, FileCache, type FileName, type FilePath };
61
+
62
+ export { type DirectoryPath, FileCache, type FileCacheOptions, type FileName, type FilePath };
@@ -1,13 +1,22 @@
1
- import path from 'path';
2
- import fs from 'fs';
3
- import { pathExistsSync, pathExists } from 'path-exists';
4
- import sha1 from 'sha1';
5
- import { Semaphore, GroupSemaphore } from '@chriscdn/promise-semaphore';
6
- import touch from 'touch';
7
- import { findNuke } from '@chriscdn/find-nuke';
8
- import { Duration } from '@chriscdn/duration';
9
-
10
- class FileCache {
1
+ // src/index.ts
2
+ import path from "path";
3
+ import fs from "fs";
4
+ import { pathExists, pathExistsSync } from "path-exists";
5
+ import sha1 from "sha1";
6
+ import { GroupSemaphore, Semaphore } from "@chriscdn/promise-semaphore";
7
+ import touch from "touch";
8
+ import { findNuke } from "@chriscdn/find-nuke";
9
+ import { Duration } from "@chriscdn/duration";
10
+ var FileCache = class {
11
+ _cachePath;
12
+ _cb;
13
+ _ttl;
14
+ _cleanupInterval;
15
+ _resolveCacheKey;
16
+ _ext;
17
+ _intervalId = null;
18
+ _semaphore = new Semaphore();
19
+ _cleanupGroupSemaphore = new GroupSemaphore();
11
20
  constructor({
12
21
  cachePath,
13
22
  autoCreateCachePath,
@@ -17,34 +26,23 @@ class FileCache {
17
26
  cleanupInterval,
18
27
  resolveCacheKey
19
28
  }) {
20
- this._cachePath = void 0;
21
- this._cb = void 0;
22
- this._ttl = void 0;
23
- this._cleanupInterval = void 0;
24
- this._resolveCacheKey = void 0;
25
- this._ext = void 0;
26
- this._intervalId = null;
27
- this._semaphore = new Semaphore();
28
- this._cleanupGroupSemaphore = new GroupSemaphore();
29
29
  this._cachePath = cachePath;
30
30
  this._cb = cb;
31
31
  this._ext = ext;
32
32
  this._ttl = ttl;
33
- this._cleanupInterval = cleanupInterval != null ? cleanupInterval : Duration.toMilliseconds({
34
- days: 1
35
- });
36
- this._resolveCacheKey = resolveCacheKey != null ? resolveCacheKey : args => JSON.stringify(args);
37
- // Startup code
38
- if (pathExistsSync(cachePath)) ; else if (autoCreateCachePath) {
39
- fs.mkdirSync(cachePath, {
40
- recursive: true
41
- });
33
+ this._cleanupInterval = cleanupInterval ?? Duration.toMilliseconds({ days: 1 });
34
+ this._resolveCacheKey = resolveCacheKey ?? ((args) => JSON.stringify(args));
35
+ if (pathExistsSync(cachePath)) {
36
+ } else if (autoCreateCachePath) {
37
+ fs.mkdirSync(cachePath, { recursive: true });
42
38
  } else {
43
- throw new Error("💥 FileCache error: cachePath does not exist.");
39
+ throw new Error("\u{1F4A5} FileCache error: cachePath does not exist.");
44
40
  }
45
- // fire and forget
46
41
  this.cleanup();
47
- this._intervalId = setInterval(this.cleanup.bind(this), this._cleanupInterval);
42
+ this._intervalId = setInterval(
43
+ this.cleanup.bind(this),
44
+ this._cleanupInterval
45
+ );
48
46
  }
49
47
  /**
50
48
  * Resolves the filename for the cache based on the provided arguments.
@@ -53,7 +51,10 @@ class FileCache {
53
51
  * generating a hash from the arguments to create a unique file name.
54
52
  */
55
53
  async resolveFileName(args) {
56
- const [name, ext] = await Promise.all([this._resolveCacheKey(args), this._ext(args)]);
54
+ const [name, ext] = await Promise.all([
55
+ this._resolveCacheKey(args),
56
+ this._ext(args)
57
+ ]);
57
58
  const resolvedFileName = sha1(JSON.stringify([name, ext]));
58
59
  return path.format({
59
60
  name: resolvedFileName,
@@ -73,14 +74,14 @@ class FileCache {
73
74
  async getFile(args) {
74
75
  const filePath = await this.resolveFilePath(args);
75
76
  try {
76
- await Promise.all([this._cleanupGroupSemaphore.acquire("getFile"), this._semaphore.acquire(filePath)]);
77
+ await Promise.all([
78
+ this._cleanupGroupSemaphore.acquire("getFile"),
79
+ this._semaphore.acquire(filePath)
80
+ ]);
77
81
  if (await pathExists(filePath)) {
78
- // fire and forget
79
82
  touch(filePath);
80
83
  } else {
81
- await fs.promises.mkdir(path.dirname(filePath), {
82
- recursive: true
83
- });
84
+ await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
84
85
  await this._cb(filePath, args, this);
85
86
  }
86
87
  } finally {
@@ -97,7 +98,13 @@ class FileCache {
97
98
  */
98
99
  async resolveFilePath(args) {
99
100
  const fileName = await this.resolveFileName(args);
100
- const filePath = path.resolve(this._cachePath, fileName[0], fileName[1], fileName[2], fileName);
101
+ const filePath = path.resolve(
102
+ this._cachePath,
103
+ fileName[0],
104
+ fileName[1],
105
+ fileName[2],
106
+ fileName
107
+ );
101
108
  return filePath;
102
109
  }
103
110
  /**
@@ -129,7 +136,8 @@ class FileCache {
129
136
  this._cleanupGroupSemaphore.release("cleanup");
130
137
  }
131
138
  }
132
- }
133
-
134
- export { FileCache };
135
- //# sourceMappingURL=file-cache.module.js.map
139
+ };
140
+ export {
141
+ FileCache
142
+ };
143
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import path from \"path\";\nimport fs from \"fs\";\nimport { pathExists, pathExistsSync } from \"path-exists\";\nimport sha1 from \"sha1\";\nimport { GroupSemaphore, Semaphore } from \"@chriscdn/promise-semaphore\";\nimport touch from \"touch\";\nimport { findNuke } from \"@chriscdn/find-nuke\";\nimport { Duration } from \"@chriscdn/duration\";\n\ntype DirectoryPath = string;\ntype FileName = string;\ntype FilePath = string;\ntype Milliseconds = number;\n\nexport type FileCacheOptions<T extends Record<string, any>> = {\n cachePath: DirectoryPath;\n autoCreateCachePath?: boolean;\n cb: (filePath: FilePath, args: T, cache: FileCache<T>) => Promise<void>;\n ext: (args: T) => string | Promise<string>;\n resolveCacheKey?: (args: T) => string | Promise<string>;\n ttl: Milliseconds;\n cleanupInterval?: Milliseconds;\n};\n\nclass FileCache<T extends Record<string, any>> {\n private _cachePath: FileCacheOptions<T>[\"cachePath\"];\n private _cb: FileCacheOptions<T>[\"cb\"];\n private _ttl: FileCacheOptions<T>[\"ttl\"];\n private _cleanupInterval: FileCacheOptions<T>[\"cleanupInterval\"];\n private _resolveCacheKey: Required<\n FileCacheOptions<T>\n >[\"resolveCacheKey\"];\n private _ext: FileCacheOptions<T>[\"ext\"];\n private _intervalId: ReturnType<typeof setInterval> | null = null;\n private _semaphore: Semaphore = new Semaphore();\n private _cleanupGroupSemaphore: GroupSemaphore = new GroupSemaphore();\n\n constructor(\n {\n cachePath,\n autoCreateCachePath,\n cb,\n ext,\n ttl,\n cleanupInterval,\n resolveCacheKey,\n }: FileCacheOptions<T>,\n ) {\n this._cachePath = cachePath;\n this._cb = cb;\n this._ext = ext;\n this._ttl = ttl;\n this._cleanupInterval = cleanupInterval ??\n Duration.toMilliseconds({ days: 1 });\n\n this._resolveCacheKey = resolveCacheKey ??\n ((args: T) => (JSON.stringify(args)));\n\n // Startup code\n if ((pathExistsSync(cachePath))) {\n // we're good\n } else if (autoCreateCachePath) {\n fs.mkdirSync(cachePath, { recursive: true });\n } else {\n throw new Error(\"💥 FileCache error: cachePath does not exist.\");\n }\n\n // fire and forget\n this.cleanup();\n\n this._intervalId = setInterval(\n this.cleanup.bind(this),\n this._cleanupInterval,\n );\n }\n\n /**\n * Resolves the filename for the cache based on the provided arguments.\n *\n * Uses the provided `resolveFileName` function if available, or falls back to\n * generating a hash from the arguments to create a unique file name.\n */\n private async resolveFileName(args: T): Promise<FileName> {\n const [name, ext] = await Promise.all([\n this._resolveCacheKey(args),\n this._ext(args),\n ]);\n\n const resolvedFileName = sha1(JSON.stringify([name, ext]));\n\n return path.format({\n name: resolvedFileName,\n ext,\n }) as FileName;\n }\n\n /**\n * Retrieves a cached file for the given arguments.\n * If the file doesn't exist, it is generated by the callback and stored.\n *\n * Concurrency-safe, ensuring no conflicts when multiple requests are made\n * for the same file.\n *\n * @param args The arguments used to determine the file's identity and generation\n * @returns The path to the cached or newly created file\n */\n async getFile(args: T): Promise<FilePath> {\n const filePath = await this.resolveFilePath(args);\n\n try {\n await Promise.all([\n this._cleanupGroupSemaphore.acquire(\"getFile\"),\n this._semaphore.acquire(filePath),\n ]);\n\n if (await pathExists(filePath)) {\n // fire and forget\n touch(filePath);\n } else {\n await fs.promises.mkdir(path.dirname(filePath), { recursive: true });\n await this._cb(filePath, args, this);\n }\n } finally {\n this._semaphore.release(filePath);\n this._cleanupGroupSemaphore.release(\"getFile\");\n }\n\n return filePath;\n }\n\n /**\n * Resolves the full file path for the cached file based on the provided arguments.\n *\n * @param args The arguments used to resolve the file path\n * @returns The full path to the cached file\n */\n async resolveFilePath(args: T): Promise<FilePath> {\n const fileName = await this.resolveFileName(args);\n\n const filePath = path.resolve(\n this._cachePath,\n fileName[0]!,\n fileName[1]!,\n fileName[2]!,\n fileName,\n );\n\n return filePath;\n }\n\n /**\n * Stops the background cleanup process, but does not delete any cached files.\n */\n destroy() {\n if (this._intervalId) {\n clearInterval(this._intervalId);\n this._intervalId = null;\n }\n }\n\n async has(args: T): Promise<boolean> {\n const filePath = await this.resolveFilePath(args);\n return await pathExists(filePath);\n }\n\n /**\n * Runs a cleanup pass to remove files older than 1 day from the cache.\n * This is called periodically, but can be triggered manually.\n */\n async cleanup() {\n try {\n await this._cleanupGroupSemaphore.acquire(\"cleanup\");\n await findNuke(this._cachePath, {\n olderThan: this._ttl,\n verbose: true,\n deleteEmptyDirectories: true,\n });\n } finally {\n this._cleanupGroupSemaphore.release(\"cleanup\");\n }\n }\n}\n\nexport { type DirectoryPath, FileCache, type FileName, type FilePath };\n"],"mappings":";AAAA,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,SAAS,YAAY,sBAAsB;AAC3C,OAAO,UAAU;AACjB,SAAS,gBAAgB,iBAAiB;AAC1C,OAAO,WAAW;AAClB,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AAiBzB,IAAM,YAAN,MAA+C;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA,cAAqD;AAAA,EACrD,aAAwB,IAAI,UAAU;AAAA,EACtC,yBAAyC,IAAI,eAAe;AAAA,EAEpE,YACE;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GACA;AACA,SAAK,aAAa;AAClB,SAAK,MAAM;AACX,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,mBAAmB,mBACtB,SAAS,eAAe,EAAE,MAAM,EAAE,CAAC;AAErC,SAAK,mBAAmB,oBACrB,CAAC,SAAa,KAAK,UAAU,IAAI;AAGpC,QAAK,eAAe,SAAS,GAAI;AAAA,IAEjC,WAAW,qBAAqB;AAC9B,SAAG,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAAA,IAC7C,OAAO;AACL,YAAM,IAAI,MAAM,sDAA+C;AAAA,IACjE;AAGA,SAAK,QAAQ;AAEb,SAAK,cAAc;AAAA,MACjB,KAAK,QAAQ,KAAK,IAAI;AAAA,MACtB,KAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAc,gBAAgB,MAA4B;AACxD,UAAM,CAAC,MAAM,GAAG,IAAI,MAAM,QAAQ,IAAI;AAAA,MACpC,KAAK,iBAAiB,IAAI;AAAA,MAC1B,KAAK,KAAK,IAAI;AAAA,IAChB,CAAC;AAED,UAAM,mBAAmB,KAAK,KAAK,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;AAEzD,WAAO,KAAK,OAAO;AAAA,MACjB,MAAM;AAAA,MACN;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,QAAQ,MAA4B;AACxC,UAAM,WAAW,MAAM,KAAK,gBAAgB,IAAI;AAEhD,QAAI;AACF,YAAM,QAAQ,IAAI;AAAA,QAChB,KAAK,uBAAuB,QAAQ,SAAS;AAAA,QAC7C,KAAK,WAAW,QAAQ,QAAQ;AAAA,MAClC,CAAC;AAED,UAAI,MAAM,WAAW,QAAQ,GAAG;AAE9B,cAAM,QAAQ;AAAA,MAChB,OAAO;AACL,cAAM,GAAG,SAAS,MAAM,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AACnE,cAAM,KAAK,IAAI,UAAU,MAAM,IAAI;AAAA,MACrC;AAAA,IACF,UAAE;AACA,WAAK,WAAW,QAAQ,QAAQ;AAChC,WAAK,uBAAuB,QAAQ,SAAS;AAAA,IAC/C;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,gBAAgB,MAA4B;AAChD,UAAM,WAAW,MAAM,KAAK,gBAAgB,IAAI;AAEhD,UAAM,WAAW,KAAK;AAAA,MACpB,KAAK;AAAA,MACL,SAAS,CAAC;AAAA,MACV,SAAS,CAAC;AAAA,MACV,SAAS,CAAC;AAAA,MACV;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU;AACR,QAAI,KAAK,aAAa;AACpB,oBAAc,KAAK,WAAW;AAC9B,WAAK,cAAc;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,MAA2B;AACnC,UAAM,WAAW,MAAM,KAAK,gBAAgB,IAAI;AAChD,WAAO,MAAM,WAAW,QAAQ;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAAU;AACd,QAAI;AACF,YAAM,KAAK,uBAAuB,QAAQ,SAAS;AACnD,YAAM,SAAS,KAAK,YAAY;AAAA,QAC9B,WAAW,KAAK;AAAA,QAChB,SAAS;AAAA,QACT,wBAAwB;AAAA,MAC1B,CAAC;AAAA,IACH,UAAE;AACA,WAAK,uBAAuB,QAAQ,SAAS;AAAA,IAC/C;AAAA,EACF;AACF;","names":[]}
package/package.json CHANGED
@@ -1,39 +1,35 @@
1
1
  {
2
2
  "name": "@chriscdn/file-cache",
3
- "version": "0.0.14",
3
+ "version": "2.0.0",
4
4
  "description": "File cache",
5
5
  "repository": "https://github.com/chriscdn/file-cache",
6
6
  "author": "Christopher Meyer <chris@schwiiz.org>",
7
7
  "license": "MIT",
8
8
  "type": "module",
9
- "source": "./src/index.ts",
10
- "main": "./lib/file-cache.cjs",
11
- "module": "./lib/file-cache.module.js",
12
- "exports": {
13
- "types": "./lib/index.d.ts",
14
- "require": "./lib/file-cache.cjs",
15
- "default": "./lib/file-cache.modern.js"
16
- },
9
+ "main": "./lib/index.js",
17
10
  "types": "./lib/index.d.ts",
11
+ "exports": "./lib/index.js",
18
12
  "scripts": {
19
- "build": "rm -rf ./lib/ && microbundle --target node --format modern,esm,cjs",
13
+ "build": "tsup",
20
14
  "test": "vitest"
21
15
  },
22
16
  "dependencies": {
23
- "@chriscdn/duration": "^1.0.3",
24
- "@chriscdn/find-nuke": "^0.0.5",
25
- "@chriscdn/promise-semaphore": "^3.1.1",
17
+ "@chriscdn/duration": "^2.0.0",
18
+ "@chriscdn/find-nuke": "^2.0.0",
19
+ "@chriscdn/promise-semaphore": "^4.0.0",
26
20
  "path-exists": "^5.0.0",
27
21
  "sha1": "^1.1.1",
28
- "temp": "^0.9.4",
29
22
  "touch": "^3.1.1"
30
23
  },
31
24
  "devDependencies": {
25
+ "@tsconfig/strictest": "^2.0.7",
32
26
  "@types/sha1": "^1.1.5",
27
+ "@types/temp": "^0.9.4",
33
28
  "@types/touch": "^3.1.5",
34
- "microbundle": "^0.15.1",
29
+ "temp": "^0.9.4",
30
+ "tsup": "^8.5.1",
35
31
  "typescript": "^5.9.3",
36
- "vitest": "^4.0.5"
32
+ "vitest": "^4.0.6"
37
33
  },
38
34
  "files": [
39
35
  "lib"
@@ -1,142 +0,0 @@
1
- var path = require('path');
2
- var fs = require('fs');
3
- var pathExists = require('path-exists');
4
- var sha1 = require('sha1');
5
- var promiseSemaphore = require('@chriscdn/promise-semaphore');
6
- var touch = require('touch');
7
- var findNuke = require('@chriscdn/find-nuke');
8
- var duration = require('@chriscdn/duration');
9
-
10
- function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
11
-
12
- var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
13
- var fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
14
- var sha1__default = /*#__PURE__*/_interopDefaultLegacy(sha1);
15
- var touch__default = /*#__PURE__*/_interopDefaultLegacy(touch);
16
-
17
- class FileCache {
18
- constructor({
19
- cachePath,
20
- autoCreateCachePath,
21
- cb,
22
- ext,
23
- ttl,
24
- cleanupInterval,
25
- resolveCacheKey
26
- }) {
27
- this._cachePath = void 0;
28
- this._cb = void 0;
29
- this._ttl = void 0;
30
- this._cleanupInterval = void 0;
31
- this._resolveCacheKey = void 0;
32
- this._ext = void 0;
33
- this._intervalId = null;
34
- this._semaphore = new promiseSemaphore.Semaphore();
35
- this._cleanupGroupSemaphore = new promiseSemaphore.GroupSemaphore();
36
- this._cachePath = cachePath;
37
- this._cb = cb;
38
- this._ext = ext;
39
- this._ttl = ttl;
40
- this._cleanupInterval = cleanupInterval != null ? cleanupInterval : duration.Duration.toMilliseconds({
41
- days: 1
42
- });
43
- this._resolveCacheKey = resolveCacheKey != null ? resolveCacheKey : args => JSON.stringify(args);
44
- // Startup code
45
- if (pathExists.pathExistsSync(cachePath)) ; else if (autoCreateCachePath) {
46
- fs__default["default"].mkdirSync(cachePath, {
47
- recursive: true
48
- });
49
- } else {
50
- throw new Error("💥 FileCache error: cachePath does not exist.");
51
- }
52
- // fire and forget
53
- this.cleanup();
54
- this._intervalId = setInterval(this.cleanup.bind(this), this._cleanupInterval);
55
- }
56
- /**
57
- * Resolves the filename for the cache based on the provided arguments.
58
- *
59
- * Uses the provided `resolveFileName` function if available, or falls back to
60
- * generating a hash from the arguments to create a unique file name.
61
- */
62
- async resolveFileName(args) {
63
- const [name, ext] = await Promise.all([this._resolveCacheKey(args), this._ext(args)]);
64
- const resolvedFileName = sha1__default["default"](JSON.stringify([name, ext]));
65
- return path__default["default"].format({
66
- name: resolvedFileName,
67
- ext
68
- });
69
- }
70
- /**
71
- * Retrieves a cached file for the given arguments.
72
- * If the file doesn't exist, it is generated by the callback and stored.
73
- *
74
- * Concurrency-safe, ensuring no conflicts when multiple requests are made
75
- * for the same file.
76
- *
77
- * @param args The arguments used to determine the file's identity and generation
78
- * @returns The path to the cached or newly created file
79
- */
80
- async getFile(args) {
81
- const filePath = await this.resolveFilePath(args);
82
- try {
83
- await Promise.all([this._cleanupGroupSemaphore.acquire("getFile"), this._semaphore.acquire(filePath)]);
84
- if (await pathExists.pathExists(filePath)) {
85
- // fire and forget
86
- touch__default["default"](filePath);
87
- } else {
88
- await fs__default["default"].promises.mkdir(path__default["default"].dirname(filePath), {
89
- recursive: true
90
- });
91
- await this._cb(filePath, args, this);
92
- }
93
- } finally {
94
- this._semaphore.release(filePath);
95
- this._cleanupGroupSemaphore.release("getFile");
96
- }
97
- return filePath;
98
- }
99
- /**
100
- * Resolves the full file path for the cached file based on the provided arguments.
101
- *
102
- * @param args The arguments used to resolve the file path
103
- * @returns The full path to the cached file
104
- */
105
- async resolveFilePath(args) {
106
- const fileName = await this.resolveFileName(args);
107
- const filePath = path__default["default"].resolve(this._cachePath, fileName[0], fileName[1], fileName[2], fileName);
108
- return filePath;
109
- }
110
- /**
111
- * Stops the background cleanup process, but does not delete any cached files.
112
- */
113
- destroy() {
114
- if (this._intervalId) {
115
- clearInterval(this._intervalId);
116
- this._intervalId = null;
117
- }
118
- }
119
- async has(args) {
120
- const filePath = await this.resolveFilePath(args);
121
- return await pathExists.pathExists(filePath);
122
- }
123
- /**
124
- * Runs a cleanup pass to remove files older than 1 day from the cache.
125
- * This is called periodically, but can be triggered manually.
126
- */
127
- async cleanup() {
128
- try {
129
- await this._cleanupGroupSemaphore.acquire("cleanup");
130
- await findNuke.findNuke(this._cachePath, {
131
- olderThan: this._ttl,
132
- verbose: true,
133
- deleteEmptyDirectories: true
134
- });
135
- } finally {
136
- this._cleanupGroupSemaphore.release("cleanup");
137
- }
138
- }
139
- }
140
-
141
- exports.FileCache = FileCache;
142
- //# sourceMappingURL=file-cache.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"file-cache.cjs","sources":["../src/index.ts"],"sourcesContent":["import path from \"path\";\nimport fs from \"fs\";\nimport { pathExists, pathExistsSync } from \"path-exists\";\nimport sha1 from \"sha1\";\nimport { GroupSemaphore, Semaphore } from \"@chriscdn/promise-semaphore\";\nimport touch from \"touch\";\nimport { findNuke } from \"@chriscdn/find-nuke\";\nimport { Duration } from \"@chriscdn/duration\";\n\ntype DirectoryPath = string;\ntype FileName = string;\ntype FilePath = string;\ntype Milliseconds = number;\n\nexport type FileCacheOptions<T extends Record<string, any>> = {\n cachePath: DirectoryPath;\n autoCreateCachePath?: boolean;\n cb: (filePath: FilePath, args: T, cache: FileCache<T>) => Promise<void>;\n ext: (args: T) => string | Promise<string>;\n resolveCacheKey?: (args: T) => string | Promise<string>;\n ttl: Milliseconds;\n cleanupInterval?: Milliseconds;\n};\n\nclass FileCache<T extends Record<string, any>> {\n private _cachePath: FileCacheOptions<T>[\"cachePath\"];\n private _cb: FileCacheOptions<T>[\"cb\"];\n private _ttl: FileCacheOptions<T>[\"ttl\"];\n private _cleanupInterval: FileCacheOptions<T>[\"cleanupInterval\"];\n private _resolveCacheKey: Required<\n FileCacheOptions<T>\n >[\"resolveCacheKey\"];\n private _ext: FileCacheOptions<T>[\"ext\"];\n private _intervalId: ReturnType<typeof setInterval> | null = null;\n private _semaphore: Semaphore = new Semaphore();\n private _cleanupGroupSemaphore: GroupSemaphore = new GroupSemaphore();\n\n constructor(\n {\n cachePath,\n autoCreateCachePath,\n cb,\n ext,\n ttl,\n cleanupInterval,\n resolveCacheKey,\n }: FileCacheOptions<T>,\n ) {\n this._cachePath = cachePath;\n this._cb = cb;\n this._ext = ext;\n this._ttl = ttl;\n this._cleanupInterval = cleanupInterval ??\n Duration.toMilliseconds({ days: 1 });\n\n this._resolveCacheKey = resolveCacheKey ??\n ((args: T) => (JSON.stringify(args)));\n\n // Startup code\n if ((pathExistsSync(cachePath))) {\n // we're good\n } else if (autoCreateCachePath) {\n fs.mkdirSync(cachePath, { recursive: true });\n } else {\n throw new Error(\"💥 FileCache error: cachePath does not exist.\");\n }\n\n // fire and forget\n this.cleanup();\n\n this._intervalId = setInterval(\n this.cleanup.bind(this),\n this._cleanupInterval,\n );\n }\n\n /**\n * Resolves the filename for the cache based on the provided arguments.\n *\n * Uses the provided `resolveFileName` function if available, or falls back to\n * generating a hash from the arguments to create a unique file name.\n */\n private async resolveFileName(args: T): Promise<FileName> {\n const [name, ext] = await Promise.all([\n this._resolveCacheKey(args),\n this._ext(args),\n ]);\n\n const resolvedFileName = sha1(JSON.stringify([name, ext]));\n\n return path.format({\n name: resolvedFileName,\n ext,\n }) as FileName;\n }\n\n /**\n * Retrieves a cached file for the given arguments.\n * If the file doesn't exist, it is generated by the callback and stored.\n *\n * Concurrency-safe, ensuring no conflicts when multiple requests are made\n * for the same file.\n *\n * @param args The arguments used to determine the file's identity and generation\n * @returns The path to the cached or newly created file\n */\n async getFile(args: T): Promise<FilePath> {\n const filePath = await this.resolveFilePath(args);\n\n try {\n await Promise.all([\n this._cleanupGroupSemaphore.acquire(\"getFile\"),\n this._semaphore.acquire(filePath),\n ]);\n\n if (await pathExists(filePath)) {\n // fire and forget\n touch(filePath);\n } else {\n await fs.promises.mkdir(path.dirname(filePath), { recursive: true });\n await this._cb(filePath, args, this);\n }\n } finally {\n this._semaphore.release(filePath);\n this._cleanupGroupSemaphore.release(\"getFile\");\n }\n\n return filePath;\n }\n\n /**\n * Resolves the full file path for the cached file based on the provided arguments.\n *\n * @param args The arguments used to resolve the file path\n * @returns The full path to the cached file\n */\n async resolveFilePath(args: T): Promise<FilePath> {\n const fileName = await this.resolveFileName(args);\n\n const filePath = path.resolve(\n this._cachePath,\n fileName[0],\n fileName[1],\n fileName[2],\n fileName,\n );\n\n return filePath;\n }\n\n /**\n * Stops the background cleanup process, but does not delete any cached files.\n */\n destroy() {\n if (this._intervalId) {\n clearInterval(this._intervalId);\n this._intervalId = null;\n }\n }\n\n async has(args: T): Promise<boolean> {\n const filePath = await this.resolveFilePath(args);\n return await pathExists(filePath);\n }\n\n /**\n * Runs a cleanup pass to remove files older than 1 day from the cache.\n * This is called periodically, but can be triggered manually.\n */\n async cleanup() {\n try {\n await this._cleanupGroupSemaphore.acquire(\"cleanup\");\n await findNuke(this._cachePath, {\n olderThan: this._ttl,\n verbose: true,\n deleteEmptyDirectories: true,\n });\n } finally {\n this._cleanupGroupSemaphore.release(\"cleanup\");\n }\n }\n}\n\nexport { type DirectoryPath, FileCache, type FileName, type FilePath };\n"],"names":["FileCache","constructor","cachePath","autoCreateCachePath","cb","ext","ttl","cleanupInterval","resolveCacheKey","_cachePath","_cb","_ttl","_cleanupInterval","_resolveCacheKey","_ext","_intervalId","_semaphore","Semaphore","_cleanupGroupSemaphore","GroupSemaphore","Duration","toMilliseconds","days","args","JSON","stringify","pathExistsSync","fs","mkdirSync","recursive","Error","cleanup","setInterval","bind","resolveFileName","name","Promise","all","resolvedFileName","sha1","path","format","getFile","filePath","resolveFilePath","acquire","pathExists","touch","promises","mkdir","dirname","release","fileName","resolve","destroy","clearInterval","has","findNuke","olderThan","verbose","deleteEmptyDirectories"],"mappings":"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"}
@@ -1,135 +0,0 @@
1
- import path from 'path';
2
- import fs from 'fs';
3
- import { pathExistsSync, pathExists } from 'path-exists';
4
- import sha1 from 'sha1';
5
- import { Semaphore, GroupSemaphore } from '@chriscdn/promise-semaphore';
6
- import touch from 'touch';
7
- import { findNuke } from '@chriscdn/find-nuke';
8
- import { Duration } from '@chriscdn/duration';
9
-
10
- class FileCache {
11
- constructor({
12
- cachePath,
13
- autoCreateCachePath,
14
- cb,
15
- ext,
16
- ttl,
17
- cleanupInterval,
18
- resolveCacheKey
19
- }) {
20
- this._cachePath = void 0;
21
- this._cb = void 0;
22
- this._ttl = void 0;
23
- this._cleanupInterval = void 0;
24
- this._resolveCacheKey = void 0;
25
- this._ext = void 0;
26
- this._intervalId = null;
27
- this._semaphore = new Semaphore();
28
- this._cleanupGroupSemaphore = new GroupSemaphore();
29
- this._cachePath = cachePath;
30
- this._cb = cb;
31
- this._ext = ext;
32
- this._ttl = ttl;
33
- this._cleanupInterval = cleanupInterval != null ? cleanupInterval : Duration.toMilliseconds({
34
- days: 1
35
- });
36
- this._resolveCacheKey = resolveCacheKey != null ? resolveCacheKey : args => JSON.stringify(args);
37
- // Startup code
38
- if (pathExistsSync(cachePath)) ; else if (autoCreateCachePath) {
39
- fs.mkdirSync(cachePath, {
40
- recursive: true
41
- });
42
- } else {
43
- throw new Error("💥 FileCache error: cachePath does not exist.");
44
- }
45
- // fire and forget
46
- this.cleanup();
47
- this._intervalId = setInterval(this.cleanup.bind(this), this._cleanupInterval);
48
- }
49
- /**
50
- * Resolves the filename for the cache based on the provided arguments.
51
- *
52
- * Uses the provided `resolveFileName` function if available, or falls back to
53
- * generating a hash from the arguments to create a unique file name.
54
- */
55
- async resolveFileName(args) {
56
- const [name, ext] = await Promise.all([this._resolveCacheKey(args), this._ext(args)]);
57
- const resolvedFileName = sha1(JSON.stringify([name, ext]));
58
- return path.format({
59
- name: resolvedFileName,
60
- ext
61
- });
62
- }
63
- /**
64
- * Retrieves a cached file for the given arguments.
65
- * If the file doesn't exist, it is generated by the callback and stored.
66
- *
67
- * Concurrency-safe, ensuring no conflicts when multiple requests are made
68
- * for the same file.
69
- *
70
- * @param args The arguments used to determine the file's identity and generation
71
- * @returns The path to the cached or newly created file
72
- */
73
- async getFile(args) {
74
- const filePath = await this.resolveFilePath(args);
75
- try {
76
- await Promise.all([this._cleanupGroupSemaphore.acquire("getFile"), this._semaphore.acquire(filePath)]);
77
- if (await pathExists(filePath)) {
78
- // fire and forget
79
- touch(filePath);
80
- } else {
81
- await fs.promises.mkdir(path.dirname(filePath), {
82
- recursive: true
83
- });
84
- await this._cb(filePath, args, this);
85
- }
86
- } finally {
87
- this._semaphore.release(filePath);
88
- this._cleanupGroupSemaphore.release("getFile");
89
- }
90
- return filePath;
91
- }
92
- /**
93
- * Resolves the full file path for the cached file based on the provided arguments.
94
- *
95
- * @param args The arguments used to resolve the file path
96
- * @returns The full path to the cached file
97
- */
98
- async resolveFilePath(args) {
99
- const fileName = await this.resolveFileName(args);
100
- const filePath = path.resolve(this._cachePath, fileName[0], fileName[1], fileName[2], fileName);
101
- return filePath;
102
- }
103
- /**
104
- * Stops the background cleanup process, but does not delete any cached files.
105
- */
106
- destroy() {
107
- if (this._intervalId) {
108
- clearInterval(this._intervalId);
109
- this._intervalId = null;
110
- }
111
- }
112
- async has(args) {
113
- const filePath = await this.resolveFilePath(args);
114
- return await pathExists(filePath);
115
- }
116
- /**
117
- * Runs a cleanup pass to remove files older than 1 day from the cache.
118
- * This is called periodically, but can be triggered manually.
119
- */
120
- async cleanup() {
121
- try {
122
- await this._cleanupGroupSemaphore.acquire("cleanup");
123
- await findNuke(this._cachePath, {
124
- olderThan: this._ttl,
125
- verbose: true,
126
- deleteEmptyDirectories: true
127
- });
128
- } finally {
129
- this._cleanupGroupSemaphore.release("cleanup");
130
- }
131
- }
132
- }
133
-
134
- export { FileCache };
135
- //# sourceMappingURL=file-cache.modern.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"file-cache.modern.js","sources":["../src/index.ts"],"sourcesContent":["import path from \"path\";\nimport fs from \"fs\";\nimport { pathExists, pathExistsSync } from \"path-exists\";\nimport sha1 from \"sha1\";\nimport { GroupSemaphore, Semaphore } from \"@chriscdn/promise-semaphore\";\nimport touch from \"touch\";\nimport { findNuke } from \"@chriscdn/find-nuke\";\nimport { Duration } from \"@chriscdn/duration\";\n\ntype DirectoryPath = string;\ntype FileName = string;\ntype FilePath = string;\ntype Milliseconds = number;\n\nexport type FileCacheOptions<T extends Record<string, any>> = {\n cachePath: DirectoryPath;\n autoCreateCachePath?: boolean;\n cb: (filePath: FilePath, args: T, cache: FileCache<T>) => Promise<void>;\n ext: (args: T) => string | Promise<string>;\n resolveCacheKey?: (args: T) => string | Promise<string>;\n ttl: Milliseconds;\n cleanupInterval?: Milliseconds;\n};\n\nclass FileCache<T extends Record<string, any>> {\n private _cachePath: FileCacheOptions<T>[\"cachePath\"];\n private _cb: FileCacheOptions<T>[\"cb\"];\n private _ttl: FileCacheOptions<T>[\"ttl\"];\n private _cleanupInterval: FileCacheOptions<T>[\"cleanupInterval\"];\n private _resolveCacheKey: Required<\n FileCacheOptions<T>\n >[\"resolveCacheKey\"];\n private _ext: FileCacheOptions<T>[\"ext\"];\n private _intervalId: ReturnType<typeof setInterval> | null = null;\n private _semaphore: Semaphore = new Semaphore();\n private _cleanupGroupSemaphore: GroupSemaphore = new GroupSemaphore();\n\n constructor(\n {\n cachePath,\n autoCreateCachePath,\n cb,\n ext,\n ttl,\n cleanupInterval,\n resolveCacheKey,\n }: FileCacheOptions<T>,\n ) {\n this._cachePath = cachePath;\n this._cb = cb;\n this._ext = ext;\n this._ttl = ttl;\n this._cleanupInterval = cleanupInterval ??\n Duration.toMilliseconds({ days: 1 });\n\n this._resolveCacheKey = resolveCacheKey ??\n ((args: T) => (JSON.stringify(args)));\n\n // Startup code\n if ((pathExistsSync(cachePath))) {\n // we're good\n } else if (autoCreateCachePath) {\n fs.mkdirSync(cachePath, { recursive: true });\n } else {\n throw new Error(\"💥 FileCache error: cachePath does not exist.\");\n }\n\n // fire and forget\n this.cleanup();\n\n this._intervalId = setInterval(\n this.cleanup.bind(this),\n this._cleanupInterval,\n );\n }\n\n /**\n * Resolves the filename for the cache based on the provided arguments.\n *\n * Uses the provided `resolveFileName` function if available, or falls back to\n * generating a hash from the arguments to create a unique file name.\n */\n private async resolveFileName(args: T): Promise<FileName> {\n const [name, ext] = await Promise.all([\n this._resolveCacheKey(args),\n this._ext(args),\n ]);\n\n const resolvedFileName = sha1(JSON.stringify([name, ext]));\n\n return path.format({\n name: resolvedFileName,\n ext,\n }) as FileName;\n }\n\n /**\n * Retrieves a cached file for the given arguments.\n * If the file doesn't exist, it is generated by the callback and stored.\n *\n * Concurrency-safe, ensuring no conflicts when multiple requests are made\n * for the same file.\n *\n * @param args The arguments used to determine the file's identity and generation\n * @returns The path to the cached or newly created file\n */\n async getFile(args: T): Promise<FilePath> {\n const filePath = await this.resolveFilePath(args);\n\n try {\n await Promise.all([\n this._cleanupGroupSemaphore.acquire(\"getFile\"),\n this._semaphore.acquire(filePath),\n ]);\n\n if (await pathExists(filePath)) {\n // fire and forget\n touch(filePath);\n } else {\n await fs.promises.mkdir(path.dirname(filePath), { recursive: true });\n await this._cb(filePath, args, this);\n }\n } finally {\n this._semaphore.release(filePath);\n this._cleanupGroupSemaphore.release(\"getFile\");\n }\n\n return filePath;\n }\n\n /**\n * Resolves the full file path for the cached file based on the provided arguments.\n *\n * @param args The arguments used to resolve the file path\n * @returns The full path to the cached file\n */\n async resolveFilePath(args: T): Promise<FilePath> {\n const fileName = await this.resolveFileName(args);\n\n const filePath = path.resolve(\n this._cachePath,\n fileName[0],\n fileName[1],\n fileName[2],\n fileName,\n );\n\n return filePath;\n }\n\n /**\n * Stops the background cleanup process, but does not delete any cached files.\n */\n destroy() {\n if (this._intervalId) {\n clearInterval(this._intervalId);\n this._intervalId = null;\n }\n }\n\n async has(args: T): Promise<boolean> {\n const filePath = await this.resolveFilePath(args);\n return await pathExists(filePath);\n }\n\n /**\n * Runs a cleanup pass to remove files older than 1 day from the cache.\n * This is called periodically, but can be triggered manually.\n */\n async cleanup() {\n try {\n await this._cleanupGroupSemaphore.acquire(\"cleanup\");\n await findNuke(this._cachePath, {\n olderThan: this._ttl,\n verbose: true,\n deleteEmptyDirectories: true,\n });\n } finally {\n this._cleanupGroupSemaphore.release(\"cleanup\");\n }\n }\n}\n\nexport { type DirectoryPath, FileCache, type FileName, type FilePath };\n"],"names":["FileCache","constructor","cachePath","autoCreateCachePath","cb","ext","ttl","cleanupInterval","resolveCacheKey","_cachePath","_cb","_ttl","_cleanupInterval","_resolveCacheKey","_ext","_intervalId","_semaphore","Semaphore","_cleanupGroupSemaphore","GroupSemaphore","Duration","toMilliseconds","days","args","JSON","stringify","pathExistsSync","fs","mkdirSync","recursive","Error","cleanup","setInterval","bind","resolveFileName","name","Promise","all","resolvedFileName","sha1","path","format","getFile","filePath","resolveFilePath","acquire","pathExists","touch","promises","mkdir","dirname","release","fileName","resolve","destroy","clearInterval","has","findNuke","olderThan","verbose","deleteEmptyDirectories"],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"file-cache.module.js","sources":["../src/index.ts"],"sourcesContent":["import path from \"path\";\nimport fs from \"fs\";\nimport { pathExists, pathExistsSync } from \"path-exists\";\nimport sha1 from \"sha1\";\nimport { GroupSemaphore, Semaphore } from \"@chriscdn/promise-semaphore\";\nimport touch from \"touch\";\nimport { findNuke } from \"@chriscdn/find-nuke\";\nimport { Duration } from \"@chriscdn/duration\";\n\ntype DirectoryPath = string;\ntype FileName = string;\ntype FilePath = string;\ntype Milliseconds = number;\n\nexport type FileCacheOptions<T extends Record<string, any>> = {\n cachePath: DirectoryPath;\n autoCreateCachePath?: boolean;\n cb: (filePath: FilePath, args: T, cache: FileCache<T>) => Promise<void>;\n ext: (args: T) => string | Promise<string>;\n resolveCacheKey?: (args: T) => string | Promise<string>;\n ttl: Milliseconds;\n cleanupInterval?: Milliseconds;\n};\n\nclass FileCache<T extends Record<string, any>> {\n private _cachePath: FileCacheOptions<T>[\"cachePath\"];\n private _cb: FileCacheOptions<T>[\"cb\"];\n private _ttl: FileCacheOptions<T>[\"ttl\"];\n private _cleanupInterval: FileCacheOptions<T>[\"cleanupInterval\"];\n private _resolveCacheKey: Required<\n FileCacheOptions<T>\n >[\"resolveCacheKey\"];\n private _ext: FileCacheOptions<T>[\"ext\"];\n private _intervalId: ReturnType<typeof setInterval> | null = null;\n private _semaphore: Semaphore = new Semaphore();\n private _cleanupGroupSemaphore: GroupSemaphore = new GroupSemaphore();\n\n constructor(\n {\n cachePath,\n autoCreateCachePath,\n cb,\n ext,\n ttl,\n cleanupInterval,\n resolveCacheKey,\n }: FileCacheOptions<T>,\n ) {\n this._cachePath = cachePath;\n this._cb = cb;\n this._ext = ext;\n this._ttl = ttl;\n this._cleanupInterval = cleanupInterval ??\n Duration.toMilliseconds({ days: 1 });\n\n this._resolveCacheKey = resolveCacheKey ??\n ((args: T) => (JSON.stringify(args)));\n\n // Startup code\n if ((pathExistsSync(cachePath))) {\n // we're good\n } else if (autoCreateCachePath) {\n fs.mkdirSync(cachePath, { recursive: true });\n } else {\n throw new Error(\"💥 FileCache error: cachePath does not exist.\");\n }\n\n // fire and forget\n this.cleanup();\n\n this._intervalId = setInterval(\n this.cleanup.bind(this),\n this._cleanupInterval,\n );\n }\n\n /**\n * Resolves the filename for the cache based on the provided arguments.\n *\n * Uses the provided `resolveFileName` function if available, or falls back to\n * generating a hash from the arguments to create a unique file name.\n */\n private async resolveFileName(args: T): Promise<FileName> {\n const [name, ext] = await Promise.all([\n this._resolveCacheKey(args),\n this._ext(args),\n ]);\n\n const resolvedFileName = sha1(JSON.stringify([name, ext]));\n\n return path.format({\n name: resolvedFileName,\n ext,\n }) as FileName;\n }\n\n /**\n * Retrieves a cached file for the given arguments.\n * If the file doesn't exist, it is generated by the callback and stored.\n *\n * Concurrency-safe, ensuring no conflicts when multiple requests are made\n * for the same file.\n *\n * @param args The arguments used to determine the file's identity and generation\n * @returns The path to the cached or newly created file\n */\n async getFile(args: T): Promise<FilePath> {\n const filePath = await this.resolveFilePath(args);\n\n try {\n await Promise.all([\n this._cleanupGroupSemaphore.acquire(\"getFile\"),\n this._semaphore.acquire(filePath),\n ]);\n\n if (await pathExists(filePath)) {\n // fire and forget\n touch(filePath);\n } else {\n await fs.promises.mkdir(path.dirname(filePath), { recursive: true });\n await this._cb(filePath, args, this);\n }\n } finally {\n this._semaphore.release(filePath);\n this._cleanupGroupSemaphore.release(\"getFile\");\n }\n\n return filePath;\n }\n\n /**\n * Resolves the full file path for the cached file based on the provided arguments.\n *\n * @param args The arguments used to resolve the file path\n * @returns The full path to the cached file\n */\n async resolveFilePath(args: T): Promise<FilePath> {\n const fileName = await this.resolveFileName(args);\n\n const filePath = path.resolve(\n this._cachePath,\n fileName[0],\n fileName[1],\n fileName[2],\n fileName,\n );\n\n return filePath;\n }\n\n /**\n * Stops the background cleanup process, but does not delete any cached files.\n */\n destroy() {\n if (this._intervalId) {\n clearInterval(this._intervalId);\n this._intervalId = null;\n }\n }\n\n async has(args: T): Promise<boolean> {\n const filePath = await this.resolveFilePath(args);\n return await pathExists(filePath);\n }\n\n /**\n * Runs a cleanup pass to remove files older than 1 day from the cache.\n * This is called periodically, but can be triggered manually.\n */\n async cleanup() {\n try {\n await this._cleanupGroupSemaphore.acquire(\"cleanup\");\n await findNuke(this._cachePath, {\n olderThan: this._ttl,\n verbose: true,\n deleteEmptyDirectories: true,\n });\n } finally {\n this._cleanupGroupSemaphore.release(\"cleanup\");\n }\n }\n}\n\nexport { type DirectoryPath, FileCache, type FileName, type FilePath };\n"],"names":["FileCache","constructor","cachePath","autoCreateCachePath","cb","ext","ttl","cleanupInterval","resolveCacheKey","_cachePath","_cb","_ttl","_cleanupInterval","_resolveCacheKey","_ext","_intervalId","_semaphore","Semaphore","_cleanupGroupSemaphore","GroupSemaphore","Duration","toMilliseconds","days","args","JSON","stringify","pathExistsSync","fs","mkdirSync","recursive","Error","cleanup","setInterval","bind","resolveFileName","name","Promise","all","resolvedFileName","sha1","path","format","getFile","filePath","resolveFilePath","acquire","pathExists","touch","promises","mkdir","dirname","release","fileName","resolve","destroy","clearInterval","has","findNuke","olderThan","verbose","deleteEmptyDirectories"],"mappings":"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"}