zephyr-cli 0.0.2 → 0.1.0

package/.eslintignore

@@ -0,0 +1,3 @@
+# test folders to clone repositories
+test
+test*

package/.eslintrc.json

@@ -0,0 +1,22 @@
+{
+  "extends": ["../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "parserOptions": {
+    "sourceType": "module",
+    "ecmaVersion": 2020
+  },
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

package/LICENSE

@@ -1,21 +1,40 @@
-MIT License
-
-Copyright (c) 2024 Lois
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Apache License
+  Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+  TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+  1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+   ...
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!)  The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same line as the copyright notice for each file. The "copyright"
+ word should be left as is (without quotes).
+
+  Copyright [2023] [Zephyr Cloud]
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+

package/README.md

@@ -1,40 +1,113 @@
-# Zephyr CLI
+# zephyr-cli
 
-A command-line utility for Zephyr projects.
+CLI tool for running build commands and automatically uploading assets to Zephyr.
 
 ## Installation
 
-### Global Installation
-
 ```bash
-npm install -g zephyr
+npm install zephyr-cli
+# or
+pnpm add zephyr-cli
+# or
+yarn add zephyr-cli
 ```
 
-### Using npx
+## Usage
+
+### Run Command (Default)
+
+Run any build command and automatically upload the resulting assets:
 
 ```bash
-npx zephyr <command>
+ze-cli [options] <command>
 ```
 
-## Usage
+#### Examples
+
+```bash
+# Run npm scripts
+ze-cli pnpm build
+ze-cli yarn build
+ze-cli npm run build
 
-### Clean Cache
+# Run build tools directly
+ze-cli tsc
+ze-cli swc
+ze-cli esbuild --bundle
 
-Remove the Zephyr cache directory:
+# With environment variables
+ze-cli NODE_ENV=production webpack
 
-```bash
-zephyr clean cache
+# Mark as SSR build
+ze-cli --ssr pnpm build
 ```
 
-Or with npx:
+### Deploy Command
+
+Upload pre-built assets from a directory:
 
 ```bash
-npx zephyr clean cache
+ze-cli deploy <directory> [options]
 ```
 
-## Development
+#### Examples
 
 ```bash
-npm install
-npm run build
-```
+# Upload from ./dist directory
+ze-cli deploy ./dist
+
+# Upload with specific target
+ze-cli deploy ./dist --target ios
+
+# Mark as SSR
+ze-cli deploy ./dist --ssr
+```
+
+## Options
+
+- `--ssr` - Mark this snapshot as server-side rendered
+- `--target, -t <target>` - Build target: `web`, `ios`, or `android` (default: `web`)
+- `--verbose, -v` - Enable verbose output
+- `--help, -h` - Show help message
+
+## How It Works
+
+### Run Command
+
+1. **Parses the shell command** to detect the build tool and configuration files
+2. **Detects configuration files** (e.g., `package.json`, `tsconfig.json`, etc.)
+3. **Warns about dynamic configs** (e.g., JavaScript config files) and suggests alternatives
+4. **Runs the command** with full stdio passthrough
+5. **Infers the output directory** from the configuration
+6. **Uploads assets** to Zephyr automatically
+
+### Deploy Command
+
+1. **Extracts assets** from the specified directory
+2. **Uploads assets** to Zephyr's edge network
+
+## Build Tool Detection
+
+The CLI automatically detects configuration files for:
+
+- **npm/yarn/pnpm**: Reads `package.json` for scripts
+- **TypeScript (tsc)**: Reads `tsconfig.json` or the file specified with `-p` flag
+- **Other tools**: Basic detection and suggestions
+
+## Dynamic Configuration Warning
+
+If your build tool uses a JavaScript configuration file (e.g., `webpack.config.js`, `rollup.config.js`), the CLI will warn you that the configuration is too dynamic to analyze and suggest:
+
+- Using one of the Zephyr bundler plugins from `@libs/`
+- Using `ze-cli deploy <dir>` after building
+
+## Requirements
+
+- Node.js 18+ or 20+
+- A valid Zephyr authentication token (run `zephyr login` if needed)
+- A git repository (for application identification)
+- A `package.json` file (for application metadata)
+
+## License
+
+Apache-2.0

package/dist/cli.d.ts

@@ -0,0 +1,25 @@
+export interface CliOptions {
+    command: 'run' | 'deploy';
+    commandLine?: string;
+    directory?: string;
+    target?: 'web' | 'ios' | 'android';
+    verbose?: boolean;
+    ssr?: boolean;
+}
+/**
+ * Parse command line arguments.
+ *
+ * Syntax:
+ *
+ * - Ze-cli [options] <command> [args...] - run command (default)
+ * - Ze-cli deploy <directory> [options] - deploy command
+ *
+ * Examples:
+ *
+ * - Ze-cli --ssr pnpm build
+ * - Ze-cli tsc
+ * - Ze-cli NODE_ENV=production webpack
+ * - Ze-cli deploy ./dist
+ * - Ze-cli deploy ./dist --ssr
+ */
+export declare function parseArgs(args: string[]): CliOptions;

package/dist/cli.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+/**
+ * Parse command line arguments.
+ *
+ * Syntax:
+ *
+ * - Ze-cli [options] <command> [args...] - run command (default)
+ * - Ze-cli deploy <directory> [options] - deploy command
+ *
+ * Examples:
+ *
+ * - Ze-cli --ssr pnpm build
+ * - Ze-cli tsc
+ * - Ze-cli NODE_ENV=production webpack
+ * - Ze-cli deploy ./dist
+ * - Ze-cli deploy ./dist --ssr
+ */
+function parseArgs(args) {
+    const options = {
+        command: 'run', // Default to 'run'
+    };
+    // Find where flags end and the command/subcommand begins
+    let commandStartIndex = -1;
+    const flags = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg === '--version' || arg === '-v') {
+            // Version is handled by the caller
+            options.verbose = true;
+        }
+        else if (arg === '--ssr') {
+            options.ssr = true;
+            flags.push(arg);
+        }
+        else if (arg === '--target' || arg === '-t') {
+            const value = args[++i];
+            if (value && ['web', 'ios', 'android'].includes(value)) {
+                options.target = value;
+            }
+            flags.push(arg, value);
+        }
+        else if (arg === '--verbose') {
+            options.verbose = true;
+            flags.push(arg);
+        }
+        else if (!arg.startsWith('-')) {
+            // First non-flag argument
+            commandStartIndex = i;
+            break;
+        }
+    }
+    if (commandStartIndex === -1) {
+        printHelp();
+        process.exit(1);
+    }
+    const firstArg = args[commandStartIndex];
+    // Check if it's a subcommand
+    if (firstArg === 'deploy') {
+        options.command = 'deploy';
+        const directory = args[commandStartIndex + 1];
+        if (!directory) {
+            console.error('Error: deploy command requires a directory argument');
+            console.error('Usage: ze-cli deploy <directory> [options]');
+            process.exit(1);
+        }
+        options.directory = directory;
+        // Parse any additional flags after the directory
+        for (let i = commandStartIndex + 2; i < args.length; i++) {
+            const arg = args[i];
+            if (arg === '--ssr') {
+                options.ssr = true;
+            }
+            else if (arg === '--target' || arg === '-t') {
+                const value = args[++i];
+                if (value && ['web', 'ios', 'android'].includes(value)) {
+                    options.target = value;
+                }
+            }
+            else if (arg === '--verbose') {
+                options.verbose = true;
+            }
+        }
+    }
+    else {
+        // It's a run command - everything from commandStartIndex onwards is the command
+        options.command = 'run';
+        options.commandLine = args.slice(commandStartIndex).join(' ');
+    }
+    return options;
+}
+function printHelp() {
+    console.log(`
+Usage: ze-cli [options] <command> [args...]
+       ze-cli deploy <directory> [options]
+
+Run a build command and automatically upload assets to Zephyr, or deploy
+pre-built assets from a directory.
+
+Commands:
+  <command> [args...]      Run a build command and upload (default)
+  deploy <directory>       Upload pre-built assets from a directory
+
+Options:
+  --ssr                    Mark this snapshot as server-side rendered
+  --target, -t <target>    Build target: web, ios, or android (default: web)
+  --verbose                Enable verbose output
+  --help, -h               Show this help message
+
+Examples:
+  # Run build commands
+  ze-cli pnpm build
+  ze-cli yarn build
+  ze-cli tsc
+  ze-cli NODE_ENV=production webpack
+  ze-cli --ssr pnpm build
+
+  # Deploy pre-built assets
+  ze-cli deploy ./dist
+  ze-cli deploy ./dist --ssr
+  ze-cli deploy ./build --target ios
+
+How it works:
+  - For run commands, ze-cli executes your build command and automatically
+    detects the output directory to upload assets.
+  - For deploy commands, ze-cli uploads assets from the specified directory.
+  - All stdout/stderr from build commands are passed through.
+  - ze-cli logs are written to stderr only.
+
+Note: No configuration file is needed. Zephyr will automatically detect
+application information from your package.json and git repository.
+
+For more information: https://docs.zephyr-cloud.io/cli
+`);
+}
+//# 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/commands/deploy.d.ts

@@ -0,0 +1,12 @@
+export interface DeployOptions {
+    directory: string;
+    target?: 'web' | 'ios' | 'android';
+    verbose?: boolean;
+    ssr?: boolean;
+    cwd: string;
+}
+/**
+ * Deploy command: Upload pre-built assets from a directory to Zephyr. This is similar to
+ * the standalone zephyr-cli tool.
+ */
+export declare function deployCommand(options: DeployOptions): Promise<void>;

package/dist/commands/deploy.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployCommand = deployCommand;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const zephyr_agent_1 = require("zephyr-agent");
+const extract_assets_1 = require("../lib/extract-assets");
+const upload_1 = require("../lib/upload");
+/**
+ * Deploy command: Upload pre-built assets from a directory to Zephyr. This is similar to
+ * the standalone zephyr-cli tool.
+ */
+async function deployCommand(options) {
+    const { directory, target, verbose, ssr, cwd } = options;
+    // Resolve the directory path
+    const directoryPath = (0, node_path_1.resolve)(cwd, directory);
+    // Check if directory exists
+    try {
+        await (0, promises_1.access)(directoryPath, promises_1.constants.F_OK);
+    }
+    catch (_a) {
+        throw new zephyr_agent_1.ZephyrError(zephyr_agent_1.ZeErrors.ERR_UNKNOWN, {
+            message: `Directory does not exist: ${directoryPath}`,
+        });
+    }
+    if (verbose) {
+        (0, zephyr_agent_1.logFn)('info', `Uploading assets from: ${directoryPath}`);
+    }
+    // Initialize ZephyrEngine with project root context
+    const zephyr_engine = await zephyr_agent_1.ZephyrEngine.create({
+        builder: 'unknown',
+        context: cwd,
+    });
+    // Set build target if specified
+    if (target) {
+        zephyr_engine.env.target = target;
+    }
+    // Set SSR flag if specified
+    if (ssr) {
+        zephyr_engine.env.ssr = true;
+    }
+    // Extract assets from the directory
+    if (verbose) {
+        (0, zephyr_agent_1.logFn)('info', 'Extracting assets from directory...');
+    }
+    const assetsMap = await (0, extract_assets_1.extractAssetsFromDirectory)(directoryPath);
+    if (verbose) {
+        const assetCount = Object.keys(assetsMap).length;
+        (0, zephyr_agent_1.logFn)('info', `Found ${assetCount} assets to upload`);
+    }
+    // Upload assets
+    await (0, upload_1.uploadAssets)({
+        zephyr_engine,
+        assetsMap,
+    });
+    if (verbose) {
+        (0, zephyr_agent_1.logFn)('info', 'Upload completed successfully');
+    }
+}
+//# sourceMappingURL=deploy.js.map

package/dist/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":";;AAkBA,sCAuDC;AAzED,+CAAqD;AACrD,yCAAoC;AACpC,+CAA0E;AAC1E,0DAAmE;AACnE,0CAA6C;AAU7C;;;GAGG;AACI,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAEzD,6BAA6B;IAC7B,MAAM,aAAa,GAAG,IAAA,mBAAO,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,IAAA,iBAAM,EAAC,aAAa,EAAE,oBAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAAC,WAAM,CAAC;QACP,MAAM,IAAI,0BAAW,CAAC,uBAAQ,CAAC,WAAW,EAAE;YAC1C,OAAO,EAAE,6BAA6B,aAAa,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,IAAA,oBAAK,EAAC,MAAM,EAAE,0BAA0B,aAAa,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,oDAAoD;IACpD,MAAM,aAAa,GAAG,MAAM,2BAAY,CAAC,MAAM,CAAC;QAC9C,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,GAAG;KACb,CAAC,CAAC;IAEH,gCAAgC;IAChC,IAAI,MAAM,EAAE,CAAC;QACX,aAAa,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpC,CAAC;IAED,4BAA4B;IAC5B,IAAI,GAAG,EAAE,CAAC;QACR,aAAa,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED,oCAAoC;IACpC,IAAI,OAAO,EAAE,CAAC;QACZ,IAAA,oBAAK,EAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAA,2CAA0B,EAAC,aAAa,CAAC,CAAC;IAElE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QACjD,IAAA,oBAAK,EAAC,MAAM,EAAE,SAAS,UAAU,mBAAmB,CAAC,CAAC;IACxD,CAAC;IAED,gBAAgB;IAChB,MAAM,IAAA,qBAAY,EAAC;QACjB,aAAa;QACb,SAAS;KACV,CAAC,CAAC;IAEH,IAAI,OAAO,EAAE,CAAC;QACZ,IAAA,oBAAK,EAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,9 @@
+export interface RunOptions {
+    commandLine: string;
+    target?: 'web' | 'ios' | 'android';
+    verbose?: boolean;
+    ssr?: boolean;
+    cwd: string;
+}
+/** Run command: Execute a build command and automatically upload the resulting assets. */
+export declare function runCommand(options: RunOptions): Promise<void>;

package/dist/commands/run.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCommand = runCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const zephyr_agent_1 = require("zephyr-agent");
+const command_detector_1 = require("../lib/command-detector");
+const extract_assets_1 = require("../lib/extract-assets");
+const shell_parser_1 = require("../lib/shell-parser");
+const spawn_helper_1 = require("../lib/spawn-helper");
+const upload_1 = require("../lib/upload");
+/** Run command: Execute a build command and automatically upload the resulting assets. */
+async function runCommand(options) {
+    var _a;
+    const { commandLine, target, verbose, ssr, cwd } = options;
+    // Log to stderr so it doesn't interfere with command output
+    const log = (level, message) => {
+        if (level === 'info' && !verbose) {
+            return;
+        }
+        // All ze-cli logs go to stderr
+        console.error(`[ze-cli] ${message}`);
+    };
+    // Parse the shell command - check if there are multiple commands
+    log('info', `Parsing command: ${commandLine}`);
+    const individualCommands = (0, shell_parser_1.splitCommands)(commandLine);
+    if (individualCommands.length > 1) {
+        log('info', `Detected ${individualCommands.length} commands to execute`);
+    }
+    // Detect multiple commands and their output directories
+    const multiDetection = await (0, command_detector_1.detectMultipleCommands)(commandLine, cwd);
+    const { commands: detectedCommands, outputDirs, commonOutputDir } = multiDetection;
+    // Log detected tools
+    // Flatten commands if there are sub-commands
+    const allCommands = [];
+    for (const detected of detectedCommands) {
+        if (detected.subCommands && detected.subCommands.length > 0) {
+            // If there are sub-commands, log them instead of the parent
+            allCommands.push(...detected.subCommands);
+        }
+        else {
+            allCommands.push(detected);
+        }
+    }
+    for (let i = 0; i < allCommands.length; i++) {
+        const detected = allCommands[i];
+        log('info', `Command ${i + 1}: ${detected.tool}`);
+        if (detected.configFile) {
+            log('info', `  Config file: ${detected.configFile}`);
+        }
+        if (detected.outputDir) {
+            const absoluteOutputDir = (0, node_path_1.resolve)(cwd, detected.outputDir);
+            log('info', `  Output directory: ${(0, node_path_1.relative)(cwd, absoluteOutputDir) || '.'}`);
+        }
+    }
+    // If multiple output directories detected, show common ancestor
+    if (outputDirs.length > 1 && commonOutputDir) {
+        log('info', `Multiple output directories detected, using common ancestor: ${(0, node_path_1.relative)(cwd, commonOutputDir) || '.'}`);
+    }
+    // Warn about dynamic configs
+    if (!outputDirs.length) {
+        console.error('[ze-cli] WARNING: Configuration is too dynamic to analyze!');
+        console.error('[ze-cli] ');
+        console.error('[ze-cli] Your build tool uses a JavaScript configuration file that cannot be');
+        console.error('[ze-cli] statically analyzed. This means ze-cli cannot automatically');
+        console.error('[ze-cli] detect the output directory.');
+        console.error('[ze-cli] ');
+        console.error('[ze-cli] Recommendations:');
+        console.error('[ze-cli] 1. Use a Zephyr bundler plugin:');
+        console.error('[ze-cli]    - @zephyrcloud/webpack-plugin');
+        console.error('[ze-cli]    - @zephyrcloud/rollup-plugin');
+        console.error('[ze-cli]    - @zephyrcloud/vite-plugin');
+        console.error('[ze-cli]    - etc.');
+        console.error('[ze-cli] 2. Or use "ze-cli deploy <dir>" after building');
+        console.error('[ze-cli] ');
+        console.error('[ze-cli] For more info: https://docs.zephyr-cloud.io/integrations');
+        console.error('[ze-cli] ');
+    }
+    // Display warnings from all commands
+    for (const detected of detectedCommands) {
+        if (detected.warnings.length > 0 && !detected.isDynamicConfig) {
+            for (const warning of detected.warnings) {
+                console.error(`[ze-cli] Warning: ${warning}`);
+            }
+        }
+    }
+    // Execute all build commands sequentially
+    for (let i = 0; i < individualCommands.length; i++) {
+        const cmd = individualCommands[i];
+        log('info', `Executing command ${i + 1}/${individualCommands.length}: ${cmd}`);
+        try {
+            const parsed = (0, shell_parser_1.parseShellCommand)(cmd);
+            const result = await (0, spawn_helper_1.executeCommand)(parsed, cwd);
+            if (result.exitCode !== 0) {
+                throw new zephyr_agent_1.ZephyrError(zephyr_agent_1.ZeErrors.ERR_UNKNOWN, {
+                    message: `Build command failed with exit code ${result.exitCode}`,
+                });
+            }
+            log('info', `Command ${i + 1} completed successfully`);
+        }
+        catch (error) {
+            throw new zephyr_agent_1.ZephyrError(zephyr_agent_1.ZeErrors.ERR_UNKNOWN, {
+                message: `Failed to execute command: ${cmd}\n${error.message}`,
+            });
+        }
+    }
+    log('info', 'All build commands completed successfully');
+    // Determine which output directory to use
+    let outputDir = null;
+    if (commonOutputDir) {
+        outputDir = commonOutputDir;
+    }
+    else if (detectedCommands.length === 1 && detectedCommands[0].outputDir) {
+        outputDir = (0, node_path_1.resolve)(cwd, detectedCommands[0].outputDir);
+    }
+    // If we couldn't detect the output directory, stop here
+    if (!outputDir) {
+        console.error('[ze-cli] ');
+        console.error('[ze-cli] Could not detect output directory. Skipping upload.');
+        console.error('[ze-cli] Please use "ze-cli deploy <dir>" to upload manually.');
+        console.error('[ze-cli] ');
+        return;
+    }
+    log('info', `Using output directory: ${(0, node_path_1.relative)(cwd, outputDir) || '.'}`);
+    // Check if output directory exists
+    if (!(0, node_fs_1.existsSync)(outputDir)) {
+        throw new zephyr_agent_1.ZephyrError(zephyr_agent_1.ZeErrors.ERR_UNKNOWN, {
+            message: `Output directory does not exist: ${outputDir}`,
+        });
+    }
+    // Determine the primary build tool for ZephyrEngine
+    const primaryTool = ((_a = detectedCommands[0]) === null || _a === void 0 ? void 0 : _a.tool) || 'unknown';
+    // Initialize ZephyrEngine with project root context
+    log('info', 'Initializing Zephyr Engine...');
+    const zephyr_engine = await zephyr_agent_1.ZephyrEngine.create({
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        builder: primaryTool,
+        context: cwd,
+    });
+    // Set build target if specified
+    if (target) {
+        zephyr_engine.env.target = target;
+    }
+    // Set SSR flag if specified
+    if (ssr) {
+        zephyr_engine.env.ssr = true;
+    }
+    // Extract assets from the output directory
+    log('info', 'Extracting assets from output directory...');
+    const assetsMap = await (0, extract_assets_1.extractAssetsFromDirectory)(outputDir);
+    const assetCount = Object.keys(assetsMap).length;
+    log('info', `Found ${assetCount} assets to upload`);
+    // Upload assets
+    log('info', 'Uploading assets to Zephyr...');
+    await (0, upload_1.uploadAssets)({
+        zephyr_engine,
+        assetsMap,
+    });
+    log('info', 'Upload completed successfully');
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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