@flowkode/cli 1.0.0

package/README.md

@@ -0,0 +1,299 @@
+# @flowkode/cli
+
+CLI officiel pour l'API Flowkode. Creez, deployez et gerez vos sites web depuis le terminal.
+
+## Installation
+
+```bash
+npm install -g @flowkode/cli
+```
+
+## Connexion
+
+```bash
+flowkode login
+```
+
+Le navigateur s'ouvre, vous autorisez le CLI en un clic, c'est tout.
+
+```
+$ flowkode login
+
+  Flowkode Login
+
+  Ouverture du navigateur...
+
+  En attente d'autorisation...
+
+  ✓ Connecte en tant que jeremy@example.com
+    Cle sauvegardee dans ~/.flowkode/config.json
+
+    Essayez : flowkode projects list
+```
+
+Pour se deconnecter :
+```bash
+flowkode logout
+```
+
+### Configuration avancee
+
+```bash
+# Configurer manuellement une cle API
+flowkode config --api-key ws_live_xxxxx
+
+# URL personnalisee (defaut: https://app.flowkode.com)
+flowkode config --base-url https://app.flowkode.com
+
+# Voir la config actuelle
+flowkode config --show
+```
+
+La configuration est stockee dans `~/.flowkode/config.json`.
+
+Variables d'environnement (prioritaires) :
+```bash
+export FLOWKODE_API_KEY=ws_live_xxxxx
+export FLOWKODE_BASE_URL=https://app.flowkode.com
+```
+
+## Commandes
+
+### Projets
+
+```bash
+# Lister les projets
+flowkode projects list
+flowkode projects list --folder <folder-id>
+
+# Detail d'un projet
+flowkode projects get <id>
+
+# Creer un projet (mode rapide, 1 page)
+flowkode projects create \
+  --name "Mon site" \
+  --type vitrine \
+  --keywords "seo, web, freelance" \
+  --language fr \
+  --description "Portfolio developpeur"
+
+# Modifier un projet
+flowkode projects update <id> --name "Nouveau nom"
+flowkode projects update <id> --folder <folder-id>
+
+# Deployer
+flowkode projects deploy <id> --provider vercel
+flowkode projects deploy <id> --provider cloudflare --domain <domain-id> --configure-ns
+
+# Re-deployer sur le dernier provider
+flowkode projects redeploy <id>
+
+# Statut d'indexation Google
+flowkode projects indexing <id>
+```
+
+### Jobs de generation
+
+```bash
+# Lister les jobs
+flowkode jobs list
+flowkode jobs list --status running
+
+# Suivre un job
+flowkode jobs get <id>
+```
+
+### Deploiements
+
+```bash
+# Lister les deploiements
+flowkode deployments list
+flowkode deployments list --project <id> --provider vercel --status ready
+
+# Detail d'un deploiement
+flowkode deployments get <id>
+```
+
+### Domaines
+
+```bash
+# Lister les domaines
+flowkode domains list
+flowkode domains list --registrar ovh --project <id>
+
+# Detail d'un domaine
+flowkode domains get <id>
+
+# Verifier la disponibilite
+flowkode domains check monsite.com
+
+# Acheter un domaine
+flowkode domains purchase monsite.com --registrar internetbs --years 2
+
+# Synchroniser depuis les registrars
+flowkode domains sync
+
+# Associer un domaine a un projet
+flowkode domains associate <domain-id> --project <project-id>
+
+# Dissocier
+flowkode domains dissociate <domain-id>
+
+# Configurer les DNS
+flowkode domains dns <domain-id>
+
+# Verifier la propagation DNS
+flowkode domains propagation <domain-id>
+
+# Modifier (dossier)
+flowkode domains update <id> --folder <folder-id>
+
+# Supprimer
+flowkode domains delete <id>
+```
+
+### Dossiers
+
+```bash
+# Lister les dossiers
+flowkode folders list
+
+# Creer un dossier
+flowkode folders create --name "Clients 2026" --color blue
+
+# Modifier
+flowkode folders update <id> --name "Nouveau nom" --color green --position 0
+
+# Supprimer
+flowkode folders delete <id>
+```
+
+### Blog
+
+```bash
+# Lister les articles
+flowkode blog list
+flowkode blog list --project <id> --status published
+
+# Detail d'un article
+flowkode blog get <article-id>
+
+# Generer des articles par mots-cles
+flowkode blog generate <project-id> --keywords "react" "nextjs" "typescript"
+flowkode blog generate <project-id> --keywords "seo" --auto-publish
+
+# Indexation Google
+flowkode blog indexing <article-id>
+flowkode blog indexing-check <article-id>
+flowkode blog indexing-submit <article-id>
+```
+
+### Formulaires de contact
+
+```bash
+flowkode contact-forms
+flowkode contact-forms --category devis
+```
+
+### Modeles IA
+
+```bash
+flowkode ai-models
+flowkode ai-models --category generation
+```
+
+### Mentions legales
+
+```bash
+flowkode legal-notices
+```
+
+### Affiliation
+
+```bash
+flowkode affiliation list
+flowkode affiliation get <id>
+```
+
+### Google Search Console
+
+```bash
+# Comptes connectes
+flowkode search-console accounts
+
+# Enregistrer un site
+flowkode search-console add-site <project-id>
+
+# Statut
+flowkode search-console status <project-id>
+
+# Soumettre le sitemap
+flowkode search-console submit-sitemap <project-id>
+```
+
+## Options globales
+
+| Option | Description |
+|--------|-------------|
+| `--json` | Sortie en JSON brut (utile pour scripts et CI/CD) |
+| `--version` | Afficher la version |
+| `--help` | Afficher l'aide |
+
+```bash
+# Sortie JSON pour integration dans un script
+flowkode --json projects list
+
+# Pipe avec jq
+flowkode --json projects list | jq '.data[].name'
+```
+
+## Utilisation dans un CI/CD
+
+```yaml
+# GitHub Actions
+- name: Deploy site
+  env:
+    FLOWKODE_API_KEY: ${{ secrets.FLOWKODE_API_KEY }}
+  run: |
+    npx @flowkode/cli projects deploy $PROJECT_ID --provider vercel
+```
+
+## Workflow type
+
+```bash
+# 1. Creer un projet
+flowkode projects create -n "Mon site" -t vitrine -k "web,dev" -l fr
+# => { "jobId": "abc-123", "status": "pending" }
+
+# 2. Suivre la generation
+flowkode jobs get abc-123
+# => status: "completed", project_id: "def-456"
+
+# 3. Deployer
+flowkode projects deploy def-456 --provider vercel
+
+# 4. Acheter et associer un domaine
+flowkode domains check monsite.com
+flowkode domains purchase monsite.com --registrar ovh
+flowkode domains sync
+flowkode domains associate <domain-id> --project def-456
+flowkode domains dns <domain-id>
+
+# 5. Generer du contenu blog
+flowkode blog generate def-456 --keywords "react" "nextjs" --auto-publish
+
+# 6. Soumettre a Google
+flowkode search-console add-site def-456
+flowkode search-console submit-sitemap def-456
+```
+
+## Developpement
+
+```bash
+cd flowkode-cli
+npm install
+npm run build
+
+# Mode dev
+FLOWKODE_API_KEY=ws_live_... npm run dev -- projects list
+```

package/dist/api-client.d.ts

@@ -0,0 +1,11 @@
+export declare class FlowkodeApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    private headers;
+    get(path: string, params?: Record<string, string | undefined>): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    patch(path: string, body: unknown): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+    private handleResponse;
+}

package/dist/api-client.js

@@ -0,0 +1,65 @@
+export class FlowkodeApiClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+    }
+    async get(path, params) {
+        const url = new URL(`${this.baseUrl}/api/v1${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined)
+                    url.searchParams.set(key, value);
+            }
+        }
+        const res = await fetch(url.toString(), { headers: this.headers() });
+        return this.handleResponse(res);
+    }
+    async post(path, body) {
+        const res = await fetch(`${this.baseUrl}/api/v1${path}`, {
+            method: "POST",
+            headers: this.headers(),
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(res);
+    }
+    async patch(path, body) {
+        const res = await fetch(`${this.baseUrl}/api/v1${path}`, {
+            method: "PATCH",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        return this.handleResponse(res);
+    }
+    async delete(path) {
+        const res = await fetch(`${this.baseUrl}/api/v1${path}`, {
+            method: "DELETE",
+            headers: this.headers(),
+        });
+        return this.handleResponse(res);
+    }
+    async handleResponse(res) {
+        const text = await res.text();
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            data = { raw: text };
+        }
+        if (!res.ok) {
+            const errorMsg = typeof data === "object" && data !== null && "error" in data
+                ? data.error
+                : `HTTP ${res.status}`;
+            throw new Error(errorMsg);
+        }
+        return data;
+    }
+}

package/dist/commands/blog.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { FlowkodeApiClient } from "../api-client.js";
+export declare function blogCommand(api: FlowkodeApiClient): Command;

package/dist/commands/blog.js

@@ -0,0 +1,96 @@
+import { Command } from "commander";
+import { printTable, printSuccess, printError, printJson, } from "../output.js";
+export function blogCommand(api) {
+    const cmd = new Command("blog").description("Gerer les articles de blog");
+    cmd
+        .command("list")
+        .description("Lister les articles")
+        .option("--project <id>", "Filtrer par projet")
+        .option("-s, --status <status>", "Filtrer (pending, queued, running, generated, scheduled, published, error)")
+        .action(async (opts) => {
+        try {
+            const res = (await api.get("/blog/articles", {
+                projectId: opts.project,
+                status: opts.status,
+            }));
+            printTable(res.data, [
+                { key: "id", label: "ID", width: 36 },
+                { key: "title", label: "Titre", width: 35 },
+                { key: "keyword", label: "Mot-cle", width: 20 },
+                { key: "status", label: "Statut", width: 12 },
+            ]);
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    cmd
+        .command("get <articleId>")
+        .description("Detail d'un article")
+        .action(async (articleId) => {
+        try {
+            const res = await api.get(`/blog/articles/${articleId}`);
+            printJson(res);
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    cmd
+        .command("generate <projectId>")
+        .description("Generer des articles par mots-cles")
+        .requiredOption("-k, --keywords <keywords...>", "Mots-cles (un ou plusieurs)")
+        .option("--auto-publish", "Publier automatiquement")
+        .action(async (projectId, opts) => {
+        try {
+            const res = await api.post(`/projects/${projectId}/blog/articles`, {
+                keywords: opts.keywords,
+                auto_publish: opts.autoPublish ?? false,
+            });
+            printJson(res);
+            printSuccess("Generation d'articles lancee.");
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    cmd
+        .command("indexing <articleId>")
+        .description("Statut d'indexation Google d'un article")
+        .action(async (articleId) => {
+        try {
+            const res = await api.get(`/blog/articles/${articleId}/indexing`);
+            printJson(res);
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    cmd
+        .command("indexing-check <articleId>")
+        .description("Verifier l'indexation d'un article")
+        .action(async (articleId) => {
+        try {
+            const res = await api.post(`/blog/articles/${articleId}/indexing/check`);
+            printJson(res);
+            printSuccess("Verification lancee.");
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    cmd
+        .command("indexing-submit <articleId>")
+        .description("Soumettre un article pour indexation Google")
+        .action(async (articleId) => {
+        try {
+            const res = await api.post(`/blog/articles/${articleId}/indexing/submit`);
+            printJson(res);
+            printSuccess("Article soumis pour indexation.");
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    return cmd;
+}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function configCommand(): Command;

package/dist/commands/config.js

@@ -0,0 +1,37 @@
+import { Command } from "commander";
+import { loadConfig, saveConfig } from "../config.js";
+import { printSuccess, printDetail } from "../output.js";
+export function configCommand() {
+    const cmd = new Command("config").description("Configurer la cle API et l'URL de base");
+    cmd
+        .option("-k, --api-key <key>", "Cle API Flowkode (ws_live_...)")
+        .option("-u, --base-url <url>", "URL de base de l'API")
+        .option("--show", "Afficher la configuration actuelle")
+        .action((opts) => {
+        if (opts.show) {
+            const config = loadConfig();
+            printDetail({
+                api_key: config.api_key
+                    ? `${config.api_key.slice(0, 12)}...`
+                    : undefined,
+                base_url: config.base_url,
+            }, [
+                { key: "api_key", label: "API Key" },
+                { key: "base_url", label: "Base URL" },
+            ]);
+            return;
+        }
+        const config = loadConfig();
+        if (opts.apiKey)
+            config.api_key = opts.apiKey;
+        if (opts.baseUrl)
+            config.base_url = opts.baseUrl;
+        if (!opts.apiKey && !opts.baseUrl) {
+            cmd.help();
+            return;
+        }
+        saveConfig(config);
+        printSuccess("Configuration saved to ~/.flowkode/config.json");
+    });
+    return cmd;
+}

package/dist/commands/deployments.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { FlowkodeApiClient } from "../api-client.js";
+export declare function deploymentsCommand(api: FlowkodeApiClient): Command;

package/dist/commands/deployments.js

@@ -0,0 +1,51 @@
+import { Command } from "commander";
+import { printTable, printDetail, printError } from "../output.js";
+export function deploymentsCommand(api) {
+    const cmd = new Command("deployments").description("Gerer les deploiements");
+    cmd
+        .command("list")
+        .description("Lister les deploiements")
+        .option("--project <id>", "Filtrer par projet")
+        .option("--provider <provider>", "Filtrer (vercel, cloudflare)")
+        .option("-s, --status <status>", "Filtrer (pending, building, ready, error, canceled)")
+        .action(async (opts) => {
+        try {
+            const res = (await api.get("/deployments", {
+                project_id: opts.project,
+                provider: opts.provider,
+                status: opts.status,
+            }));
+            printTable(res.data, [
+                { key: "id", label: "ID", width: 36 },
+                { key: "project_name", label: "Projet", width: 25 },
+                { key: "provider", label: "Provider", width: 12 },
+                { key: "status", label: "Statut", width: 10 },
+                { key: "url", label: "URL", width: 40 },
+            ]);
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    cmd
+        .command("get <id>")
+        .description("Detail d'un deploiement")
+        .action(async (id) => {
+        try {
+            const res = (await api.get(`/deployments/${id}`));
+            printDetail(res.data, [
+                { key: "id", label: "ID" },
+                { key: "project_name", label: "Projet" },
+                { key: "provider", label: "Provider" },
+                { key: "status", label: "Statut" },
+                { key: "url", label: "URL" },
+                { key: "error_message", label: "Erreur" },
+                { key: "created_at", label: "Cree le" },
+            ]);
+        }
+        catch (e) {
+            printError(e);
+        }
+    });
+    return cmd;
+}

package/dist/commands/domains.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { FlowkodeApiClient } from "../api-client.js";
+export declare function domainsCommand(api: FlowkodeApiClient): Command;