🔄 Migration Guide: Move to @engjts/auth

Janus Token System (JTS) is now available on the official NPM!

The @engjts/auth package has now been launched as an official package on the NPM Registry. We invite all users to migrate from local source code to the official NPM package to get the latest updates, bug fixes, and support.

📍 Official Package

The official @engjts/auth package is now available at:

🔗 https://www.npmjs.com/package/@engjts/auth

✅ Migration Steps

1️⃣ Uninstall Old Package

If you were previously using a package from a local source or an old version, uninstall it first:

npm uninstall jts-core
# or if there is another package name
npm uninstall @engjts/auth-local

2️⃣ Install the Official NPM Package

npm install @engjts/auth

3️⃣ Update Import Statements

Make sure all your imports use the official package from NPM:

Before (from local source):

import { JTSAuthServer, JTSResourceServer } from './path/to/local'
import { generateKeyPair } from '../src/crypto'

Now (from NPM):

import { JTSAuthServer, JTSResourceServer, generateKeyPair } from '@engjts/auth'

4️⃣ Install CLI Tools (Optional)

To use the CLI tools (jts keygen, jts verify, jts inspect, etc.), install them globally:

npm install -g @engjts/auth

Or use npx without a global install:

npx @engjts/auth jts --help

📚 Complete Documentation

The complete documentation includes:

• ✅ Step-by-step setup tutorial
• ✅ Code examples for various use cases
• ✅ Complete API reference
• ✅ Best practices security guide
• ✅ Storage adapters (In-Memory, Redis, PostgreSQL)
• ✅ CLI tools documentation
• ✅ Error handling guide
• ✅ Deployment guide

Visit the NPM package page for complete documentation:

🔗 https://www.npmjs.com/package/@engjts/auth

❓ FAQ

Q: What is JTS (Janus Token System)?

A: JTS is a secure and revocable two-component authentication system. It provides stateless verification with instant revocation and replay attack detection.

Q: Are there any breaking changes from the old version?

A: None. The API remains compatible. You just need to change the import statements to use the NPM package.

Q: What if I find a bug or issue?

A: Report the issue in the GitHub repository:

🔗 https://github.com/ukungzulfah/jts-core/issues

Q: Is there a version for other programming languages?

A: Currently JTS is available for Node.js/TypeScript. For other languages, please follow the project roadmap on GitHub.

🔗 Resources

• 📦 NPM Package: https://www.npmjs.com/package/@engjts/auth
• 📖 GitHub Repository: https://github.com/ukungzulfah/jts-core
• 📋 Changelog: CHANGELOG.md
• 📄 JTS Specification: JTS_Specification_v1-en.md
• ⚖️ License: LICENSE

🤝 Support

If you have difficulty migrating or have questions:

1. Check the documentation on NPM: https://www.npmjs.com/package/@engjts/auth
2. Open an issue on GitHub: https://github.com/ukungzulfah/jts-core/issues
3. Review the code examples in the examples/ folder

📜 License

MIT License - see LICENSE file for details.

Thank you for using Janus Token System (JTS)! 🎉

Migrate now to get access to the latest updates and official support.