Home

Awesome

scip-typescript

SCIP indexer for TypeScript and JavaScript.

Quick start

Installation

npm install -g @sourcegraph/scip-typescript

Currently, Node v18, Node v20 are supported. <!-- Source of truth: .github/workflows/ci.yml -->

Indexing a TypeScript project

Navigate to the project root, containing tsconfig.json.

npm install # or yarn install
scip-typescript index

Indexing a JavaScript project

Navigate to the project root, containing package.json.

npm install # or yarn install
scip-typescript index --infer-tsconfig

To improve the quality of indexing results for JavaScript, consider adding @types/* packages as devDependencies in package.json.

Index a TypeScript project using Yarn workspaces

Navigate to the project root, containing package.json.

yarn install

scip-typescript index --yarn-workspaces

Index a TypeScript project using pnpm workspaces

Navigate to the project root, containing package.json.

pnpm install

scip-typescript index --pnpm-workspaces

Indexing in CI

Add the following run steps to your CI pipeline:

npm install -g @sourcegraph/scip-typescript @sourcegraph/src
npm install # or yarn install
scip-typescript index
# Upload index with any necessary tokens (shown here using GitHub workflow syntax)
src lsif upload -github-token='${{ secrets.GITHUB_TOKEN }}' -no-progress

For more examples, see the Sourcegraph docs.

Troubleshooting stalled progress

If scip-typescript index is not showing progress, try running it again with the --progress-bar flag. The progress bar prints out the current file being indexed that could reveal details why progress is stalling. The progress bar is disabled by default because it prints out a lot of noise in CI logs, and the most common environment to run scip-typescript is in CI.

Dealing with out of memory issues (OOM)

You may experience OOM issues when indexing large codebases

<--- JS stacktrace --->

FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
 1: 0xb7b150 node::Abort() [node]
 2: 0xa8c89a  [node]
 3: 0xd62ea0 v8::Utils::ReportOOMFailure(v8::internal::Isolate*, char const*, bool) [node]
 4: 0xd63247 v8::internal::V8::FatalProcessOutOfMemory(v8::internal::Isolate*, char const*, bool) [node]
 5: 0xf40945  [node]
 6: 0xf52e2d v8::internal::Heap::CollectGarbage(v8::internal::AllocationSpace, v8::internal::GarbageCollectionReason, v8::GCCallbackFlags) [node]
 ...

To fix this problem, try one of the following steps:

Migrating from lsif-node

Before creating scip-typescript, we used another TypeScript indexer called lsif-node. We recommend migrating to scip-typescript if you are using lsif-node.

Follow the steps below to migrate from lsif-node to scip-typescript:

Contributing

See Development.md for docs on how to work on this project.

Contributors should follow the Sourcegraph Community Code of Conduct.