{"id":49961268,"url":"https://github.com/inkdropapp/ipm","last_synced_at":"2026-05-18T02:36:50.995Z","repository":{"id":338918154,"uuid":"1002773605","full_name":"inkdropapp/ipm","owner":"inkdropapp","description":"Inkdrop Package Manager","archived":false,"fork":false,"pushed_at":"2026-04-16T08:16:42.000Z","size":796,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-16T10:18:17.667Z","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/inkdropapp.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":"2025-06-16T05:56:43.000Z","updated_at":"2026-04-16T08:16:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/inkdropapp/ipm","commit_stats":null,"previous_names":["inkdropapp/ipm"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/inkdropapp/ipm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkdropapp%2Fipm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkdropapp%2Fipm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkdropapp%2Fipm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkdropapp%2Fipm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/inkdropapp","download_url":"https://codeload.github.com/inkdropapp/ipm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkdropapp%2Fipm/sbom","scorecard":{"id":1243495,"data":{"date":"2026-02-09","repo":{"name":"github.com/inkdropapp/ipm","commit":"cba44d982b77cc80785749e89c025557a5ac341e"},"scorecard":{"version":"v5.4.1-0.20260206175703-df89a3b9cb68","commit":"df89a3b9cb6803defde213724d1c3ba49b25d662"},"score":3.8,"checks":[{"name":"Maintained","score":10,"reason":"25 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 0/10 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":4,"reason":"dependency not pinned by hash detected -- score normalized to 4","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/claude-code-review.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/claude-code-review.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/claude-code-review.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/claude-code-review.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/claude.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/claude.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/claude.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/inkdropapp/ipm/claude.yml/main?enable=pin","Info:   0 out of   6 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   2 out of   2 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/claude-code-review.yml:23","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/claude-code-review.yml:24","Info: jobLevel 'issues' permission set to 'read': .github/workflows/claude-code-review.yml:25","Info: jobLevel 'actions' permission set to 'read': .github/workflows/claude.yml:26","Info: jobLevel 'contents' permission set to 'read': .github/workflows/claude.yml:22","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/claude.yml:23","Info: jobLevel 'issues' permission set to 'read': .github/workflows/claude.yml:24","Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Warn: no topLevel permission defined: .github/workflows/claude-code-review.yml:1","Warn: no topLevel permission defined: .github/workflows/claude.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#fuzzing"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":4,"reason":"6 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: https://osv.dev/GHSA-43fc-jf86-j433","Warn: Project is vulnerable to: https://osv.dev/GHSA-5j98-mcp5-4vw2","Warn: Project is vulnerable to: https://osv.dev/GHSA-mh29-5h37-fv8m","Warn: Project is vulnerable to: https://osv.dev/GHSA-34x7-hfp2-rc4v","Warn: Project is vulnerable to: https://osv.dev/GHSA-8qq5-rm4j-mr97","Warn: Project is vulnerable to: https://osv.dev/GHSA-r6q2-hw4h-h46w"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 22 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/df89a3b9cb6803defde213724d1c3ba49b25d662/docs/checks.md#sast"}}]},"last_synced_at":"2026-02-17T12:59:29.811Z","repository_id":338918154,"created_at":"2026-02-17T12:59:29.824Z","updated_at":"2026-02-17T12:59:29.824Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33162710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"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":"2026-05-18T02:36:50.474Z","updated_at":"2026-05-18T02:36:50.989Z","avatar_url":"https://github.com/inkdropapp.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IPM (Inkdrop Package Manager)\n\nThis is a utility module for managing Inkdrop packages and themes in the desktop app and other tools.\n\n## Install\n\n```sh\nnpm install @inkdropapp/ipm\n```\n\n## Usage\n\nImport:\n\n```ts\nimport { IPM } from '@inkdropapp/ipm'\n\nconst options = {\n  // options for IPM\n}\nconst ipm = new IPM(options)\n```\n\n### `getInstalled(): Promise\u003cPackageMetadata[]\u003e`\n\nList installed packages:\n\n```ts\nconst installedPackages = await ipm.getInstalled()\n```\n\n### `getOutdated(): Promise\u003cOutdatedPackageInfo[]\u003e`\n\nList outdated packages:\n\n```ts\nconst outdatedPackages = await ipm.getOutdated()\n```\n\n### `install(name: string, version?: string)`\n\n- `name`: Name of the package to install\n- `version`: Optional specific version to install. If not provided, it installs the latest version.\n\n````ts\n\nInstall package:\n\n```ts\nconst result = await ipm.install(package)\n````\n\n### `update(name: string, version?: string)`\n\n- `name`: Name of the package to update\n- `version`: Optional specific version to update to. If not provided, it updates to the latest version.\n\n````ts\n\nUpdate package:\n\n```ts\nconst result = await ipm.update('package-name')\n````\n\n### `link(packagePath: string, opts?: { dev?: boolean; name?: string }): Promise\u003cstring\u003e`\n\nCreate a symlink for a local package in the Inkdrop packages directory. Useful for plugin development.\n\n- `packagePath`: Path to the local package directory\n- `opts.dev`: If true, links to `dev/packages` instead of `packages`\n- `opts.name`: Override the package name (defaults to `name` from `package.json`, or the directory basename)\n\nReturns the created symlink path.\n\n```ts\n// Link to packages/\nawait ipm.link('./my-plugin')\n\n// Link to dev/packages/ for development\nawait ipm.link('./my-plugin', { dev: true })\n\n// Link with a custom name\nawait ipm.link('./my-plugin', { dev: true, name: 'custom-name' })\n```\n\n### `uninstall(name: string)`\n\nUninstall package:\n\n```ts\nawait ipm.uninstall('package-name')\n```\n\n### `publish(opts: { dryrun?: boolean; path?: string })`\n\nPublish a package to the registry. It will use `cwd` to locate the package to publish.\n\n- `dryrun`: If true, simulates the publish process without actually publishing. Default is `false`.\n- `path`: Path to the package directory. If not provided, it uses the current working directory.\n\n```ts\nawait ipm.publish({ dryrun: true, path: './my-package' })\n```\n\n### `unpublish(name: string, opts?: { version?: string })`\n\nUnpublish a package or specific version from the registry.\n\n- `name`: Name of the package to unpublish\n- `opts.version`: Optional specific version to unpublish. If not provided, unpublishes the entire package.\n\n```ts\n// Unpublish entire package\nawait ipm.unpublish('package-name')\n\n// Unpublish specific version\nawait ipm.unpublish('package-name', { version: '1.0.0' })\n```\n\n### `registry.getPackageInfo(name: string): Promise\u003cPackageInfo\u003e`\n\nGet a package from the registry:\n\n```ts\nconst packageInfo = await ipm.registry.getPackageInfo('package-name')\n```\n\n- `name`: The name of the package to get\n\n### `registry.getPackageVersionInfo(name: string, version: string): Promise\u003cPackageVersionInfo\u003e`\n\nGet information about a specific version of a package:\n\n```ts\nconst versionInfo = await ipm.registry.getPackageVersionInfo(\n  'package-name',\n  '1.0.0'\n)\n```\n\n- `name`: The name of the package\n- `version`: The specific version to get information for\n\n### `registry.search(params: { q: string, sort?: string, direction?: string }): Promise\u003cPackageInfo[]\u003e`\n\nSearch packages with keyword:\n\n```ts\nconst searchResults = await ipm.registry.search({ q: 'markdown' })\n```\n\n- `q`: Search query string\n- `sort`: Sort order ('score', 'majority', 'recency', 'newness', 'theme-majority', 'theme-recency', 'theme-newness')\n- `direction`: Sort direction ('desc' or 'asc')\n\n### `registry.getPackages(opts?: { sort: string, page: number, theme: boolean }): Promise\u003cPackageInfo[]\u003e`\n\nGet packages from the registry:\n\n```ts\nconst packages = await ipm.registry.getPackages({ sort: 'recency', page: 0 })\n```\n\n- `sort`: Sort order ('majority', 'recency', 'newness', 'theme-majority', 'theme-recency', 'theme-newness')\n- `page`: Page number for pagination\n- `theme`: Whether to filter for themes only\n\n## Development\n\n### Prerequisites\n\n- Node.js 20.x or higher\n- npm\n\n### Setup\n\n```sh\nnpm install\n```\n\n### Scripts\n\n- `npm test` - Run tests\n- `npm run test:watch` - Run tests in watch mode\n- `npm run lint` - Run ESLint\n- `npm run lint:fix` - Run ESLint with auto-fix\n- `npm run typecheck` - Run TypeScript type checking\n\n### CI/CD\n\nThis project uses GitHub Actions for continuous integration. The CI pipeline runs:\n\n- Tests on Node.js 18.x, 20.x, and 22.x\n- Cross-platform testing (Ubuntu, Windows, macOS)\n- Linting with ESLint\n- Type checking with TypeScript\n\nAll pull requests must pass CI checks before merging.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finkdropapp%2Fipm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finkdropapp%2Fipm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finkdropapp%2Fipm/lists"}