fogtrail-cli 0.1.0 → 0.2.0

package/README.md

@@ -1,12 +1,13 @@
 # fogtrail-cli
 
-CLI tool to push blog content to your [Fogtrail](https://fogtrail.io) instance for AEO (Answer Engine Optimization).
+CLI tool to push and pull blog content to/from your [Fogtrail](https://fogtrail.io) instance for AEO (Answer Engine Optimization).
 
 ## Installation
 
 ```bash
 # Use directly with npx (no install needed)
 npx fogtrail-cli push --token <TOKEN> --dir ./blogs
+npx fogtrail-cli pull --token <TOKEN> --dir ./output
 
 # Or install globally
 npm install -g fogtrail-cli
@@ -22,7 +23,7 @@ Push all markdown and HTML files from a directory to Fogtrail:
 fogtrail-cli push --token <TOKEN> --dir ./blogs --url https://your-fogtrail-instance.com
 ```
 
-### Options
+#### Push options
 
 | Option | Required | Default | Description |
 |--------|----------|---------|-------------|
@@ -32,21 +33,45 @@ fogtrail-cli push --token <TOKEN> --dir ./blogs --url https://your-fogtrail-inst
 | `--batch-size <size>` | No | `10` | Number of files per upload batch |
 | `--no-recursive` | No | - | Do not scan subdirectories |
 
-### How it works
+#### How push works
 
-1. Open your Fogtrail dashboard and click **Add Content** > **Import from Website**
+1. Open your Fogtrail dashboard and click **Add Content** > **Import via CLI**
 2. Copy the command shown in the dialog (includes your unique token)
 3. Run the command in your terminal from your project directory
 4. The CLI scans for `.md` and `.html` files, uploads them to Fogtrail
 5. HTML files are automatically converted to Markdown
 6. Files without YAML frontmatter get auto-generated metadata
 
+### Pull content
+
+Pull all content from Fogtrail to local markdown files:
+
+```bash
+fogtrail-cli pull --token <TOKEN> --dir ./output --url https://your-fogtrail-instance.com
+```
+
+#### Pull options
+
+| Option | Required | Default | Description |
+|--------|----------|---------|-------------|
+| `--token <token>` | Yes | - | Export session token from Fogtrail UI |
+| `--dir <directory>` | Yes | - | Directory to write exported files |
+| `--url <url>` | No | `http://localhost:3000` | Fogtrail instance URL |
+
+#### How pull works
+
+1. Open your Fogtrail dashboard and click **Publish** > **Export via CLI**
+2. Copy the command shown in the dialog (includes your unique token)
+3. Run the command in your terminal
+4. All content is downloaded as Markdown files with YAML frontmatter
+5. The token is single-use and expires after 15 minutes
+
 ### Supported file formats
 
 - **Markdown** (`.md`) - uploaded as-is with frontmatter validation
 - **HTML** (`.html`, `.htm`) - converted to Markdown before upload
 
-### Example
+### Examples
 
 ```bash
 # Push all blog posts from ./content/blog
@@ -54,6 +79,12 @@ npx fogtrail-cli push \
   --token abc123def456... \
   --dir ./content/blog \
   --url https://app.fogtrail.io
+
+# Pull all content to ./exported
+npx fogtrail-cli pull \
+  --token fed654cba321... \
+  --dir ./exported \
+  --url https://app.fogtrail.io
 ```
 
 ## License

package/dist/index.js

@@ -3,10 +3,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const push_1 = require("./push");
+const pull_1 = require("./pull");
 const program = new commander_1.Command();
 program
     .name('fogtrail-cli')
-    .description('Push blog content to your Fogtrail instance')
+    .description('Push and pull blog content to/from your Fogtrail instance')
     .version('0.1.0');
 program
     .command('push')
@@ -17,4 +18,11 @@ program
     .option('--batch-size <size>', 'Files per request batch', '10')
     .option('--no-recursive', 'Do not scan subdirectories')
     .action(push_1.pushCommand);
+program
+    .command('pull')
+    .description('Pull content from Fogtrail to local markdown files')
+    .requiredOption('--token <token>', 'Export session token (from Fogtrail UI)')
+    .requiredOption('--dir <directory>', 'Directory to write exported files')
+    .option('--url <url>', 'Fogtrail instance URL', 'http://localhost:3000')
+    .action(pull_1.pullCommand);
 program.parse();

package/dist/pull.d.ts

@@ -0,0 +1,7 @@
+interface PullOptions {
+    token: string;
+    dir: string;
+    url: string;
+}
+export declare function pullCommand(options: PullOptions): Promise<void>;
+export {};

package/dist/pull.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pullCommand = pullCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+async function pullCommand(options) {
+    const { token, dir, url } = options;
+    // Ensure output directory exists
+    const resolvedDir = path.resolve(dir);
+    if (!fs.existsSync(resolvedDir)) {
+        fs.mkdirSync(resolvedDir, { recursive: true });
+        console.log(`Created directory: ${resolvedDir}`);
+    }
+    else if (!fs.statSync(resolvedDir).isDirectory()) {
+        console.error(`Error: Not a directory: ${resolvedDir}`);
+        process.exit(1);
+    }
+    const apiUrl = `${url.replace(/\/$/, '')}/api/export/pull`;
+    console.log('Pulling content from Fogtrail...');
+    try {
+        const response = await fetch(apiUrl, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+            },
+        });
+        if (!response.ok) {
+            const data = await response.json().catch(() => ({ error: `HTTP ${response.status}` }));
+            if (response.status === 401) {
+                console.error(`Error: Invalid token. Please check your token and try again.`);
+                process.exit(1);
+            }
+            if (response.status === 410) {
+                console.error(`Error: Session expired or already used. Please create a new export session from the Fogtrail UI.`);
+                process.exit(1);
+            }
+            console.error(`Error: ${data.error || `HTTP ${response.status}`}`);
+            process.exit(1);
+        }
+        const data = await response.json();
+        if (!data.success || !data.files) {
+            console.error(`Error: ${data.error || 'Failed to pull content'}`);
+            process.exit(1);
+        }
+        if (data.files.length === 0) {
+            console.log('No content to export.');
+            process.exit(0);
+        }
+        console.log(`Received ${data.files.length} file${data.files.length !== 1 ? 's' : ''}`);
+        console.log();
+        // Write files to disk
+        let written = 0;
+        let writeErrors = 0;
+        for (const file of data.files) {
+            const filepath = path.join(resolvedDir, file.filename);
+            try {
+                fs.writeFileSync(filepath, file.content, 'utf-8');
+                console.log(`  ${file.filename}`);
+                written++;
+            }
+            catch (error) {
+                const err = error;
+                console.error(`  Warning: Failed to write ${file.filename}: ${err.message}`);
+                writeErrors++;
+            }
+        }
+        // Summary
+        console.log();
+        console.log(`Successfully exported ${written} file${written !== 1 ? 's' : ''} to ${resolvedDir}`);
+        if (writeErrors > 0) {
+            console.log(`${writeErrors} file${writeErrors !== 1 ? 's' : ''} failed to write`);
+        }
+    }
+    catch (error) {
+        const err = error;
+        if (err.message.includes('ECONNREFUSED') || err.message.includes('fetch failed')) {
+            console.error(`Error: Could not connect to ${url}. Make sure your Fogtrail instance is running.`);
+        }
+        else {
+            console.error(`Error: ${err.message}`);
+        }
+        process.exit(1);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fogtrail-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI tool to push blog content to Fogtrail for AEO optimization",
   "bin": {
     "fogtrail-cli": "./dist/index.js"