mlallai / lens-sdk Goto Github PK

The official SDK for the Lens Protocol 🌿.

• Documentation
• Road Map
• Contributing
  • Setup
  • Running tests
  • Deduplicating dependencies
• Releasing new version
• License
• Support

All Lens Protocol documentation, including this SDK documentation can be found at: https://docs.lens.xyz/docs

• Introduction
• Getting Started

• Release 0.5.0: Low-level API abstraction client.
• Release 0.6.0: integration with Lens Gated SDK.
• Release 1.0.0: initial stable release.
• Release 1.x.0: support for Data Availability posts.

Note: This road map is subject to change and is provided for informational purposes only.

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change (issues template will be provided)

Install monorepo dependencies by running this command in the root of the project:

pnpm install

Still in the root of the project, run the following command to build the packages:

pnpm build

To run the tests for all packages, run the following command in the repo root:

pnpm test

Release flow is managed by changesets.

All publishable monorepo packages follow fixed versioning scheme to keep things simple.

To release a new version follow the steps below:

1. Document new public facing changes during development.

pnpm changeset add

The command will ask a series of questions related to the introduced changes and the version bump that's required to follow semver range.

2. Once ready to do a release make sure that all libs are properly built (dist folders have the most up-to-date code) and the tests/lints are passing.

## run all from monorepo root
pnpm build

pnpm test

pnpm lint

3. Update relevant package.json's versions and update CHANGELOG.md for each package.

pnpm changeset version

4. Review and commit new release. Create a PR to main.

5. Once all the steps above are done we are ready to publish a new release to the registry

Note: Before publishing make sure that you are logged in to the correct npm account (run pnpm whoami). If not, follow prompts from pnpm login.

pnpm changeset publish

Note: Because this command assumes that the last commit is the release commit, you should not commit any changes between calling version and publish.

6. Don't forget to push git tags after publishing to registry.

git push --follow-tags

7. It's important that the last commit, from which the release was made and the git tags are associated with, is correctly merged to the main branch. Use "Create a merge commit" option when merging the release branch to the main.

Lens SDK is MIT licensed

See the Lens API and SDK channel on our Discord