@babylonjsmarket/cli 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 BabylonJS Market
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# BJS CLI
+
+Official command-line interface for [BabylonJS Market](https://bjsmarket.com) - your gateway to 3D assets and educational content.
+
+## Features
+
+- **BBS-Style Interface**: Retro terminal UI for browsing courses and 3D assets
+- **OAuth Authentication**: Secure device flow authentication
+- **Asset Downloads**: Download 3D models, textures, and other assets
+- **Multiple Themes**: Classic green phosphor, desert amber, or Matrix-style themes
+- **Progress Tracking**: Real-time download progress with visual feedback
+- **Rate Limiting**: Automatic handling of API rate limits
+
+## Installation
+
+```bash
+npm install -g @babylonjsmarket/cli
+```
+
+Or using yarn:
+
+```bash
+yarn global add @babylonjsmarket/cli
+```
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- Terminal with UTF-8 support
+- Internet connection for authentication and downloads
+
+## Usage
+
+### Authentication
+
+Login to your BabylonJS Market account:
+
+```bash
+bjs login
+```
+
+Check your authentication status:
+
+```bash
+bjs whoami
+```
+
+Logout:
+
+```bash
+bjs logout
+```
+
+### BBS Interface
+
+Launch the retro BBS-style interface:
+
+```bash
+bjs bbs
+```
+
+#### BBS Options
+
+```bash
+# Set color theme
+bjs bbs --theme classic   # Green phosphor (default)
+bjs bbs --theme desert    # Amber/orange
+bjs bbs --theme matrix    # Matrix-style green
+
+# Disable animations
+bjs bbs --no-animations
+
+# Disable mouse support
+bjs bbs --no-mouse
+```
+
+#### BBS Navigation
+
+- **Arrow Keys**: Navigate lists
+- **Enter**: Select item
+- **ESC**: Go back
+- **C**: View courses
+- **T**: View toys (3D assets)
+- **S**: Settings
+- **D**: Download selected item
+- **M/Space**: Mark/unmark items
+- **B**: Open in browser
+- **Q**: Quit
+
+### Direct Downloads
+
+Download assets by ID:
+
+```bash
+bjs download <asset-id>
+```
+
+Specify output directory:
+
+```bash
+bjs download <asset-id> --output ./my-assets
+```
+
+## Configuration
+
+Configuration is stored in `~/.bjs/config.json` and includes:
+- Authentication tokens
+- User preferences
+- Theme settings
+- Animation settings
+
+## Rate Limiting
+
+The CLI respects API rate limits:
+- Downloads have a 30-second cooldown between requests
+- Rate limit messages display remaining wait time
+- Automatic retry suggestions for rate-limited requests
+
+## Troubleshooting
+
+### Authentication Issues
+
+If you encounter authentication problems:
+
+1. Try logging out and back in:
+   ```bash
+   bjs logout
+   bjs login
+   ```
+
+2. Check your internet connection
+
+3. Ensure your BabylonJS Market account is active
+
+### Download Issues
+
+If downloads fail:
+
+1. Verify you have access to the asset
+2. Check available disk space
+3. Wait for rate limit cooldown if applicable
+4. Try downloading again after 30 seconds
+
+### Terminal Display Issues
+
+If the BBS interface doesn't display correctly:
+
+1. Ensure your terminal supports UTF-8
+2. Try a different terminal emulator
+3. Disable animations: `bjs bbs --no-animations`
+4. Use a different theme: `bjs bbs --theme desert`
+
+## Environment Variables
+
+- `BJS_ENV`: Set to `development` to use dev API endpoints
+- `BJS_API_URL`: Override production API URL
+- `BJS_DEV_API_URL`: Override development API URL
+
+## Support
+
+- Website: [https://bjsmarket.com](https://bjsmarket.com)
+- Issues: [GitHub Issues](https://github.com/babylonjsmarket/cli/issues)
+- Documentation: [BabylonJS Market Docs](https://bjsmarket.com/docs)
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guide](https://github.com/babylonjsmarket/cli/blob/main/CONTRIBUTING.md) for details.
+
+## Credits
+
+Built with:
+- [Commander.js](https://github.com/tj/commander.js/) - CLI framework
+- [Terminal Kit](https://github.com/cronvel/terminal-kit) - Terminal manipulation
+- [Figlet](https://github.com/patorjk/figlet.js/) - ASCII art generation
+- [Chalk](https://github.com/chalk/chalk) - Terminal styling

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }