@doswiftly/cli 0.1.1

package/README.md

@@ -0,0 +1,357 @@
+# @doswiftly/cli
+
+Official CLI for building e-commerce storefronts powered by DoSwiftly Commerce API.
+
+## Who is this for?
+
+This CLI is designed for **storefront developers** - developers building custom Next.js e-commerce applications using the DoSwiftly Commerce platform. If you're a merchant or business owner, you'll work with a developer who uses this tool.
+
+## Installation
+
+```bash
+# Install globally
+npm install -g @doswiftly/cli
+
+# Or use with npx (no installation needed)
+npx @doswiftly/cli init my-shop
+```
+
+## Quick Start
+
+```bash
+# 1. Create a new storefront project
+doswiftly init my-shop
+
+# 2. Navigate to project
+cd my-shop
+
+# 3. Configure environment (API URL, Shop credentials)
+doswiftly env add
+
+# 4. Login to DoSwiftly
+doswiftly auth login
+
+# 5. Verify connection to DoSwiftly Commerce API
+doswiftly verify
+
+# 6. Start development server
+doswiftly dev
+```
+
+Your storefront will be running at `http://localhost:3000` and connected to DoSwiftly Commerce API.
+
+## Commands
+
+### Essential Commands
+
+| Command                 | Description                            |
+| ----------------------- | -------------------------------------- |
+| `doswiftly init [name]` | Create a new storefront project        |
+| `doswiftly dev`         | Start development server               |
+| `doswiftly whoami`      | Show current user, project, and env    |
+| `doswiftly doctor`      | Check project health and configuration |
+| `doswiftly check`       | Run linting and type checking          |
+| `doswiftly update`      | Check for CLI updates                  |
+
+### Authentication
+
+| Command                 | Description                              |
+| ----------------------- | ---------------------------------------- |
+| `doswiftly auth login`  | Login to DoSwiftly (OAuth in browser)    |
+| `doswiftly auth logout` | Logout from DoSwiftly                    |
+| `doswiftly auth github` | Connect GitHub account via device flow   |
+| `doswiftly auth token`  | Generate a deploy token for CI/CD        |
+
+### Environment Management
+
+| Command                          | Description                                    |
+| -------------------------------- | ---------------------------------------------- |
+| `doswiftly env list`             | List all environment profiles                  |
+| `doswiftly env add [name]`       | Add new environment profile (dev/staging/prod) |
+| `doswiftly env use [name]`       | Switch active environment profile              |
+| `doswiftly env generate`         | Generate .env.local from active profile        |
+| `doswiftly env set <key> <value>`| Set a custom variable on active profile        |
+| `doswiftly env delete [name]`    | Delete environment profile                     |
+| `doswiftly verify`               | Verify API connectivity and credentials        |
+
+### Configuration
+
+| Command                               | Description                        |
+| ------------------------------------- | ---------------------------------- |
+| `doswiftly config pull`               | Refresh configuration from API     |
+| `doswiftly config show`               | Display current configuration      |
+| `doswiftly config domain add <host>`  | Add a custom domain to the shop    |
+| `doswiftly config domain remove <host>`| Remove a custom domain            |
+| `doswiftly config domain list`        | List all custom domains            |
+
+### Commerce SDK
+
+| Command                 | Description                            |
+| ----------------------- | -------------------------------------- |
+| `doswiftly sdk version` | Check Commerce SDK version and updates |
+
+The `@doswiftly/commerce-sdk` package is published on npm with all types included:
+
+```bash
+# Install SDK
+pnpm add @doswiftly/commerce-sdk
+
+# Update to latest
+pnpm update @doswiftly/commerce-sdk@latest
+```
+
+### Deployment
+
+| Command                          | Description                   |
+| -------------------------------- | ----------------------------- |
+| `doswiftly deploy run`           | Deploy storefront (default)   |
+| `doswiftly deploy status [id]`   | Check deployment status       |
+| `doswiftly deploy rollback [id]` | Rollback to previous version  |
+| `doswiftly deploy logs <id>`     | View deployment logs          |
+
+Deploy flags:
+
+```bash
+# Deploy to production (default)
+doswiftly deploy run
+
+# Deploy as staging
+doswiftly deploy run --type STAGING
+
+# Deploy specific branch
+doswiftly deploy run --branch feature/new-checkout
+
+# Deploy with message
+doswiftly deploy run --message "Release v2.0"
+```
+
+### Preview Environments
+
+| Command                       | Description                         |
+| ----------------------------- | ----------------------------------- |
+| `doswiftly preview create`    | Create preview deployment (default) |
+| `doswiftly preview list`      | List all preview deployments        |
+| `doswiftly preview stop <id>` | Stop preview deployment             |
+| `doswiftly preview logs <id>` | View preview build logs             |
+| `doswiftly preview open <id>` | Open preview URL in browser         |
+
+Preview flags:
+
+```bash
+# Create preview from current branch
+doswiftly preview create
+
+# Specific branch with custom TTL (default: 168h / 7 days)
+doswiftly preview create --branch feature/checkout --ttl 48
+```
+
+### Debugging & Development
+
+| Command                        | Description                                     |
+| ------------------------------ | ----------------------------------------------- |
+| `doswiftly inspect <endpoint>` | Test API endpoint (like curl for DoSwiftly API) |
+| `doswiftly proxy`              | Start local proxy with request/response logging |
+
+### Template Updates
+
+| Command                   | Description                                 |
+| ------------------------- | ------------------------------------------- |
+| `doswiftly upgrade`       | Check for and apply template updates        |
+| `doswiftly migrate check` | Check for template updates                  |
+| `doswiftly migrate apply` | Apply pending template migrations           |
+| `doswiftly migrate diff`  | Show differences between local and template |
+
+## Global Options
+
+```bash
+--verbose    # Detailed logging
+--quiet      # Errors only
+--version    # Show CLI version
+--help       # Show help
+```
+
+## Usage Examples
+
+### Creating a New Storefront
+
+```bash
+# Basic usage
+doswiftly init my-shop
+
+# With specific package manager
+doswiftly init my-shop --pm yarn
+
+# With UI library selection
+doswiftly init my-shop --ui-library shadcn
+
+# Dry run (preview without changes)
+doswiftly init my-shop --dry-run
+```
+
+### Working with Commerce SDK
+
+The Commerce SDK provides a **GraphQL-based** storefront API and admin REST API:
+
+```typescript
+// Storefront API (GraphQL) — for public-facing storefronts
+import { createStorefrontClient } from "@doswiftly/commerce-sdk";
+
+const client = createStorefrontClient({
+  storefrontUrl: `${process.env.NEXT_PUBLIC_API_URL}/storefront/graphql`,
+  storefrontAccessToken: "public-token",
+});
+
+// Use auto-generated GraphQL documents
+import { GetProductByHandleDocument } from "@doswiftly/commerce-sdk/graphql";
+
+const { data } = await client.query(GetProductByHandleDocument, {
+  variables: { handle: "awesome-product" },
+});
+```
+
+### Testing API Endpoints
+
+```bash
+# GET request
+doswiftly inspect /v1/commerce/products
+
+# POST with body
+doswiftly inspect /v1/commerce/cart -X POST -d '{"productId":"123"}'
+
+# With custom headers
+doswiftly inspect /v1/commerce/orders -H "Authorization:Bearer token"
+
+# Verbose mode (full request/response)
+doswiftly inspect /v1/commerce/products -v
+```
+
+### Local Development with Proxy
+
+```bash
+# Start proxy on default port 3001
+doswiftly proxy
+
+# Custom port
+doswiftly proxy -p 4000
+```
+
+The proxy logs all requests/responses, useful for debugging API interactions.
+
+---
+
+## Requirements
+
+- Node.js >= 18
+- Package manager: pnpm, npm, yarn, or bun
+- DoSwiftly Commerce account
+
+---
+
+## Project Configuration
+
+### doswiftly.config.ts
+
+```typescript
+import { defineConfig } from "@doswiftly/cli";
+
+export default defineConfig({
+  shop: {
+    slug: "my-shop",
+  },
+  project: {
+    name: "My Storefront",
+  },
+  api: {
+    url: "https://api.doswiftly.pl",
+  },
+  dev: {
+    port: 3000,
+    openBrowser: true,
+  },
+});
+```
+
+### Environment Variables (.env.local)
+
+```env
+# Required (auto-generated by `doswiftly env generate`)
+NEXT_PUBLIC_API_URL=https://api.doswiftly.pl
+NEXT_PUBLIC_SHOP_SLUG=my-shop
+```
+
+---
+
+## How It Works
+
+1. **DoSwiftly Commerce API** - Backend SaaS platform hosting your product catalog, orders, customers, etc.
+2. **@doswiftly/commerce-sdk** - TypeScript SDK with GraphQL storefront API and full type safety
+3. **Your Storefront** - Next.js app you build, using the Commerce SDK to fetch data
+4. **This CLI** - Tools to scaffold, develop, and deploy your storefront
+
+```
+┌─────────────────────┐
+│  Your Storefront    │
+│  (Next.js + SDK)    │ ← You build this
+└──────────┬──────────┘
+           │ uses @doswiftly/commerce-sdk (GraphQL)
+           ↓
+┌─────────────────────┐
+│ DoSwiftly Commerce  │
+│      API            │ ← Managed by DoSwiftly
+└─────────────────────┘
+```
+
+---
+
+## Troubleshooting
+
+### "No active environment profile"
+
+You need to configure an environment first:
+
+```bash
+doswiftly env add
+```
+
+### "Not in a DoSwiftly project directory"
+
+Make sure you're in a directory with `doswiftly.config.ts`:
+
+```bash
+# Create new project first
+doswiftly init my-shop
+cd my-shop
+```
+
+### "API error: 401 Unauthorized"
+
+Check your credentials:
+
+```bash
+doswiftly auth login    # Re-authenticate
+doswiftly verify        # Test connection
+```
+
+### Build or type errors
+
+Run diagnostics:
+
+```bash
+doswiftly doctor        # Full health check
+doswiftly check         # Linting + type checking
+```
+
+### Commerce SDK version mismatch
+
+Update to latest SDK:
+
+```bash
+doswiftly sdk version   # Check version
+pnpm update @doswiftly/commerce-sdk@latest
+```
+
+---
+
+## License
+
+MIT

package/bin/doswiftly.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/commands/auth-github.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GitHub device flow authentication.
+ * Requests a device code, displays the user code, and polls for the access token.
+ */
+export declare function authGithubCommand(): Promise<void>;
+//# sourceMappingURL=auth-github.d.ts.map

package/dist/commands/auth-github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-github.d.ts","sourceRoot":"","sources":["../../src/commands/auth-github.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,wBAAsB,iBAAiB,kBAsDtC"}

package/dist/commands/auth-github.js

@@ -0,0 +1,89 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import axios from 'axios';
+import { getActiveProfile, updateActiveProfile } from '../lib/env-storage.js';
+import { logger } from '../lib/logger.js';
+const GITHUB_CLIENT_ID = process.env.GITHUB_CLI_CLIENT_ID || '';
+const DEVICE_CODE_URL = 'https://github.com/login/device/code';
+const ACCESS_TOKEN_URL = 'https://github.com/login/oauth/access_token';
+/**
+ * GitHub device flow authentication.
+ * Requests a device code, displays the user code, and polls for the access token.
+ */
+export async function authGithubCommand() {
+    console.log(chalk.bold.blue('\nDoSwiftly CLI - GitHub Authentication\n'));
+    if (!GITHUB_CLIENT_ID) {
+        console.log(chalk.red('  GitHub CLI integration is not configured.\n'));
+        console.log(chalk.gray('  Set GITHUB_CLI_CLIENT_ID environment variable.\n'));
+        process.exit(1);
+    }
+    const profile = getActiveProfile();
+    if (!profile) {
+        console.log(chalk.red('  No active profile. Run "doswiftly env add" first.\n'));
+        process.exit(1);
+    }
+    const spinner = ora('Requesting device code from GitHub...').start();
+    try {
+        // Step 1: Request device code
+        const deviceResponse = await axios.post(DEVICE_CODE_URL, { client_id: GITHUB_CLIENT_ID, scope: 'repo' }, { headers: { Accept: 'application/json' } });
+        const { device_code, user_code, verification_uri, interval } = deviceResponse.data;
+        spinner.stop();
+        console.log(chalk.bold('\n  Open this URL in your browser:\n'));
+        console.log(`    ${chalk.cyan(verification_uri)}\n`);
+        console.log(chalk.bold(`  Enter this code: ${chalk.green.bold(user_code)}\n`));
+        // Step 2: Poll for access token
+        spinner.start('Waiting for authorization...');
+        const token = await pollForToken(device_code, interval);
+        if (!token) {
+            spinner.fail('Authorization expired or was denied');
+            process.exit(1);
+        }
+        // Step 3: Store the GitHub token in the active profile
+        updateActiveProfile({ githubToken: token });
+        spinner.succeed('GitHub connected successfully');
+        console.log(chalk.green('\n  GitHub token stored in your active profile.\n'));
+        console.log(chalk.gray('  You can now use GitHub features in DoSwiftly CLI.\n'));
+    }
+    catch (error) {
+        spinner.fail('GitHub authentication failed');
+        console.log(chalk.red(`\n${error.message}\n`));
+        process.exit(1);
+    }
+}
+async function pollForToken(deviceCode, interval) {
+    const maxAttempts = 60; // ~5 minutes at 5s intervals
+    let attempts = 0;
+    while (attempts < maxAttempts) {
+        await new Promise(resolve => setTimeout(resolve, (interval || 5) * 1000));
+        try {
+            const response = await axios.post(ACCESS_TOKEN_URL, {
+                client_id: GITHUB_CLIENT_ID,
+                device_code: deviceCode,
+                grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+            }, { headers: { Accept: 'application/json' } });
+            if (response.data.access_token) {
+                return response.data.access_token;
+            }
+            if (response.data.error === 'authorization_pending') {
+                attempts++;
+                continue;
+            }
+            if (response.data.error === 'slow_down') {
+                // Increase polling interval
+                await new Promise(resolve => setTimeout(resolve, 5000));
+                attempts++;
+                continue;
+            }
+            if (response.data.error === 'expired_token' || response.data.error === 'access_denied') {
+                return null;
+            }
+            logger.debug(`GitHub poll error: ${response.data.error}`);
+        }
+        catch {
+            // Network errors — retry
+        }
+        attempts++;
+    }
+    return null;
+}
+//# sourceMappingURL=auth-github.js.map

package/dist/commands/auth-github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-github.js","sourceRoot":"","sources":["../../src/commands/auth-github.ts"],"names":[],"mappings":"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"}

package/dist/commands/auth-token.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generate a deploy token for CI/CD usage.
+ * Deploy tokens have a 1-year TTL and deploy-only scope.
+ *
+ * Usage in CI:
+ *   export DOSWIFTLY_DEPLOY_TOKEN=<token>
+ *   doswiftly deploy
+ */
+export declare function authTokenCommand(options?: {
+    deploy?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=auth-token.d.ts.map

package/dist/commands/auth-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-token.d.ts","sourceRoot":"","sources":["../../src/commands/auth-token.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,iBAkCxE"}

package/dist/commands/auth-token.js

@@ -0,0 +1,43 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { createSharedApiClient } from '../lib/shared-api-client.js';
+/**
+ * Generate a deploy token for CI/CD usage.
+ * Deploy tokens have a 1-year TTL and deploy-only scope.
+ *
+ * Usage in CI:
+ *   export DOSWIFTLY_DEPLOY_TOKEN=<token>
+ *   doswiftly deploy
+ */
+export async function authTokenCommand(options = {}) {
+    console.log(chalk.bold.blue('\nDoSwiftly CLI - Generate Token\n'));
+    if (!options.deploy) {
+        console.log(chalk.yellow('  Use --deploy to generate a deploy token for CI/CD.\n'));
+        console.log(chalk.gray('  Example: doswiftly auth token --deploy\n'));
+        return;
+    }
+    const spinner = ora('Generating deploy token...').start();
+    try {
+        // Deploy token is platform-level, doesn't require shop config
+        const client = createSharedApiClient({ requireShopSlug: false });
+        const response = await client.post('/cli/auth/deploy-token', {
+            scope: 'deploy',
+            ttlDays: 365,
+        });
+        spinner.succeed('Deploy token generated');
+        console.log(chalk.bold('\n  Your deploy token (shown only once):\n'));
+        console.log(`    ${chalk.green(response.data.token)}\n`);
+        console.log(chalk.bold('  Usage in CI/CD:\n'));
+        console.log(chalk.gray('    export DOSWIFTLY_DEPLOY_TOKEN=<token above>'));
+        console.log(chalk.gray('    doswiftly deploy\n'));
+        console.log(chalk.gray(`  Expires: ${new Date(response.data.expiresAt).toLocaleDateString()}`));
+        console.log(chalk.gray(`  Scope:   ${response.data.scope}\n`));
+        console.log(chalk.yellow('  Store this token securely — it will not be shown again.\n'));
+    }
+    catch (error) {
+        spinner.fail('Failed to generate deploy token');
+        console.log(chalk.red(`\n${error.message}\n`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=auth-token.js.map

package/dist/commands/auth-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-token.js","sourceRoot":"","sources":["../../src/commands/auth-token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AASpE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAgC,EAAE;IACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wDAAwD,CAAC,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,4BAA4B,CAAC,CAAC,KAAK,EAAE,CAAC;IAE1D,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAsB,wBAAwB,EAAE;YAChF,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAE1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC;QAChG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6DAA6D,CAAC,CAAC,CAAC;IAC3F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAM,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/auth.d.ts

@@ -0,0 +1,22 @@
+export declare function authLoginCommand(profileName?: string): Promise<void>;
+export declare function authLogoutCommand(profileName?: string): Promise<void>;
+/**
+ * Get the stored token from the active profile.
+ * Returns null if not logged in or token expired.
+ * Shows warning if token is expired.
+ */
+export declare function getStoredToken(): string | null;
+/**
+ * Get the stored user role from the active profile.
+ * Returns null if not logged in or role is not stored.
+ */
+export declare function getStoredRole(): string | null;
+/**
+ * Check auth state without side effects (no warnings printed).
+ * Used for command visibility decisions (e.g. hiding SaaS-dev commands).
+ */
+export declare function getAuthStateSilent(): {
+    isLoggedIn: boolean;
+    isSaasDeveloper: boolean;
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAkCA,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,iBA4R1D;AAED,wBAAsB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,iBA2C3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAgB9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAM7C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAEtF"}