@tarout/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Tarout
+
+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,295 @@
+# Tarout CLI
+
+[![npm version](https://img.shields.io/npm/v/@tarout/cli.svg)](https://www.npmjs.com/package/@tarout/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+The official command-line interface for [Tarout](https://tarout.sa) - a Platform-as-a-Service for deploying applications, databases, and more.
+
+## Installation
+
+```bash
+npm install -g @tarout/cli
+```
+
+Or with other package managers:
+
+```bash
+# Using yarn
+yarn global add @tarout/cli
+
+# Using pnpm
+pnpm add -g @tarout/cli
+
+# Using bun
+bun add -g @tarout/cli
+```
+
+## Quick Start
+
+```bash
+# 1. Login via browser (opens authentication page)
+tarout login
+
+# 2. List your applications
+tarout apps list
+
+# 3. Deploy an application
+tarout deploy my-app
+
+# 4. View logs
+tarout logs my-app --follow
+```
+
+## Commands
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `tarout login` | Authenticate via browser |
+| `tarout logout` | Sign out and clear credentials |
+| `tarout whoami` | Show current user, organization, and environment |
+
+```bash
+# Login with custom API URL (for self-hosted)
+tarout login --api-url https://your-tarout-instance.com
+```
+
+### Applications
+
+| Command | Description |
+|---------|-------------|
+| `tarout apps list` | List all applications |
+| `tarout apps create <name>` | Create a new application |
+| `tarout apps delete <app>` | Delete an application |
+| `tarout apps info <app>` | Show application details |
+| `tarout apps open <app>` | Open application URL in browser |
+
+```bash
+# List apps as JSON
+tarout apps list --json
+
+# Create an app
+tarout apps create my-api
+
+# Delete without confirmation
+tarout apps delete my-api --yes
+```
+
+### Deployment
+
+| Command | Description |
+|---------|-------------|
+| `tarout deploy <app>` | Deploy an application |
+| `tarout deploy:status <app>` | Check deployment status |
+| `tarout deploy:cancel <app>` | Cancel running deployment |
+| `tarout deploy:list <app>` | List recent deployments |
+
+```bash
+# Deploy specific branch
+tarout deploy my-app --branch feature/new-feature
+
+# Deploy and wait for completion
+tarout deploy my-app --wait
+
+# Check deployment status
+tarout deploy:status my-app
+```
+
+### Logs
+
+| Command | Description |
+|---------|-------------|
+| `tarout logs <app>` | View application logs |
+
+```bash
+# Stream logs continuously
+tarout logs my-app --follow
+
+# Filter by log level
+tarout logs my-app --level error
+
+# Logs from last hour
+tarout logs my-app --since 1h
+
+# Last 100 lines
+tarout logs my-app --lines 100
+```
+
+### Environment Variables
+
+| Command | Description |
+|---------|-------------|
+| `tarout env <app> list` | List environment variables (masked) |
+| `tarout env <app> set <KEY=value>` | Set an environment variable |
+| `tarout env <app> unset <KEY>` | Remove an environment variable |
+| `tarout env <app> pull` | Download variables as .env file |
+| `tarout env <app> push` | Upload variables from .env file |
+
+```bash
+# Set a variable
+tarout env my-app set DATABASE_URL=postgres://...
+
+# Set multiple variables
+tarout env my-app set API_KEY=xxx SECRET=yyy
+
+# Download to .env file
+tarout env my-app pull
+
+# Upload from .env file
+tarout env my-app push
+```
+
+### Databases
+
+| Command | Description |
+|---------|-------------|
+| `tarout db list` | List all databases |
+| `tarout db create [name]` | Create a new database |
+| `tarout db delete <db>` | Delete a database |
+| `tarout db info <db>` | Show connection details |
+| `tarout db connect <db>` | Open database shell |
+
+```bash
+# Create PostgreSQL database
+tarout db create mydb --type postgres
+
+# Create MySQL database
+tarout db create mydb --type mysql
+
+# Create Redis instance
+tarout db create cache --type redis
+
+# Get connection string
+tarout db info mydb
+
+# Connect directly (opens psql/mysql client)
+tarout db connect mydb
+```
+
+### Domains
+
+| Command | Description |
+|---------|-------------|
+| `tarout domains list [app]` | List domains |
+| `tarout domains add <app> <domain>` | Add custom domain |
+| `tarout domains remove <domain>` | Remove domain |
+| `tarout domains verify <domain>` | Check DNS configuration |
+
+```bash
+# Add custom domain
+tarout domains add my-app api.example.com
+
+# Verify DNS is configured correctly
+tarout domains verify api.example.com
+```
+
+### Organizations & Environments
+
+| Command | Description |
+|---------|-------------|
+| `tarout orgs list` | List organizations |
+| `tarout orgs switch <org>` | Switch active organization |
+| `tarout envs list` | List environments |
+| `tarout envs switch <env>` | Switch environment (production/staging) |
+
+```bash
+# Switch organization
+tarout orgs switch "Acme Corp"
+
+# Switch to staging environment
+tarout envs switch staging
+```
+
+## Global Flags
+
+These flags work with all commands:
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output as JSON (machine-readable) |
+| `--yes, -y` | Skip all confirmation prompts |
+| `--quiet, -q` | Minimal output (errors only) |
+| `--verbose, -v` | Extra debug information |
+| `--no-color` | Disable colored output |
+
+## AI & Automation Usage
+
+The CLI is designed to be 100% AI-friendly and scriptable:
+
+```bash
+# Get JSON output for parsing
+tarout apps list --json
+
+# Non-interactive operations (no prompts)
+tarout apps delete my-app --yes
+
+# Quiet mode for scripts
+tarout deploy my-app --quiet
+
+# Pipe-friendly
+APP_ID=$(tarout apps list --json | jq -r '.[0].id')
+```
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Invalid arguments |
+| 3 | Authentication error (not logged in) |
+| 4 | Resource not found |
+| 5 | Permission denied |
+
+### JSON Output Format
+
+All `--json` output follows a consistent structure:
+
+```json
+// Success
+{ "success": true, "data": { ... } }
+
+// Error
+{ "success": false, "error": { "code": "NOT_FOUND", "message": "..." } }
+
+// List operations
+{ "success": true, "data": [...], "meta": { "total": 10 } }
+```
+
+## Configuration
+
+Configuration is stored at `~/.tarout/config.json`:
+
+```json
+{
+  "currentProfile": "default",
+  "profiles": {
+    "default": {
+      "token": "cli_xxx...",
+      "apiUrl": "https://app.tarout.sa",
+      "organizationId": "...",
+      "organizationName": "My Org",
+      "environmentId": "...",
+      "environmentName": "production",
+      "userId": "...",
+      "userEmail": "user@example.com"
+    }
+  }
+}
+```
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- A Tarout account ([sign up](https://tarout.sa))
+
+## Support
+
+- Documentation: [docs.tarout.sa](https://docs.tarout.sa)
+- Issues: [GitHub Issues](https://github.com/tarout/platform/issues)
+- Discord: [Join our community](https://discord.gg/2tBnJ3jDJc)
+
+## License
+
+MIT - see [LICENSE](./LICENSE) for details.

package/bin/tarout

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import('../dist/index.js');

package/dist/chunk-GSKD67K4.js

@@ -0,0 +1,41 @@
+// src/utils/spinner.ts
+import ora from "ora";
+var currentSpinner = null;
+function startSpinner(text) {
+  if (currentSpinner) {
+    currentSpinner.stop();
+  }
+  currentSpinner = ora(text).start();
+  return currentSpinner;
+}
+function succeedSpinner(text) {
+  if (currentSpinner) {
+    currentSpinner.succeed(text);
+    currentSpinner = null;
+  }
+}
+function failSpinner(text) {
+  if (currentSpinner) {
+    currentSpinner.fail(text);
+    currentSpinner = null;
+  }
+}
+function stopSpinner() {
+  if (currentSpinner) {
+    currentSpinner.stop();
+    currentSpinner = null;
+  }
+}
+function updateSpinner(text) {
+  if (currentSpinner) {
+    currentSpinner.text = text;
+  }
+}
+
+export {
+  startSpinner,
+  succeedSpinner,
+  failSpinner,
+  stopSpinner,
+  updateSpinner
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node