@khoaha/spek-cli 1.0.4 → 1.0.5

package/dist/utils/svg-converter.js

@@ -0,0 +1,149 @@
+/**
+ * SVG to Vector Drawable Conversion Utility
+ *
+ * Converts SVG content to Android Vector Drawable XML format using vd-tool
+ */
+import { writeFile, unlink, mkdtemp, readFile } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { vdConvert } from 'vd-tool';
+/**
+ * Validates SVG content format
+ *
+ * @param svgContent - The SVG content to validate
+ * @returns Validation result with isValid boolean and errors array
+ */
+export function validateSvgContent(svgContent) {
+    const errors = [];
+    if (!svgContent || typeof svgContent !== 'string') {
+        errors.push('SVG content is required and must be a string');
+    }
+    else {
+        if (svgContent.trim().length === 0) {
+            errors.push('SVG content cannot be empty');
+        }
+        if (!svgContent.includes('<svg')) {
+            errors.push('SVG content must contain an opening <svg> tag');
+        }
+        if (!svgContent.includes('</svg>')) {
+            errors.push('SVG content must contain a closing </svg> tag');
+        }
+        // Check for basic XML structure
+        const openTags = (svgContent.match(/<svg[^>]*>/g) || []).length;
+        const closeTags = (svgContent.match(/<\/svg>/g) || []).length;
+        if (openTags !== closeTags) {
+            errors.push('SVG content has mismatched <svg> tags');
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors
+    };
+}
+/**
+ * Applies customizations to the Vector Drawable XML
+ *
+ * @param vectorDrawableXml - The Vector Drawable XML content
+ * @param options - Customization options
+ * @returns Customized Vector Drawable XML
+ */
+function applyCustomizations(vectorDrawableXml, options) {
+    let customizedXml = vectorDrawableXml;
+    // Apply tint if specified
+    if (options.tint) {
+        customizedXml = customizedXml.replace(/<vector([^>]*)>/, `<vector$1 android:tint="${options.tint}">`);
+    }
+    return customizedXml;
+}
+/**
+ * Cleans up temporary files and directories
+ *
+ * @param svgFile - Path to temporary SVG file
+ * @param vdFile - Path to temporary Vector Drawable file
+ * @param tempDir - Path to temporary directory
+ */
+async function cleanup(svgFile, vdFile, tempDir) {
+    try {
+        if (svgFile)
+            await unlink(svgFile).catch(() => { });
+        if (vdFile)
+            await unlink(vdFile).catch(() => { });
+        if (tempDir) {
+            const { rm } = await import('fs/promises');
+            await rm(tempDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+    catch (error) {
+        // Ignore cleanup errors
+    }
+}
+/**
+ * Converts SVG content to Android Vector Drawable XML format
+ *
+ * @param svgContent - The SVG content to convert
+ * @param options - Conversion options
+ * @returns Conversion result with vectorDrawable XML and optional warnings
+ * @throws Error if conversion fails
+ */
+export async function convertSvgToVectorDrawable(svgContent, options = {}) {
+    // Input validation
+    if (!svgContent || typeof svgContent !== 'string') {
+        throw new Error('SVG content is required and must be a string');
+    }
+    if (svgContent.trim().length === 0) {
+        throw new Error('SVG content cannot be empty');
+    }
+    // Basic SVG format validation
+    if (!svgContent.includes('<svg') || !svgContent.includes('</svg>')) {
+        throw new Error('Invalid SVG format: must contain <svg> tags');
+    }
+    let tempDir = null;
+    let tempSvgFile = null;
+    let tempVdFile = null;
+    try {
+        // Create temporary directory
+        tempDir = await mkdtemp(join(tmpdir(), 'svg-to-vd-'));
+        tempSvgFile = join(tempDir, 'input.svg');
+        tempVdFile = join(tempDir, 'input.xml');
+        // Write SVG content to temporary file
+        await writeFile(tempSvgFile, svgContent, 'utf8');
+        // Use vd-tool library for conversion
+        try {
+            await vdConvert(tempSvgFile, {
+                outDir: tempDir
+            });
+        }
+        catch (conversionError) {
+            const errorMessage = conversionError.message || 'Unknown conversion error';
+            throw new Error(`SVG to Vector Drawable conversion failed: ${errorMessage}`);
+        }
+        // Read the generated Vector Drawable XML
+        let vectorDrawableContent;
+        try {
+            vectorDrawableContent = await readFile(tempVdFile, 'utf8');
+        }
+        catch (readError) {
+            throw new Error('Failed to read converted Vector Drawable file');
+        }
+        // Apply customizations if provided
+        if (options.tint) {
+            vectorDrawableContent = applyCustomizations(vectorDrawableContent, options);
+        }
+        // Clean up temporary files
+        await cleanup(tempSvgFile, tempVdFile, tempDir);
+        return {
+            vectorDrawable: vectorDrawableContent,
+            warnings: []
+        };
+    }
+    catch (error) {
+        // Clean up temporary files in case of error
+        if (tempSvgFile || tempVdFile || tempDir) {
+            await cleanup(tempSvgFile, tempVdFile, tempDir).catch(() => {
+                // Ignore cleanup errors
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=svg-converter.js.map

package/dist/utils/svg-converter.js.map

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

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@khoaha/spek-cli",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "CLI tool to download and extract Figma design specs from Directus",
   "type": "module",
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "QUICKSTART.md"
+  ],
   "bin": {
     "spek-cli": "./bin/cli.js"
   },

package/docs/ARCHITECTURE.md

@@ -1,286 +0,0 @@
-# CLI Tool Architecture
-
-## Overview
-
-`spek-cli` is a standalone CLI tool for downloading and extracting Figma design specs from Directus vault storage. It's built with TypeScript and uses the official Directus SDK for authentication and file downloads.
-
-## Architecture Diagram
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                         User                                │
-└────────────────────┬────────────────────────────────────────┘
-                     │
-                     ▼
-┌─────────────────────────────────────────────────────────────┐
-│                    CLI Entry Point                          │
-│                    (src/index.ts)                           │
-│  • Parse arguments (-d, --download, --help, --version)      │
-│  • Orchestrate workflow                                     │
-└────────────┬────────────────────────────────────────────────┘
-             │
-             ▼
-┌─────────────────────────────────────────────────────────────┐
-│              Configuration Manager                          │
-│              (src/config/manager.ts)                        │
-│  • Check if config exists                                   │
-│  • Load from ~/.spek-cli/config.json                     │
-│  • Save new configuration                                   │
-└────────────┬────────────────────────────────────────────────┘
-             │
-             ▼
-┌─────────────────────────────────────────────────────────────┐
-│                  Prompts Module                             │
-│                (src/prompts/index.ts)                       │
-│  • Prompt for Directus URL (first run)                      │
-│  • Prompt for access token (first run)                      │
-│  • Prompt for file ID (interactive mode)                    │
-│  • Prompt for overwrite confirmation                        │
-└────────────┬────────────────────────────────────────────────┘
-             │
-             ▼
-┌─────────────────────────────────────────────────────────────┐
-│               Directus Client                               │
-│              (src/directus/client.ts)                       │
-│  • Create authenticated Directus SDK client                 │
-│  • Download file using readAssetRaw()                       │
-│  • Handle authentication and errors                         │
-└────────────┬────────────────────────────────────────────────┘
-             │
-             ▼
-┌─────────────────────────────────────────────────────────────┐
-│              Download Handler                               │
-│            (src/download/handler.ts)                        │
-│  • Download file to temp location                           │
-│  • Validate ZIP file                                        │
-│  • Check for existing files                                 │
-│  • Extract to current working directory                     │
-│  • Cleanup temp files                                       │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## Module Breakdown
-
-### 1. Entry Point (`src/index.ts`)
-
-**Responsibilities:**
-- Parse command-line arguments
-- Check/initialize configuration
-- Orchestrate the download workflow
-- Handle errors and display results
-
-**Key Functions:**
-- `parseArgs()` - Parse CLI arguments
-- `showHelp()` - Display help message
-- `showVersion()` - Display version
-- `main()` - Main entry point
-
-**Flow:**
-```
-1. Parse arguments
-2. Load or initialize config
-3. Get file ID (from args or prompt)
-4. Call download handler
-5. Display result
-```
-
-### 2. Configuration Manager (`src/config/manager.ts`)
-
-**Responsibilities:**
-- Manage configuration file at `~/.spek-cli/config.json`
-- Load, save, and validate configuration
-- Ensure config directory exists
-
-**Key Functions:**
-- `configExists()` - Check if config file exists
-- `loadConfig()` - Load configuration from disk
-- `saveConfig()` - Save configuration to disk
-- `getConfigPath()` - Get config file path
-
-**Configuration Structure:**
-```typescript
-interface VaultConfig {
-  directusUrl: string;      // e.g., https://my.directus.app
-  accessToken: string;      // Directus access token
-  createdAt: string;        // ISO timestamp
-}
-```
-
-### 3. Prompts Module (`src/prompts/index.ts`)
-
-**Responsibilities:**
-- Interactive user input collection
-- Validation of user inputs
-- Confirmation dialogs
-
-**Key Functions:**
-- `promptForConfig()` - First-run configuration setup
-- `promptForFileId()` - Get file ID in interactive mode
-- `promptOverwrite()` - Confirm overwrite of existing files
-
-**Uses:** `prompts` package (v2.4.2) for user-friendly CLI prompts
-
-### 4. Directus Client (`src/directus/client.ts`)
-
-**Responsibilities:**
-- Create authenticated Directus SDK client
-- Download files from Directus assets
-- Handle authentication and API errors
-
-**Key Functions:**
-- `createAuthenticatedClient()` - Initialize Directus client
-- `downloadFile()` - Download file by ID
-
-**Error Handling:**
-- 401: Authentication failed
-- 404: File not found
-- Network errors: Connection issues
-
-**Implementation Details:**
-- Uses `@directus/sdk` with `authentication()` and `rest()` modules
-- Converts `ReadableStream` to `Buffer` for file processing
-- Sets access token before making requests
-
-### 5. Download Handler (`src/download/handler.ts`)
-
-**Responsibilities:**
-- Orchestrate download and extraction process
-- Validate ZIP files
-- Check for file conflicts
-- Extract to current working directory
-- Cleanup temporary files
-
-**Key Functions:**
-- `checkExistingFiles()` - Check if extraction would overwrite files
-- `handleDownload()` - Main download and extract workflow
-
-**Flow:**
-```
-1. Download file from Directus
-2. Save to temp file
-3. Validate ZIP structure
-4. Check for existing files
-5. Prompt for overwrite if needed
-6. Extract to CWD
-7. Cleanup temp files
-8. Return result
-```
-
-**Uses:** `adm-zip` for ZIP file operations
-
-## Data Flow
-
-```
-User Input
-    ↓
-CLI Arguments / Prompts
-    ↓
-Configuration (from file or new setup)
-    ↓
-Directus SDK Client
-    ↓
-Download File (via Directus API)
-    ↓
-Temp File Storage
-    ↓
-ZIP Validation
-    ↓
-Overwrite Check
-    ↓
-Extract to CWD
-    ↓
-Cleanup & Result
-```
-
-## Error Handling Strategy
-
-### Configuration Errors
-- Missing config → Auto-trigger setup wizard
-- Invalid config → Show error, suggest re-setup
-
-### Authentication Errors
-- 401 Unauthorized → Check access token message
-- Invalid URL → Validation during setup
-
-### Download Errors
-- 404 Not Found → File ID doesn't exist
-- Network errors → Connection issues
-- Timeout → Retry suggestion
-
-### Extraction Errors
-- Invalid ZIP → Corrupted file message
-- Permission errors → Write access issues
-- Disk space → Insufficient space
-
-### User Cancellation
-- Ctrl+C during prompts → Graceful exit
-- Overwrite declined → Cancel operation
-
-## Dependencies
-
-### Production Dependencies
-- `@directus/sdk` (^17.0.0) - Official Directus SDK
-- `prompts` (^2.4.2) - Interactive CLI prompts
-- `adm-zip` (^0.5.10) - ZIP file operations
-- `chalk` (^5.3.0) - Terminal colors
-
-### Development Dependencies
-- `typescript` (^5.3.3) - TypeScript compiler
-- `@types/node` (^20.11.0) - Node.js type definitions
-- `@types/adm-zip` (^0.5.5) - adm-zip type definitions
-- `@types/prompts` (^2.4.9) - prompts type definitions
-
-## Build System
-
-**Compiler:** TypeScript 5.3.3
-
-**Target:** ES2022 with Node.js modules
-
-**Output:** `dist/` directory with compiled JavaScript + source maps
-
-**Entry Point:** `dist/index.js` (with shebang for CLI execution)
-
-## Configuration File Location
-
-**Path:** `~/.spek-cli/config.json`
-
-**Platform-specific:**
-- Windows: `C:\Users\<username>\.spek-cli\config.json`
-- macOS: `/Users/<username>/.spek-cli/config.json`
-- Linux: `/home/<username>/.spek-cli/config.json`
-
-## Security Considerations
-
-1. **Access Token Storage**
-   - Stored in user's home directory
-   - File permissions should be restricted (user-only)
-   - Never logged or displayed in output
-
-2. **HTTPS Enforcement**
-   - Directus URL validated to be valid URL
-   - SDK handles HTTPS connections
-
-3. **Input Validation**
-   - URL validation during setup
-   - File ID passed through without modification
-   - No shell command injection risks
-
-## Performance Characteristics
-
-- **Download Speed:** Limited by network and Directus server
-- **Memory Usage:** Streams file to temp, then loads ZIP into memory
-- **Disk Usage:** Temporary file during download (auto-cleaned)
-- **Startup Time:** ~100ms for config load + argument parsing
-
-## Future Enhancements
-
-Potential features for future versions:
-
-1. **Progress Bar:** Show download progress for large files
-2. **Resume Downloads:** Support partial download resume
-3. **Batch Downloads:** Download multiple files at once
-4. **Config Management:** Commands to view/edit/reset config
-5. **Dry Run:** Preview what would be extracted without extracting
-6. **Custom Output:** Specify extraction directory
-7. **Compression:** Support other archive formats
-8. **Logging:** Verbose mode with detailed logs

package/docs/PUBLISH_QUICK_REFERENCE.md

@@ -1,135 +0,0 @@
-# 🚀 Quick Publish Reference
-
-## Pre-Publish Checklist
-
-```bash
-# 1. Verify token is configured
-cat .env | grep NPM_ACCESS_TOKEN
-
-# 2. Clean build
-npm run build
-
-# 3. Test locally
-node dist/index.js --help
-node dist/index.js --version
-
-# 4. Dry run
-npm publish --dry-run
-```
-
-## Publish Commands
-
-### Linux/macOS
-```bash
-# Make executable (first time only)
-chmod +x scripts/publish.sh
-
-# Publish (choose one)
-./scripts/publish.sh              # Patch: 1.0.0 → 1.0.1
-./scripts/publish.sh minor        # Minor: 1.0.0 → 1.1.0
-./scripts/publish.sh major        # Major: 1.0.0 → 2.0.0
-./scripts/publish.sh 2.5.3        # Specific version
-```
-
-### Windows (PowerShell)
-```powershell
-# Publish (choose one)
-.\scripts\publish.ps1              # Patch: 1.0.0 → 1.0.1
-.\scripts\publish.ps1 minor        # Minor: 1.0.0 → 1.1.0
-.\scripts\publish.ps1 major        # Major: 1.0.0 → 2.0.0
-.\scripts\publish.ps1 2.5.3        # Specific version
-```
-
-### Or Use npm Scripts
-```bash
-npm run publish:patch    # 1.0.0 → 1.0.1
-npm run publish:minor    # 1.0.0 → 1.1.0
-npm run publish:major    # 1.0.0 → 2.0.0
-```
-
-## Post-Publish
-
-```bash
-# 1. Verify on npm
-https://www.npmjs.com/package/spek-cli
-
-# 2. Test installation
-npx spek-cli@latest --version
-
-# 3. Push git tag
-git push origin v1.0.0
-
-# 4. Test full workflow
-npx spek-cli -d <test-file-id>
-```
-
-## Quick Test
-
-```bash
-# Test without publishing
-npm link
-spek-cli --help
-spek-cli --version
-npm unlink -g spek-cli
-```
-
-## Environment
-
-Required in `.env`:
-```bash
-NPM_ACCESS_TOKEN=npm_xxxxxxxxxxxxxxxxxxxxxx
-```
-
-## What the Script Does
-
-1. ✓ Checks git status
-2. ✓ Clean installs dependencies  
-3. ✓ Builds TypeScript
-4. ✓ Verifies build output
-5. ✓ Bumps version
-6. ✓ Creates .npmrc with token
-7. ✓ Runs dry-run
-8. ✓ Asks for confirmation
-9. ✓ Publishes to npm
-10. ✓ Cleans up .npmrc
-11. ✓ Creates git tag
-12. ✓ Shows success message
-
-## Troubleshooting
-
-### "NPM_ACCESS_TOKEN not found"
-```bash
-# Check .env file exists
-ls -la .env
-
-# Create if missing
-echo "NPM_ACCESS_TOKEN=your-token-here" > .env
-```
-
-### "401 Unauthorized"
-- Generate new token at https://www.npmjs.com/settings/~/tokens
-- Update `.env` with new token
-
-### "403 Forbidden"  
-- Package name already exists
-- Or insufficient token permissions
-
-### Build fails
-```bash
-rm -rf dist node_modules
-npm install
-npm run build
-```
-
-## Quick Links
-
-- **Publishing Guide**: `docs/PUBLISHING.md`
-- **npm Registry**: https://www.npmjs.com/package/spek-cli
-- **Token Settings**: https://www.npmjs.com/settings/~/tokens
-- **Rename Summary**: `RENAME_COMPLETE.md`
-
----
-
-**Current Version**: 1.0.0 (unpublished)
-**Ready**: ✅ Yes - All files updated and tested
-**Next**: Run publish script