magicpath-ai 1.0.0

package/README.md

@@ -0,0 +1,107 @@
+# MagicPath CLI
+
+( Instantly bring your MagicPath AI projects to your local development environment. Edit, remix, and create in your own vibe.
+
+## Quick Start
+
+```bash
+npx magicpath@latest clone -k <your-access-key>
+```
+
+## Installation
+
+### Using npx (Recommended)
+
+No installation required! Just run:
+
+```bash
+npx magicpath@latest clone -k <access-key>
+```
+
+### Global Installation
+
+```bash
+npm install -g magicpath
+magicpath clone -k <access-key>
+```
+
+### Local Installation
+
+```bash
+npm install magicpath
+npx magicpath clone -k <access-key>
+```
+
+## Usage
+
+### Clone Command
+
+Download and set up a MagicPath project locally:
+
+```bash
+npx magicpath@latest clone -k <access-key> [options]
+```
+
+**Options:**
+- `-k, --key <accessKey>` (required): = One-time magic access key to unlock and download your project
+- `-d, --debug`: Get verbose debug logs in the CLI
+
+**Example:**
+```bash
+npx magicpath@latest clone -k mp_1234567890abcdef
+```
+
+The CLI will:
+1. =� Download your project using the access key
+2. =� Prompt you to name your project (default: `magicpath-project`)
+3. =� Unpack the project to a local directory
+4. <� Your project is ready to go!
+
+## What You Get
+
+When you clone a MagicPath project, you'll get a complete local copy with:
+- All project files and assets
+- Configuration files
+- Dependencies and setup instructions
+- Ready-to-run codebase
+
+## Requirements
+
+- Node.js >=16.0.0
+- npm or yarn
+
+## How It Works
+
+1. **Access Key**: Each MagicPath project comes with a unique, one-time access key
+2. **Secure Download**: The CLI securely downloads your project from MagicPath servers
+3. **Local Setup**: Projects are extracted and set up in your chosen directory
+4. **Ready to Code**: Start editing, remixing, and building immediately
+
+## Troubleshooting
+
+### Invalid Access Key
+- Ensure your access key is correct and hasn't been used before
+- Access keys are single-use for security
+
+### Download Issues
+- Check your internet connection
+- Verify the access key hasn't expired
+- Use `--debug` flag for detailed error information
+
+### Permission Errors
+- Ensure you have write permissions in the current directory
+- Try running from a different directory
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/newcompute-ai/magicpath-node-cli/issues)
+- **Email**: [jack@magicpath.ai](mailto:jack@magicpath.ai)
+- **Website**: [magicpath.ai](https://magicpath.ai)
+
+## License
+
+MIT � Jack Beoris
+
+---
+
+Made with ( by the MagicPath team

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import prompts from 'prompts';
+import { program } from 'commander';
+import { z } from 'zod';
+import ora from 'ora';
+import { enableDebugLogger, logger } from './util/logger.js';
+import { downloadProject, releaseProject, unpackProject, } from './util/index.js';
+program.name('magicpath').description('CLI for MagicPath AI').version('1.0.0');
+const cloneOptionsSchema = z.object({
+    key: z.string(),
+    debug: z.boolean().default(false),
+});
+program
+    .command('clone')
+    .description('✨ Instantly bring your MagicPath project to your local playground. Edit, remix, and create in your own vibe.')
+    .requiredOption('-k, --key <accessKey>', '🔑 One-time magic access key to unlock and download your project')
+    .option('-d, --debug', 'Get verbose debug logs in the CLI')
+    .action(async (options) => {
+    let cloneOptions;
+    try {
+        cloneOptions = cloneOptionsSchema.parse(options);
+    }
+    catch {
+        throw new Error('Invalid CLI options for clone command.');
+    }
+    if (cloneOptions.debug)
+        enableDebugLogger();
+    logger.debug({ options });
+    logger.debug({ options: cloneOptions });
+    // Step 1: Download project
+    const downloadSpinner = ora('📥 Downloading project...').start();
+    try {
+        const filename = await downloadProject(cloneOptions.key);
+        logger.debug({ filename });
+        downloadSpinner.succeed('Project downloaded');
+        // Ask for project name
+        const response = await prompts({
+            type: 'text',
+            name: 'projectName',
+            message: 'What would you like to name your project?',
+            initial: 'magicpath-project',
+        });
+        if (!response.projectName) {
+            console.log('Project creation cancelled.');
+            releaseProject(filename);
+            return;
+        }
+        // Step 2: Unpack project
+        const unpackSpinner = ora('📦 Unpacking project...').start();
+        try {
+            unpackProject(filename, response.projectName);
+            unpackSpinner.succeed(`Project unpacked to ${response.projectName}`);
+        }
+        catch (error) {
+            unpackSpinner.fail('Failed to unpack project');
+            throw error;
+        }
+        console.log('\n🎉 Done! Your project is ready to go.');
+    }
+    catch (error) {
+        downloadSpinner.fail('Download failed');
+        throw error;
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/util/index.d.ts

@@ -0,0 +1,7 @@
+export declare enum APIVersion {
+    V1 = "v1"
+}
+export declare function makeUrl(verison: APIVersion, endpoint: string): string;
+export declare function downloadProject(key: string): Promise<string>;
+export declare function releaseProject(filename: string): void;
+export declare function unpackProject(filename: string, name: string): string;

package/dist/util/index.js

@@ -0,0 +1,65 @@
+import axios from 'axios';
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import AdmZip from 'adm-zip';
+import { v4 as uuidv4 } from 'uuid';
+const MAGICPATH_BASE_URL = 'https://api.magicpath.ai';
+export var APIVersion;
+(function (APIVersion) {
+    APIVersion["V1"] = "v1";
+})(APIVersion || (APIVersion = {}));
+export function makeUrl(verison, endpoint) {
+    return `${MAGICPATH_BASE_URL}/${verison}/${endpoint}`;
+}
+export async function downloadProject(key) {
+    const url = makeUrl(APIVersion.V1, 'components/repository');
+    const filename = `${uuidv4()}.zip`;
+    const filepath = path.join(os.tmpdir(), filename);
+    const response = await axios({
+        url,
+        params: { key },
+        method: 'GET',
+        responseType: 'stream',
+    });
+    await fs.ensureDir(path.dirname(filepath));
+    await new Promise(async (resolve, reject) => {
+        try {
+            response.data
+                .pipe(fs.createWriteStream(filepath))
+                .on('error', reject)
+                .once('close', () => resolve(filepath));
+        }
+        catch (err) {
+            reject(err);
+        }
+    });
+    return filepath;
+}
+export function releaseProject(filename) {
+    try {
+        fs.removeSync(filename);
+    }
+    catch {
+        // do nothing
+    }
+}
+export function unpackProject(filename, name) {
+    try {
+        let projectDir = path.join(process.cwd(), name);
+        let counter = 1;
+        while (fs.existsSync(projectDir)) {
+            counter++;
+            projectDir = path.join(process.cwd(), `${name}-${counter}`);
+        }
+        fs.mkdirSync(projectDir, { recursive: true });
+        const zip = new AdmZip(filename);
+        zip.extractAllTo(projectDir, true);
+        releaseProject(filename);
+        return projectDir;
+    }
+    catch (err) {
+        throw new Error('Failed to extract project. Please try again.');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

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

package/dist/util/logger.d.ts

@@ -0,0 +1,7 @@
+export declare function enableDebugLogger(): void;
+export declare const logger: {
+    info: (object: unknown) => void;
+    debug: (object: unknown) => void;
+    warn: (object: unknown) => void;
+    error: (object: unknown) => void;
+};

package/dist/util/logger.js

@@ -0,0 +1,21 @@
+import { pino } from 'pino';
+let defaultLogger = pino();
+export function enableDebugLogger() {
+    defaultLogger = pino({ level: 'debug' });
+    defaultLogger.debug({ message: 'DEBUG logger enabled. ' });
+}
+export const logger = {
+    info: (object) => {
+        defaultLogger.info(object);
+    },
+    debug: (object) => {
+        defaultLogger.debug(object);
+    },
+    warn: (object) => {
+        defaultLogger.warn(object);
+    },
+    error: (object) => {
+        defaultLogger.error(object);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;AAE3B,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,MAAe,EAAE,EAAE;QACxB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,EAAE,CAAC,MAAe,EAAE,EAAE;QACzB,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,EAAE,CAAC,MAAe,EAAE,EAAE;QACxB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,EAAE,CAAC,MAAe,EAAE,EAAE;QACzB,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "magicpath-ai",
+  "version": "1.0.0",
+  "description": "Node CLI for MagicPath",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "magicpath": "./dist/cli.js"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "tslint -p tsconfig.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run lint",
+    "preversion": "npm run lint",
+    "version": "npm run format && git add -A src",
+    "postversion": "git push && git push --tags"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/newcompute-ai/magicpath-node-cli.git"
+  },
+  "keywords": [
+    "magicpath",
+    "ai"
+  ],
+  "author": {
+    "email": "jack@magicpath.ai",
+    "name": "Jack Beoris",
+    "url": "https://magicpath.ai"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/magicpath-ai/magicpath-node-cli/issues"
+  },
+  "homepage": "https://github.com/newcompute-ai/magicpath-node-cli#readme",
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/fs-extra": "^11.0.4",
+    "@types/lodash": "^4.17.0",
+    "@types/prompts": "^2.4.9",
+    "@types/uuid": "^9.0.8",
+    "prettier": "^3.2.5",
+    "tslint": "^6.1.3",
+    "tslint-config-prettier": "^1.18.0",
+    "typescript": "^5.8.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "axios": "^1.9.0",
+    "commander": "^14.0.0",
+    "fs-extra": "^11.3.0",
+    "lodash": "^4.17.21",
+    "ora": "^8.2.0",
+    "pino": "^9.7.0",
+    "prompts": "^2.4.2",
+    "uuid": "^9.0.1",
+    "zod": "^3.25.36"
+  }
+}