@haneullabs/mvr-static 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,329 @@
+# @haneullabs/mvr-static
+
+## 0.2.12
+
+### Patch Changes
+
+- Updated dependencies [29e8b92]
+  - @haneullabs/haneul@1.45.2
+
+## 0.2.11
+
+### Patch Changes
+
+- Updated dependencies [e3811f1]
+  - @haneullabs/haneul@1.45.1
+
+## 0.2.10
+
+### Patch Changes
+
+- Updated dependencies [88bdbac]
+  - @haneullabs/haneul@1.45.0
+
+## 0.2.9
+
+### Patch Changes
+
+- Updated dependencies [44d9b4f]
+  - @haneullabs/haneul@1.44.0
+
+## 0.2.8
+
+### Patch Changes
+
+- @haneullabs/haneul@1.43.2
+
+## 0.2.7
+
+### Patch Changes
+
+- @haneullabs/haneul@1.43.1
+
+## 0.2.6
+
+### Patch Changes
+
+- Updated dependencies [f3b19a7]
+- Updated dependencies [bf9f85c]
+  - @haneullabs/haneul@1.43.0
+
+## 0.2.5
+
+### Patch Changes
+
+- Updated dependencies [98c8a27]
+  - @haneullabs/haneul@1.42.0
+
+## 0.2.4
+
+### Patch Changes
+
+- Updated dependencies [d554cd2]
+- Updated dependencies [04fcfbc]
+  - @haneullabs/haneul@1.41.0
+
+## 0.2.3
+
+### Patch Changes
+
+- Updated dependencies [f5fc0c0]
+  - @haneullabs/haneul@1.40.0
+
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [a9f9035]
+  - @haneullabs/haneul@1.39.1
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [ca92487]
+- Updated dependencies [5ab3c0a]
+  - @haneullabs/haneul@1.39.0
+
+## 0.2.0
+
+### Minor Changes
+
+- ea1ac70: Update dependencies and improve support for typescript 5.9
+
+### Patch Changes
+
+- Updated dependencies [3c1741f]
+- Updated dependencies [ea1ac70]
+  - @haneullabs/haneul@1.38.0
+
+## 0.1.31
+
+### Patch Changes
+
+- Updated dependencies [c689b98]
+- Updated dependencies [5b9ff1a]
+  - @haneullabs/haneul@1.37.6
+
+## 0.1.30
+
+### Patch Changes
+
+- Updated dependencies [3980d04]
+  - @haneullabs/haneul@1.37.5
+
+## 0.1.29
+
+### Patch Changes
+
+- Updated dependencies [6b03e57]
+  - @haneullabs/haneul@1.37.4
+
+## 0.1.28
+
+### Patch Changes
+
+- Updated dependencies [8ff1471]
+  - @haneullabs/haneul@1.37.3
+
+## 0.1.27
+
+### Patch Changes
+
+- Updated dependencies [660377c]
+  - @haneullabs/haneul@1.37.2
+
+## 0.1.26
+
+### Patch Changes
+
+- @haneullabs/haneul@1.37.1
+
+## 0.1.25
+
+### Patch Changes
+
+- Updated dependencies [72168f0]
+  - @haneullabs/haneul@1.37.0
+
+## 0.1.24
+
+### Patch Changes
+
+- Updated dependencies [44354ab]
+  - @haneullabs/haneul@1.36.2
+
+## 0.1.23
+
+### Patch Changes
+
+- Updated dependencies [c76ddc5]
+  - @haneullabs/haneul@1.36.1
+
+## 0.1.22
+
+### Patch Changes
+
+- Updated dependencies [783bb9e]
+- Updated dependencies [783bb9e]
+- Updated dependencies [5cbbb21]
+  - @haneullabs/haneul@1.36.0
+
+## 0.1.21
+
+### Patch Changes
+
+- Updated dependencies [888afe6]
+  - @haneullabs/haneul@1.35.0
+
+## 0.1.20
+
+### Patch Changes
+
+- Updated dependencies [3fb7a83]
+  - @haneullabs/haneul@1.34.0
+
+## 0.1.19
+
+### Patch Changes
+
+- Updated dependencies [a00522b]
+  - @haneullabs/haneul@1.33.0
+
+## 0.1.18
+
+### Patch Changes
+
+- Updated dependencies [6b7deb8]
+  - @haneullabs/haneul@1.32.0
+
+## 0.1.17
+
+### Patch Changes
+
+- Updated dependencies [1ff4e57]
+- Updated dependencies [550e2e3]
+- Updated dependencies [550e2e3]
+  - @haneullabs/haneul@1.31.0
+
+## 0.1.16
+
+### Patch Changes
+
+- Updated dependencies [5bd6ca3]
+  - @haneullabs/haneul@1.30.5
+
+## 0.1.15
+
+### Patch Changes
+
+- Updated dependencies [5dce590]
+- Updated dependencies [4a5aef6]
+  - @haneullabs/haneul@1.30.4
+
+## 0.1.14
+
+### Patch Changes
+
+- bb7c03a: Update dependencies
+- Updated dependencies [4457f10]
+- Updated dependencies [bb7c03a]
+  - @haneullabs/haneul@1.30.3
+
+## 0.1.13
+
+### Patch Changes
+
+- Updated dependencies [b265f7e]
+  - @haneullabs/haneul@1.30.2
+
+## 0.1.12
+
+### Patch Changes
+
+- Updated dependencies [ec519fc]
+  - @haneullabs/haneul@1.30.1
+
+## 0.1.11
+
+### Patch Changes
+
+- Updated dependencies [2456052]
+- Updated dependencies [5264038]
+- Updated dependencies [2456052]
+- Updated dependencies [2456052]
+- Updated dependencies [2456052]
+- Updated dependencies [2456052]
+  - @haneullabs/haneul@1.30.0
+
+## 0.1.10
+
+### Patch Changes
+
+- @haneullabs/haneul@1.29.1
+
+## 0.1.9
+
+### Patch Changes
+
+- Updated dependencies [7d66a32]
+- Updated dependencies [eb91fba]
+- Updated dependencies [19a8045]
+  - @haneullabs/haneul@1.29.0
+
+## 0.1.8
+
+### Patch Changes
+
+- Updated dependencies [9a94aea]
+  - @haneullabs/haneul@1.28.2
+
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies [3cd4e53]
+  - @haneullabs/haneul@1.28.1
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [2705dc8]
+  - @haneullabs/haneul@1.28.0
+
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies [5cea435]
+  - @haneullabs/haneul@1.27.1
+
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies [4d13ef8]
+- Updated dependencies [4d13ef8]
+  - @haneullabs/haneul@1.27.0
+
+## 0.1.3
+
+### Patch Changes
+
+- 7ba32a4: update dependencies
+- Updated dependencies [7ba32a4]
+  - @haneullabs/haneul@1.26.1
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [906dd14]
+  - @haneullabs/haneul@1.26.0
+
+## 0.1.1
+
+### Patch Changes
+
+- ddcbc1a: Introduces mvr-static package

package/README.md

@@ -0,0 +1,49 @@
+# mvr-static
+
+The mvr-static tool is a typescript CLI tool to generate a static file for Move Registry (mvr)
+resolution. This can be used to cache all MVR names for performance & security reasons, and used in
+the `NamedPackagesPlugin` (exported from `@haneullabs/haneul`) in your project.
+
+## Usage
+
+### Generate a static file for MVR resolution
+
+You can generate your static file by running the following command:
+
+```bash
+pnpm dlx @haneullabs/mvr-static
+```
+
+Available options:
+
+- `--directory <directory>`: The directory to run the command in (defaults to `.`)
+- `--output <file-name>`: The output's file name (defaults to `mvr.ts`)
+- `--depth <depth>`: The depth of recursive search for MVR names (defaults to `10`)
+- `--url-mainnet <url>`: The URL to the mainnet MVR (defaults to
+  `https://mainnet.mvr.haneullabs.com`)
+- `--url-testnet <url>`: The URL to the testnet MVR (defaults to
+  `https://testnet.mvr.haneullabs.com`)
+- `--include <dir_patterns>`: The directory patterns to include in the search (defaults to
+  `**/*.{js,ts,jsx,tsx,mjs,cjs}`)
+- `--exclude <dir_patterns>`: The directory patterns to exclude in the search (defaults to
+  `'node_modules/**', '**/.*'`)
+- `--force`: Force overwrite the existing MVR file (useful in CI) (defaults to `false`)
+
+### Use the static file in your project
+
+Once you have your static file, you can use it in your project by importing it and passing it to the
+`NamedPackagesPlugin` in your project.
+
+```ts
+import { NamedPackagesPlugin } from '@haneullabs/haneul/src/transactions';
+
+import { getMvrCache } from './mvr.ts';
+
+// create a cache for your network.
+const cache = getMvrCache('mainnet');
+
+const plugin = new NamedPackagesPlugin({
+	// ...,
+	overrides: cache,
+});
+```

package/bin/parser.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+require('../dist/execute.js');

package/dist/execute.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/execute.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+const parsing_js_1 = require("./parsing.js");
+(0, parsing_js_1.parser)();
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":";;AAAA,kCAAkC;AAClC,sCAAsC;AACtC,6CAAsC;AAEtC,IAAA,mBAAM,GAAE,CAAC"}

package/dist/parsing.d.ts

@@ -0,0 +1,23 @@
+export declare function parser(): Promise<undefined>;
+export declare function crossNetworkResolution(detectedNames: Set<string>): Promise<{
+    mainnet: {
+        packages: Record<string, string>;
+        types: Record<string, string>;
+    };
+    testnet: {
+        packages: Record<string, string>;
+        types: Record<string, string>;
+    };
+}>;
+/**
+ * Finds all the MVR names in the given directory.
+ * @param directory - The directory to search for MVR names.
+ * @returns A set of all the MVR names found in the directory.
+ */
+export declare function findNames({ directory, include, exclude, depth, output, }: {
+    directory?: string;
+    include?: string[];
+    exclude?: string[];
+    depth?: number;
+    output?: string;
+}): Promise<Set<string>>;

package/dist/parsing.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parser = parser;
+exports.crossNetworkResolution = crossNetworkResolution;
+exports.findNames = findNames;
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const util_1 = require("util");
+const utils_1 = require("@haneullabs/haneul/utils");
+const enquirer_1 = require("enquirer");
+const glob_1 = require("glob");
+const prettier_1 = require("prettier");
+const TYPES_AND_TARGET_MATCHES = /[@a-zA-Z0-9/.-]+::[a-zA-Z0-9_]+::[a-zA-Z0-9_]+/g;
+const MVR_NAME_MATCHES = /[@a-zA-Z0-9/.-]+::/g;
+const DEFAULT_INCLUDE_PATTERNS = ['**/*.{js,ts,jsx,tsx,mjs,cjs}'];
+const DEFAULT_EXCLUDE_PATTERNS = ['node_modules/**', '**/.*'];
+const DEFAULT_FILE_NAME = `mvr.ts`;
+const MAX_BATCH_SIZE = 25; // files to process per batch.
+const MAINNET_API_URL = 'https://mainnet.mvr.haneullabs.com';
+const TESTNET_API_URL = 'https://testnet.mvr.haneullabs.com';
+const WARNING_MESSAGE = `/**
+ * This file is automatically generated by the mvr SDK.
+ * You can edit this file, but it will be overwritten on the next run.
+ * You should check this file in your version control system.
+ *
+ * Run this script before building your project to ensure that the mvr.ts file stays up to date.
+ *
+ * You can use this pre-built cache when initializing your "NamedPackagesPlugin" by calling
+ * \`getMvrCache("mainnet")\` or \`getMvrCache("testnet")\`
+ */
+`;
+const { values: args } = (0, util_1.parseArgs)({
+    options: {
+        directory: {
+            type: 'string',
+            default: '.',
+            short: 'd',
+        },
+        output: {
+            type: 'string',
+            default: DEFAULT_FILE_NAME,
+            short: 'o',
+        },
+        depth: {
+            type: 'string',
+            default: '10',
+            short: 'd',
+        },
+        'url-mainnet': {
+            type: 'string',
+            default: MAINNET_API_URL,
+        },
+        'url-testnet': {
+            type: 'string',
+            default: TESTNET_API_URL,
+        },
+        include: {
+            type: 'string',
+            multiple: true,
+            default: DEFAULT_INCLUDE_PATTERNS,
+            short: 'i',
+        },
+        exclude: {
+            type: 'string',
+            multiple: true,
+            default: DEFAULT_EXCLUDE_PATTERNS,
+            short: 'e',
+        },
+        force: {
+            type: 'boolean',
+            default: false,
+            short: 'f',
+        },
+    },
+});
+async function parser() {
+    const path = (0, path_1.isAbsolute)(args.output) ? args.output : (0, path_1.join)(process.cwd(), args.output);
+    const dir = (0, path_1.dirname)(path);
+    if (!(0, fs_1.existsSync)(dir))
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    if (!isSupportedFile(path))
+        throw new Error(`Unsupported file type: ${path}. Please use a .ts (or equivalent) file name for the output.`);
+    if ((0, fs_1.existsSync)(path) && !args.force) {
+        const { overwrite } = (await (0, enquirer_1.prompt)({
+            type: 'confirm',
+            name: 'overwrite',
+            message: `The file ${path} already exists. Do you want to overwrite it?`,
+        }));
+        console.log(`Skipping generation of MVR file.`);
+        if (!overwrite)
+            return process.exit(1);
+    }
+    console.log(`Generating ${args.output}...`);
+    const detectedNames = await findNames({});
+    const { mainnet, testnet } = await crossNetworkResolution(detectedNames);
+    await writeOutputFile(path, mainnet, testnet);
+}
+async function writeOutputFile(outDir, mainnet, testnet) {
+    const outputFile = `${WARNING_MESSAGE}
+const mainnetResolution = ${JSON.stringify(mainnet, null, 2)}
+const testnetResolution = ${JSON.stringify(testnet, null, 2)}
+
+export function getMvrCache(network: 'mainnet' | 'testnet') {
+	return network === 'mainnet' ? mainnetResolution : testnetResolution;
+}\n
+`;
+    (0, fs_1.writeFileSync)(outDir, await (0, prettier_1.format)(outputFile, { parser: 'typescript' }), 'utf8');
+}
+async function crossNetworkResolution(detectedNames) {
+    const packages = Array.from(detectedNames).filter((x) => !x.includes('::'));
+    const types = Array.from(detectedNames).filter((x) => x.includes('::'));
+    const [mainnetPackages, mainnetTypes, testnetPackages, testnetTypes] = await Promise.all([
+        resolvePackages(packages, args['url-mainnet']),
+        resolveTypes(types, args['url-mainnet']),
+        resolvePackages(packages, args['url-testnet']),
+        resolveTypes(types, args['url-testnet']),
+    ]);
+    return {
+        mainnet: {
+            packages: mainnetPackages,
+            types: mainnetTypes,
+        },
+        testnet: {
+            packages: testnetPackages,
+            types: testnetTypes,
+        },
+    };
+}
+async function resolvePackages(packages, apiUrl) {
+    const batches = batch(packages, 50);
+    const results = {};
+    await Promise.all(batches.map(async (batch) => {
+        const response = await fetch(`${apiUrl}/v1/resolution/bulk`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                names: batch,
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.json().catch(() => ({}));
+            throw new Error(`Failed to resolve packages: ${errorBody?.message}`);
+        }
+        const data = await response.json();
+        if (!data?.resolution)
+            return;
+        for (const pkg of Object.keys(data?.resolution)) {
+            const pkgData = data.resolution[pkg]?.package_id;
+            if (!pkgData)
+                continue;
+            results[pkg] = pkgData;
+        }
+    }));
+    return results;
+}
+// TODO: Switch to `/struct-definition/bulk` endpoint when released,
+// as this endpoint will be the right one for "non-nested" struct resolution.
+// The current endpoint will fail with "generic" parameter lookups (which are not existent)
+// on this parser.
+async function resolveTypes(types, apiUrl) {
+    const batches = batch(types, 50);
+    const results = {};
+    await Promise.all(batches.map(async (batch) => {
+        const response = await fetch(`${apiUrl}/v1/struct-definition/bulk`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                types: batch,
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.json().catch(() => ({}));
+            throw new Error(`Failed to resolve types: ${errorBody?.message}`);
+        }
+        const data = await response.json();
+        if (!data?.resolution)
+            return;
+        for (const type of Object.keys(data?.resolution)) {
+            const typeData = data.resolution[type]?.type_tag;
+            if (!typeData)
+                continue;
+            results[type] = typeData;
+        }
+    }));
+    return results;
+}
+/**
+ * Finds all the MVR names in the given directory.
+ * @param directory - The directory to search for MVR names.
+ * @returns A set of all the MVR names found in the directory.
+ */
+async function findNames({ directory = args.directory, include = args.include, exclude = args.exclude, depth = parseInt(args.depth), output = args.output, }) {
+    const detectedNames = new Set();
+    const excluded = [...exclude, output];
+    const files = glob_1.glob.sync(include, {
+        ignore: excluded,
+        cwd: directory,
+        maxDepth: depth,
+        absolute: true,
+    });
+    // We batch the files to avoid trying to open too many files at once.
+    const batches = batch(files);
+    for (const batch of batches) {
+        await processFilesBatch(batch, detectedNames);
+    }
+    return detectedNames;
+}
+/**
+ * Finds all the MVR names in the given files.
+ */
+async function processFilesBatch(files, detectedNames) {
+    await Promise.all(files.map(async (file) => {
+        const content = await (0, promises_1.readFile)(file, 'utf8');
+        extractMvrNames(content).forEach((name) => detectedNames.add(name));
+    }));
+}
+/**
+ * Extracts all the MVR names from the given file's data (content).
+ */
+function extractMvrNames(content) {
+    const relevantNames = new Set();
+    // find all "fully qualified" matches.
+    const fullQualifiedMatches = [...content.matchAll(TYPES_AND_TARGET_MATCHES)];
+    fullQualifiedMatches.forEach((match) => {
+        const [pkg] = match[0].split('::');
+        if (!(0, utils_1.isValidNamedPackage)(pkg))
+            return;
+        relevantNames.add(match[0]);
+    });
+    // find all "plain" name matches
+    const plainNameMatches = [...content.matchAll(MVR_NAME_MATCHES)];
+    plainNameMatches.forEach((match) => {
+        const [pkg] = match[0].split('::');
+        if (!(0, utils_1.isValidNamedPackage)(pkg))
+            return;
+        relevantNames.add(pkg);
+    });
+    return relevantNames;
+}
+/**
+ * Batch the given array into smaller arrays of the given size.
+ */
+function batch(array, batchSize = MAX_BATCH_SIZE) {
+    const result = [];
+    for (let i = 0; i < array.length; i += batchSize) {
+        result.push(array.slice(i, i + batchSize)); // Create batches
+    }
+    return result;
+}
+function isSupportedFile(filePath) {
+    const ext = (0, path_1.extname)(filePath).toLowerCase();
+    return ['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts'].includes(ext);
+}
+//# sourceMappingURL=parsing.js.map

package/dist/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../src/parsing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@haneullabs/mvr-static",
+  "author": "Haneul Labs <build@haneullabs.com>",
+  "description": "The static generation tool for Move Registry (mvr)",
+  "homepage": "https://sdk.haneullabs.com",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "dist",
+    "src"
+  ],
+  "type": "commonjs",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GeunhwaJeong/haneul-ts-sdks.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MystenLabs/mvr/issues/new"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15",
+    "@haneullabs/build-scripts": "0.1.0"
+  },
+  "dependencies": {
+    "@types/node": "^24.10.1",
+    "enquirer": "^2.4.1",
+    "glob": "^13.0.0",
+    "prettier": "^3.7.3",
+    "@haneullabs/haneul": "0.1.0"
+  },
+  "sideEffects": false,
+  "bin": "./bin/parser.js",
+  "scripts": {
+    "clean": "rm -rf tsconfig.tsbuildinfo ./dist",
+    "build": "tsc --build",
+    "prettier:check": "prettier -c --ignore-unknown .",
+    "prettier:fix": "prettier -w --ignore-unknown .",
+    "eslint:check": "eslint --max-warnings=0 .",
+    "eslint:fix": "pnpm run eslint:check --fix",
+    "lint": "pnpm run eslint:check && pnpm run prettier:check",
+    "lint:fix": "pnpm run eslint:fix && pnpm run prettier:fix",
+    "test": "vitest run"
+  }
+}

package/src/execute.ts

@@ -0,0 +1,5 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { parser } from './parsing.js';
+
+parser();

package/src/parsing.ts

@@ -0,0 +1,320 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { readFile } from 'fs/promises';
+import { dirname, extname, isAbsolute, join } from 'path';
+import { parseArgs } from 'util';
+import type { NamedPackagesOverrides } from '@haneullabs/haneul/src/transactions';
+import { isValidNamedPackage } from '@haneullabs/haneul/utils';
+import { prompt } from 'enquirer';
+import { glob } from 'glob';
+import { format } from 'prettier';
+
+const TYPES_AND_TARGET_MATCHES = /[@a-zA-Z0-9/.-]+::[a-zA-Z0-9_]+::[a-zA-Z0-9_]+/g;
+const MVR_NAME_MATCHES = /[@a-zA-Z0-9/.-]+::/g;
+
+const DEFAULT_INCLUDE_PATTERNS = ['**/*.{js,ts,jsx,tsx,mjs,cjs}'];
+const DEFAULT_EXCLUDE_PATTERNS = ['node_modules/**', '**/.*'];
+const DEFAULT_FILE_NAME = `mvr.ts`;
+
+const MAX_BATCH_SIZE = 25; // files to process per batch.
+const MAINNET_API_URL = 'https://mainnet.mvr.haneullabs.com';
+const TESTNET_API_URL = 'https://testnet.mvr.haneullabs.com';
+
+const WARNING_MESSAGE = `/**
+ * This file is automatically generated by the mvr SDK.
+ * You can edit this file, but it will be overwritten on the next run.
+ * You should check this file in your version control system.
+ *
+ * Run this script before building your project to ensure that the mvr.ts file stays up to date.
+ *
+ * You can use this pre-built cache when initializing your "NamedPackagesPlugin" by calling
+ * \`getMvrCache("mainnet")\` or \`getMvrCache("testnet")\`
+ */
+`;
+
+const { values: args } = parseArgs({
+	options: {
+		directory: {
+			type: 'string',
+			default: '.',
+			short: 'd',
+		},
+		output: {
+			type: 'string',
+			default: DEFAULT_FILE_NAME,
+			short: 'o',
+		},
+		depth: {
+			type: 'string',
+			default: '10',
+			short: 'd',
+		},
+		'url-mainnet': {
+			type: 'string',
+			default: MAINNET_API_URL,
+		},
+		'url-testnet': {
+			type: 'string',
+			default: TESTNET_API_URL,
+		},
+		include: {
+			type: 'string',
+			multiple: true,
+			default: DEFAULT_INCLUDE_PATTERNS,
+			short: 'i',
+		},
+		exclude: {
+			type: 'string',
+			multiple: true,
+			default: DEFAULT_EXCLUDE_PATTERNS,
+			short: 'e',
+		},
+		force: {
+			type: 'boolean',
+			default: false,
+			short: 'f',
+		},
+	},
+});
+
+export async function parser() {
+	const path = isAbsolute(args.output) ? args.output : join(process.cwd(), args.output);
+	const dir = dirname(path);
+
+	if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+
+	if (!isSupportedFile(path))
+		throw new Error(
+			`Unsupported file type: ${path}. Please use a .ts (or equivalent) file name for the output.`,
+		);
+
+	if (existsSync(path) && !args.force) {
+		const { overwrite } = (await prompt({
+			type: 'confirm',
+			name: 'overwrite',
+			message: `The file ${path} already exists. Do you want to overwrite it?`,
+		})) as { overwrite: boolean };
+
+		console.log(`Skipping generation of MVR file.`);
+		if (!overwrite) return process.exit(1);
+	}
+
+	console.log(`Generating ${args.output}...`);
+
+	const detectedNames = await findNames({});
+
+	const { mainnet, testnet } = await crossNetworkResolution(detectedNames);
+
+	await writeOutputFile(path, mainnet, testnet);
+}
+
+async function writeOutputFile(
+	outDir: string,
+	mainnet: NamedPackagesOverrides,
+	testnet: NamedPackagesOverrides,
+) {
+	const outputFile = `${WARNING_MESSAGE}
+const mainnetResolution = ${JSON.stringify(mainnet, null, 2)}
+const testnetResolution = ${JSON.stringify(testnet, null, 2)}
+
+export function getMvrCache(network: 'mainnet' | 'testnet') {
+	return network === 'mainnet' ? mainnetResolution : testnetResolution;
+}\n
+`;
+
+	writeFileSync(outDir, await format(outputFile, { parser: 'typescript' }), 'utf8');
+}
+
+export async function crossNetworkResolution(detectedNames: Set<string>) {
+	const packages = Array.from(detectedNames).filter((x) => !x.includes('::'));
+	const types = Array.from(detectedNames).filter((x) => x.includes('::'));
+
+	const [mainnetPackages, mainnetTypes, testnetPackages, testnetTypes] = await Promise.all([
+		resolvePackages(packages, args['url-mainnet']),
+		resolveTypes(types, args['url-mainnet']),
+		resolvePackages(packages, args['url-testnet']),
+		resolveTypes(types, args['url-testnet']),
+	]);
+
+	return {
+		mainnet: {
+			packages: mainnetPackages,
+			types: mainnetTypes,
+		},
+		testnet: {
+			packages: testnetPackages,
+			types: testnetTypes,
+		},
+	};
+}
+
+async function resolvePackages(packages: string[], apiUrl: string) {
+	const batches = batch(packages, 50);
+
+	const results: Record<string, string> = {};
+
+	await Promise.all(
+		batches.map(async (batch) => {
+			const response = await fetch(`${apiUrl}/v1/resolution/bulk`, {
+				method: 'POST',
+				headers: { 'Content-Type': 'application/json' },
+				body: JSON.stringify({
+					names: batch,
+				}),
+			});
+
+			if (!response.ok) {
+				const errorBody = await response.json().catch(() => ({}));
+				throw new Error(`Failed to resolve packages: ${errorBody?.message}`);
+			}
+
+			const data = await response.json();
+
+			if (!data?.resolution) return;
+
+			for (const pkg of Object.keys(data?.resolution)) {
+				const pkgData = data.resolution[pkg]?.package_id;
+
+				if (!pkgData) continue;
+
+				results[pkg] = pkgData;
+			}
+		}),
+	);
+
+	return results;
+}
+
+// TODO: Switch to `/struct-definition/bulk` endpoint when released,
+// as this endpoint will be the right one for "non-nested" struct resolution.
+// The current endpoint will fail with "generic" parameter lookups (which are not existent)
+// on this parser.
+async function resolveTypes(types: string[], apiUrl: string) {
+	const batches = batch(types, 50);
+
+	const results: Record<string, string> = {};
+
+	await Promise.all(
+		batches.map(async (batch) => {
+			const response = await fetch(`${apiUrl}/v1/struct-definition/bulk`, {
+				method: 'POST',
+				headers: { 'Content-Type': 'application/json' },
+				body: JSON.stringify({
+					types: batch,
+				}),
+			});
+
+			if (!response.ok) {
+				const errorBody = await response.json().catch(() => ({}));
+				throw new Error(`Failed to resolve types: ${errorBody?.message}`);
+			}
+
+			const data = await response.json();
+
+			if (!data?.resolution) return;
+
+			for (const type of Object.keys(data?.resolution)) {
+				const typeData = data.resolution[type]?.type_tag;
+				if (!typeData) continue;
+
+				results[type] = typeData;
+			}
+		}),
+	);
+
+	return results;
+}
+
+/**
+ * Finds all the MVR names in the given directory.
+ * @param directory - The directory to search for MVR names.
+ * @returns A set of all the MVR names found in the directory.
+ */
+export async function findNames({
+	directory = args.directory,
+	include = args.include,
+	exclude = args.exclude,
+	depth = parseInt(args.depth),
+	output = args.output,
+}: {
+	directory?: string;
+	include?: string[];
+	exclude?: string[];
+	depth?: number;
+	output?: string;
+}) {
+	const detectedNames = new Set<string>();
+	const excluded = [...exclude, output];
+
+	const files = glob.sync(include, {
+		ignore: excluded,
+		cwd: directory,
+		maxDepth: depth,
+		absolute: true,
+	});
+
+	// We batch the files to avoid trying to open too many files at once.
+	const batches = batch(files);
+
+	for (const batch of batches) {
+		await processFilesBatch(batch, detectedNames);
+	}
+
+	return detectedNames;
+}
+
+/**
+ * Finds all the MVR names in the given files.
+ */
+async function processFilesBatch(files: string[], detectedNames: Set<string>) {
+	await Promise.all(
+		files.map(async (file) => {
+			const content = await readFile(file, 'utf8');
+			extractMvrNames(content).forEach((name) => detectedNames.add(name));
+		}),
+	);
+}
+
+/**
+ * Extracts all the MVR names from the given file's data (content).
+ */
+function extractMvrNames(content: string) {
+	const relevantNames = new Set<string>();
+	// find all "fully qualified" matches.
+	const fullQualifiedMatches = [...content.matchAll(TYPES_AND_TARGET_MATCHES)];
+	fullQualifiedMatches.forEach((match) => {
+		const [pkg] = match[0].split('::');
+
+		if (!isValidNamedPackage(pkg)) return;
+
+		relevantNames.add(match[0]);
+	});
+
+	// find all "plain" name matches
+	const plainNameMatches = [...content.matchAll(MVR_NAME_MATCHES)];
+	plainNameMatches.forEach((match) => {
+		const [pkg] = match[0].split('::');
+		if (!isValidNamedPackage(pkg)) return;
+
+		relevantNames.add(pkg);
+	});
+
+	return relevantNames;
+}
+
+/**
+ * Batch the given array into smaller arrays of the given size.
+ */
+function batch<T>(array: T[], batchSize: number = MAX_BATCH_SIZE) {
+	const result = [];
+	for (let i = 0; i < array.length; i += batchSize) {
+		result.push(array.slice(i, i + batchSize)); // Create batches
+	}
+	return result;
+}
+
+function isSupportedFile(filePath: string) {
+	const ext = extname(filePath).toLowerCase();
+	return ['.js', '.mjs', '.cjs', '.ts', '.mts', '.cts'].includes(ext);
+}