{"id":31718183,"url":"https://github.com/solid-contrib/vscode-extension-solidfs","last_synced_at":"2025-10-09T02:09:03.270Z","repository":{"id":258173731,"uuid":"556689449","full_name":"solid-contrib/vscode-extension-solidfs","owner":"solid-contrib","description":null,"archived":true,"fork":false,"pushed_at":"2025-09-23T07:07:22.000Z","size":10649,"stargazers_count":3,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-09T02:03:04.903Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solid-contrib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-10-24T10:23:18.000Z","updated_at":"2025-09-23T08:49:21.000Z","dependencies_parsed_at":"2025-02-23T15:25:07.148Z","dependency_job_id":"a01c6394-8092-4a99-b024-0869bcb64e09","html_url":"https://github.com/solid-contrib/vscode-extension-solidfs","commit_stats":null,"previous_names":["jeswr/vscode-extension-solidfs","solid/vscode-extension-solidfs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/solid-contrib/vscode-extension-solidfs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solid-contrib%2Fvscode-extension-solidfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solid-contrib%2Fvscode-extension-solidfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solid-contrib%2Fvscode-extension-solidfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solid-contrib%2Fvscode-extension-solidfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solid-contrib","download_url":"https://codeload.github.com/solid-contrib/vscode-extension-solidfs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solid-contrib%2Fvscode-extension-solidfs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000774,"owners_count":26082906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-09T02:02:24.637Z","updated_at":"2025-10-09T02:09:03.261Z","avatar_url":"https://github.com/solid-contrib.png","language":"TypeScript","readme":"# Solid vscode extensions\n\nThis repo contains the source code for vscode extensions to aid in the development of applications in Solid. Currently, the following extensions are provided:\n\n1. `solidAuth` - implements the vscode `AuthenticationProvider` API to provide access to Solid authentication sessions in other vscode extensions.\n2. `solidFs` - view the filesytem view of Solid.\n\n## Developing the Extensions\n\nTo begin developing in this repository run\n\n```\n# Install dependencies\n# Note that the authn packages are patched using `authn.sh` in a postinstall step\nnpm i\n```\n\nthen from the root use the hotkey `fn`+`f5` to launch the extension development host; this invokes the launch configuration in the root of the project that will build and launch `solidAuth` and `solidFS` together in an [Extension Development Host](https://code.visualstudio.com/api/advanced-topics/extension-host) with a [Temporary Profile](https://code.visualstudio.com/updates/v1_72#_extension-debugging-in-a-clean-environment).\n\n\u003c!-- (what follows is the required steps before we had a good launch config)\n## Setup\n\n```shell\n# Install packages\nnpm install\n\n# Build the local packages\nnpm run build\n\n# Build the extensions\nnpm run package\n\n# Link solidauth to any other extensions that\n# require it in their environment (such as solidfs)\nnpm run solidauth:install\n```\n\n_Note_ If you make changes to `solidauth` and want to test the changes in another package make sure to re-run\n\n```shell\nnpm run package\nnpm run solidauth:install\n```\n\n## Testing an extension\n\nTo test an extension, open the folder for the extension in vscode (e.g. by running `code ./extensions/solidfs`) and\nthen run `fn`+`F5` to open the extension development environment.\n\n## SolidFS Quickstart\n\nTo quickly get started testing the solidfs extension run the following commands:\n\n```shell\ngh repo clone jeswr/vscode-extension-solidfs\ncd ./vscode-extension-solidfs\nnpm install\nnpm run build\nnpm run package\nnpm run solidauth:install\ncode ./extensions/solidfs/\n```\n\nand then press `fn`+`F5` in the new vscode window that is opened.\n\n_or_\n\n```shell\ngh repo clone jeswr/vscode-extension-solidfs\ncd ./vscode-extension-solidfs\nnpm run predev:solidfs\n```\n\nand then press `fn`+`F5` in the new vscode window that is opened.\n\n## Additional (temporary) development workaround\n\nBecause the [`--extensions-dir` option to code cli is ignored in ^1.74.0 of vscode](https://github.com/microsoft/vscode/issues/169035) the `solidauth:install` command does not work as expected; and so solidfs development will not work without *globally* installing the `solidauth` extension. If you need to do this run the following from the project root\n\n```\nnpm run solidauth:global:install\n```\n\nto install the `solidauth` package after running the above commands. Note - this *will* override your installation of `solidauth` from the vscode marketplace if you have one.\n\nTo cleanup after development, run\n\n```\nnpm run solidauth:global:uninstall\n```\n\n__Though unlikely it may be that this was part of [an intentional change in vscode behaviour](https://github.com/microsoft/vscode/issues/166147#issuecomment-1313717266).__ If this is the case we will need to update our test launch configuration files to account for this.\n\n## authn dependencies\n\nWe have had to customise the authentication libraries to handle session management in vscode. The following 2 files\nhave been modified compared to the source code for the authn libraries\n\ncore/src/authenticatedFetch/fetchFactory - removed token refreshing functionality\nnode/src/login/oidc/incomingRedirectHandler/AuthCodeRedirectHandler -\nensure refresh token and access_token are saved to storage\n\nIn each case comments starting with \"===\" have been added to indicate where the files deviate from the original authn\nlibraries\n--\u003e\n\n## Installation warning\n\n_Note_ there is the following deprecation warning when installing the extension in the command line\n\n```bash\n(node:57198) [DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues. Please use the Buffer.alloc(), Buffer.allocUnsafe(), or Buffer.from() methods instead.\n```\n\nIt occurs due to the use of `cross-fetch` in a nested dependency which uses a deprecated version of `node-fetch` and in turn `whatwg-url`.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolid-contrib%2Fvscode-extension-solidfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolid-contrib%2Fvscode-extension-solidfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolid-contrib%2Fvscode-extension-solidfs/lists"}