MCP TypeScript SDK (V2) / @modelcontextprotocol/codemod / utils/importUtils

utils/importUtils

Type Aliases

NamedImportSpec

NamedImportSpec = string | { alias?: string; name: string; }

Defined in: utils/importUtils.ts:56

A named import to emit: either a bare name, or a { name, alias } pair preserving an as alias.

Variables

MOCK_CALLERS

const MOCK_CALLERS: ReadonlySet<string>

Defined in: utils/importUtils.ts:36

---

MOCK_METHODS

const MOCK_METHODS: ReadonlySet<string>

Defined in: utils/importUtils.ts:25

Mock-framework methods whose first string argument is a module specifier. The single source of truth shared by the mock-paths transform (which rewrites these specifiers), the runner (which detects them), and the project analyzer (which counts them toward project-type inference) — keep the three consumers in sync by editing only this set.

Functions

addOrMergeImport()

addOrMergeImport(sourceFile, moduleSpecifier, namedImports, isTypeOnly, insertIndex, blankLineAbove?): boolean

Defined in: utils/importUtils.ts:68

Adds the names to an existing import of the module, or inserts a new import; returns true when it inserted one.

Parameters

sourceFile

SourceFile

moduleSpecifier

string

namedImports

NamedImportSpec[]

isTypeOnly

boolean

insertIndex

number

blankLineAbove?

boolean = false

Returns

boolean

---

getSdkExports()

getSdkExports(sourceFile): ExportDeclaration[]

Defined in: utils/importUtils.ts:44

Parameters

sourceFile

SourceFile

Returns

ExportDeclaration[]

---

getSdkImports()

getSdkImports(sourceFile): ImportDeclaration[]

Defined in: utils/importUtils.ts:38

Parameters

sourceFile

SourceFile

Returns

ImportDeclaration[]

---

hasMcpImports()

hasMcpImports(sourceFile): boolean

Defined in: utils/importUtils.ts:125

Parameters

sourceFile

SourceFile

Returns

boolean

---

isAnyMcpSpecifier()

isAnyMcpSpecifier(specifier): boolean

Defined in: utils/importUtils.ts:118

Parameters

specifier

string

Returns

boolean

---

isImportedFromMcp()

isImportedFromMcp(sourceFile, symbolName): boolean

Defined in: utils/importUtils.ts:129

Parameters

sourceFile

SourceFile

symbolName

string

Returns

boolean

---

isOriginalNameImportedFromMcp()

isOriginalNameImportedFromMcp(sourceFile, exportName): boolean

Defined in: utils/importUtils.ts:139

Parameters

sourceFile

SourceFile

exportName

string

Returns

boolean

---

isSdkSpecifier()

isSdkSpecifier(specifier): boolean

Defined in: utils/importUtils.ts:15

Parameters

specifier

string

Returns

boolean

---

isTypeOnlyImport()

isTypeOnlyImport(imp): boolean

Defined in: utils/importUtils.ts:51

Parameters

imp

ImportDeclaration

Returns

boolean

---

isV2Specifier()

isV2Specifier(specifier): boolean

Defined in: utils/importUtils.ts:112

True when the specifier resolves to one of the published v2 packages (root or subpath).

Parameters

specifier

string

Returns

boolean

---

removeUnusedImport()

removeUnusedImport(sourceFile, symbolName, onlyMcpImports?): void

Defined in: utils/importUtils.ts:169

Parameters

sourceFile

SourceFile

symbolName

string

onlyMcpImports?

boolean

Returns

void

---

resolveLocalImportName()

resolveLocalImportName(sourceFile, exportName): string | undefined

Defined in: utils/importUtils.ts:146

Parameters

sourceFile

SourceFile

exportName

string

Returns

string | undefined

---

resolveOriginalImportName()

resolveOriginalImportName(sourceFile, localName): string | undefined

Defined in: utils/importUtils.ts:158

Parameters

sourceFile

SourceFile

localName

string

Returns

string | undefined