@memlab/cli 1.0.0

package/dist/options/heap/FinalFileOption.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import { BaseOption, MemLabConfig } from '@memlab/core';
+export default class FinalFileOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    getExampleValues(): string[];
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=FinalFileOption.d.ts.map

package/dist/options/heap/FinalFileOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinalFileOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/FinalFileOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAC,UAAU,EAAE,YAAY,EAAQ,MAAM,cAAc,CAAC;AAE7D,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,UAAU;IACrD,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIxB,gBAAgB,IAAI,MAAM,EAAE;IAItB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAcnE"}

package/dist/options/heap/FinalFileOption.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const core_1 = require("@memlab/core");
+class FinalFileOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'final';
+    }
+    getDescription() {
+        return 'set file path of the final heap snapshot';
+    }
+    getExampleValues() {
+        return ['/tmp/final.heapsnapshot'];
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!args.final) {
+                return;
+            }
+            const file = args.final;
+            if (!fs_1.default.existsSync(file)) {
+                core_1.utils.haltOrThrow(`Invalid snapshot file: ${file}`);
+            }
+            config.useExternalSnapshot = true;
+            if (!config.externalSnapshotFilePaths) {
+                config.externalSnapshotFilePaths = [];
+            }
+            config.externalSnapshotFilePaths[2] = file;
+        });
+    }
+}
+exports.default = FinalFileOption;

package/dist/options/heap/JSEngineOption.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import { BaseOption, MemLabConfig } from '@memlab/core';
+export default class JSEngineOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    getExampleValues(): string[];
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=JSEngineOption.d.ts.map

package/dist/options/heap/JSEngineOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSEngineOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/JSEngineOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAC,UAAU,EAAE,YAAY,EAAkB,MAAM,cAAc,CAAC;AAEvE,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,UAAU;IACpD,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIxB,gBAAgB,IAAI,MAAM,EAAE;IAItB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAanE"}

package/dist/options/heap/JSEngineOption.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+class JSEngineOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'engine';
+    }
+    getDescription() {
+        return 'set the JavaScript engine (default to v8)';
+    }
+    getExampleValues() {
+        return ['v8', 'hermes'];
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!args.engine) {
+                return;
+            }
+            config.jsEngine = args.engine;
+            config.specifiedEngine = true;
+            if (core_1.constant.supportedEngines.indexOf(config.jsEngine) < 0) {
+                core_1.utils.haltOrThrow(`Invalid engine: ${config.jsEngine} ` +
+                    `(supported engines: ${core_1.constant.supportedEngines.join(', ')})`);
+            }
+        });
+    }
+}
+exports.default = JSEngineOption;

package/dist/options/heap/LogTraceAsClusterOption.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import type { MemLabConfig } from '@memlab/core';
+import { BaseOption } from '@memlab/core';
+export default class LogTraceAsClusterOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=LogTraceAsClusterOption.d.ts.map

package/dist/options/heap/LogTraceAsClusterOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogTraceAsClusterOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/LogTraceAsClusterOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAExC,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,UAAU;IAC7D,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIlB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnE"}

package/dist/options/heap/LogTraceAsClusterOption.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+class LogTraceAsClusterOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'save-trace-as-unclassified-cluster';
+    }
+    getDescription() {
+        return 'dump each retainer trace as an unclassified trace cluster';
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args[this.getOptionName()]) {
+                config.logUnclassifiedClusters = true;
+            }
+        });
+    }
+}
+exports.default = LogTraceAsClusterOption;

package/dist/options/heap/OversizeThresholdOption.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import type { MemLabConfig } from '@memlab/core';
+import { BaseOption } from '@memlab/core';
+export default class OversizeThresholdOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    getExampleValues(): string[];
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=OversizeThresholdOption.d.ts.map

package/dist/options/heap/OversizeThresholdOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OversizeThresholdOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/OversizeThresholdOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAExC,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,UAAU;IAC7D,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAOxB,gBAAgB,IAAI,MAAM,EAAE;IAItB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CASnE"}

package/dist/options/heap/OversizeThresholdOption.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+class OversizeThresholdOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'oversize-threshold';
+    }
+    getDescription() {
+        return ('set oversize threshold (in bytes), objects with retained size ' +
+            'bigger than the threshold will be considered as leaks');
+    }
+    getExampleValues() {
+        return ['1000', '1000000'];
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args[this.getOptionName()]) {
+                const sizeThreshold = parseInt(args[this.getOptionName()], 10);
+                if (!isNaN(sizeThreshold)) {
+                    config.oversizeObjectAsLeak = true;
+                    config.oversizeThreshold = sizeThreshold;
+                }
+            }
+        });
+    }
+}
+exports.default = OversizeThresholdOption;

package/dist/options/heap/SnapshotDirectoryOption.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import { BaseOption, MemLabConfig } from '@memlab/core';
+export default class SnapshotDirectoryOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    getExampleValues(): string[];
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=SnapshotDirectoryOption.d.ts.map

package/dist/options/heap/SnapshotDirectoryOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotDirectoryOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/SnapshotDirectoryOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAC,UAAU,EAAE,YAAY,EAAQ,MAAM,cAAc,CAAC;AAE7D,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,UAAU;IAC7D,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIxB,gBAAgB,IAAI,MAAM,EAAE;IAItB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnE"}

package/dist/options/heap/SnapshotDirectoryOption.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const core_1 = require("@memlab/core");
+class SnapshotDirectoryOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'snapshot-dir';
+    }
+    getDescription() {
+        return 'set directory path containing all heap snapshots under analysis';
+    }
+    getExampleValues() {
+        return ['/tmp/snapshots/'];
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!args['snapshot-dir']) {
+                return;
+            }
+            const dir = args['snapshot-dir'];
+            if (!fs_1.default.existsSync(dir)) {
+                core_1.utils.haltOrThrow(`Invalid directory: ${dir}`);
+            }
+            config.externalSnapshotDir = dir;
+            config.useExternalSnapshot = true;
+        });
+    }
+}
+exports.default = SnapshotDirectoryOption;

package/dist/options/heap/SnapshotFileOption.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import { BaseOption, MemLabConfig } from '@memlab/core';
+export default class SnapshotFileOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    getExampleValues(): string[];
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=SnapshotFileOption.d.ts.map

package/dist/options/heap/SnapshotFileOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotFileOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/SnapshotFileOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAC,UAAU,EAAE,YAAY,EAAQ,MAAM,cAAc,CAAC;AAE7D,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,UAAU;IACxD,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIxB,gBAAgB,IAAI,MAAM,EAAE;IAItB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnE"}

package/dist/options/heap/SnapshotFileOption.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const core_1 = require("@memlab/core");
+class SnapshotFileOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'snapshot';
+    }
+    getDescription() {
+        return 'set file path of the heap snapshot under analysis';
+    }
+    getExampleValues() {
+        return ['/tmp/file.heapsnapshot'];
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!args.snapshot) {
+                return;
+            }
+            const file = args.snapshot;
+            if (!fs_1.default.existsSync(file)) {
+                core_1.utils.haltOrThrow(`Invalid snapshot file: ${file}`);
+            }
+            config.useExternalSnapshot = true;
+            config.externalSnapshotFilePaths[0] = file;
+        });
+    }
+}
+exports.default = SnapshotFileOption;

package/dist/options/heap/TargetFileOption.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import { BaseOption, MemLabConfig } from '@memlab/core';
+export default class TargetFileOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    getExampleValues(): string[];
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=TargetFileOption.d.ts.map

package/dist/options/heap/TargetFileOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TargetFileOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/TargetFileOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAC,UAAU,EAAE,YAAY,EAAQ,MAAM,cAAc,CAAC;AAE7D,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,UAAU;IACtD,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIxB,gBAAgB,IAAI,MAAM,EAAE;IAItB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAcnE"}

package/dist/options/heap/TargetFileOption.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const core_1 = require("@memlab/core");
+class TargetFileOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'target';
+    }
+    getDescription() {
+        return 'set file path of the target heap snapshot';
+    }
+    getExampleValues() {
+        return ['/tmp/target.heapsnapshot'];
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!args.target) {
+                return;
+            }
+            const file = args.target;
+            if (!fs_1.default.existsSync(file)) {
+                core_1.utils.haltOrThrow(`Invalid snapshot file: ${file}`);
+            }
+            config.useExternalSnapshot = true;
+            if (!config.externalSnapshotFilePaths) {
+                config.externalSnapshotFilePaths = [];
+            }
+            config.externalSnapshotFilePaths[1] = file;
+        });
+    }
+}
+exports.default = TargetFileOption;

package/dist/options/heap/TraceAllObjectsOption.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import type { MemLabConfig } from '@memlab/core';
+import { BaseOption } from '@memlab/core';
+export default class TraceAllObjectsOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=TraceAllObjectsOption.d.ts.map

package/dist/options/heap/TraceAllObjectsOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceAllObjectsOption.d.ts","sourceRoot":"","sources":["../../../src/options/heap/TraceAllObjectsOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAExC,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,UAAU;IAC3D,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIlB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAMnE"}

package/dist/options/heap/TraceAllObjectsOption.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+class TraceAllObjectsOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'trace-all-objects';
+    }
+    getDescription() {
+        return 'dump retainer trace for all allocated objects (ignore the leak filter)';
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args[this.getOptionName()]) {
+                config.oversizeObjectAsLeak = true;
+                config.oversizeThreshold = 0;
+            }
+        });
+    }
+}
+exports.default = TraceAllObjectsOption;

package/dist/options/heap/leak-filter/LeakFilterFileOption.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import type { ParsedArgs } from 'minimist';
+import type { MemLabConfig } from '@memlab/core';
+import { BaseOption } from '@memlab/core';
+export default class LeakFilterFileOption extends BaseOption {
+    getOptionName(): string;
+    getDescription(): string;
+    getExampleValues(): string[];
+    parse(config: MemLabConfig, args: ParsedArgs): Promise<void>;
+}
+//# sourceMappingURL=LeakFilterFileOption.d.ts.map

package/dist/options/heap/leak-filter/LeakFilterFileOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeakFilterFileOption.d.ts","sourceRoot":"","sources":["../../../../src/options/heap/leak-filter/LeakFilterFileOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAC,UAAU,EAAQ,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,UAAU;IAC1D,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIxB,gBAAgB,IAAI,MAAM,EAAE;IAItB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAMnE"}

package/dist/options/heap/leak-filter/LeakFilterFileOption.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@memlab/core");
+class LeakFilterFileOption extends core_1.BaseOption {
+    getOptionName() {
+        return 'leak-filter';
+    }
+    getDescription() {
+        return 'specify a definition JS file for leak filter';
+    }
+    getExampleValues() {
+        return ['/tmp/leak-filter.js'];
+    }
+    parse(config, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args[this.getOptionName()]) {
+                const file = args[this.getOptionName()];
+                config.externalLeakFilter = core_1.utils.loadLeakFilter(file);
+            }
+        });
+    }
+}
+exports.default = LeakFilterFileOption;

package/dist/options/heap/leak-filter/examples/FilterLib.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @emails oncall+ws_labs
+ * @format
+ */
+import { IHeapSnapshot } from '@memlab/core';
+export declare function initMap(snapshot: IHeapSnapshot): Record<string, number>;
+//# sourceMappingURL=FilterLib.d.ts.map

package/dist/options/heap/leak-filter/examples/FilterLib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterLib.d.ts","sourceRoot":"","sources":["../../../../../src/options/heap/leak-filter/examples/FilterLib.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAC,aAAa,EAAQ,MAAM,cAAc,CAAC;AAElD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcvE"}