@nexical/cli 0.1.0 → 0.1.2

package/dist/{chunk-FDJVHO4O.js → chunk-JDRAVUKK.js}

@@ -5,9 +5,14 @@ import { NexicalClient } from "@nexical/sdk";
 import fs from "fs";
 import path from "path";
 import os from "os";
-var CONFIG_DIR = path.join(os.homedir(), ".nexical");
-var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+var getConfigPaths = () => {
+  const HOME = process.env.HOME || os.homedir();
+  const CONFIG_DIR = path.join(HOME, ".nexical");
+  const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+  return { CONFIG_DIR, CONFIG_FILE };
+};
 function getConfig() {
+  const { CONFIG_FILE } = getConfigPaths();
   if (!fs.existsSync(CONFIG_FILE)) {
     return {};
   }
@@ -19,6 +24,7 @@ function getConfig() {
   }
 }
 function saveToken(token) {
+  const { CONFIG_DIR, CONFIG_FILE } = getConfigPaths();
   if (!fs.existsSync(CONFIG_DIR)) {
     fs.mkdirSync(CONFIG_DIR, { recursive: true });
   }
@@ -29,7 +35,8 @@ function saveToken(token) {
 function getClient() {
   const config = getConfig();
   return new NexicalClient({
-    token: config.token
+    token: config.token,
+    baseURL: process.env.NEXICAL_API_URL
   });
 }
 
@@ -38,4 +45,4 @@ export {
   saveToken,
   getClient
 };
-//# sourceMappingURL=chunk-FDJVHO4O.js.map
+//# sourceMappingURL=chunk-JDRAVUKK.js.map

package/dist/chunk-JDRAVUKK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/nexical-client.ts"],"sourcesContent":["\nimport { NexicalClient } from '@nexical/sdk';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\n\nconst getConfigPaths = () => {\n    const HOME = process.env.HOME || os.homedir();\n    const CONFIG_DIR = path.join(HOME, '.nexical');\n    const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');\n    return { CONFIG_DIR, CONFIG_FILE };\n};\n\ninterface Config {\n    token?: string;\n}\n\nexport function getConfig(): Config {\n    const { CONFIG_FILE } = getConfigPaths();\n    if (!fs.existsSync(CONFIG_FILE)) {\n        return {};\n    }\n    try {\n        const content = fs.readFileSync(CONFIG_FILE, 'utf-8');\n        return JSON.parse(content);\n    } catch (error) {\n        return {};\n    }\n}\n\nexport function saveToken(token: string) {\n    const { CONFIG_DIR, CONFIG_FILE } = getConfigPaths();\n    if (!fs.existsSync(CONFIG_DIR)) {\n        fs.mkdirSync(CONFIG_DIR, { recursive: true });\n    }\n    const config = getConfig();\n    config.token = token;\n    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));\n}\n\nexport function getClient(): NexicalClient {\n    const config = getConfig();\n    return new NexicalClient({\n        token: config.token,\n        baseURL: process.env.NEXICAL_API_URL,\n    });\n}\n"],"mappings":";;;AACA,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,OAAO,QAAQ;AAEf,IAAM,iBAAiB,MAAM;AACzB,QAAM,OAAO,QAAQ,IAAI,QAAQ,GAAG,QAAQ;AAC5C,QAAM,aAAa,KAAK,KAAK,MAAM,UAAU;AAC7C,QAAM,cAAc,KAAK,KAAK,YAAY,aAAa;AACvD,SAAO,EAAE,YAAY,YAAY;AACrC;AAMO,SAAS,YAAoB;AAChC,QAAM,EAAE,YAAY,IAAI,eAAe;AACvC,MAAI,CAAC,GAAG,WAAW,WAAW,GAAG;AAC7B,WAAO,CAAC;AAAA,EACZ;AACA,MAAI;AACA,UAAM,UAAU,GAAG,aAAa,aAAa,OAAO;AACpD,WAAO,KAAK,MAAM,OAAO;AAAA,EAC7B,SAAS,OAAO;AACZ,WAAO,CAAC;AAAA,EACZ;AACJ;AAEO,SAAS,UAAU,OAAe;AACrC,QAAM,EAAE,YAAY,YAAY,IAAI,eAAe;AACnD,MAAI,CAAC,GAAG,WAAW,UAAU,GAAG;AAC5B,OAAG,UAAU,YAAY,EAAE,WAAW,KAAK,CAAC;AAAA,EAChD;AACA,QAAM,SAAS,UAAU;AACzB,SAAO,QAAQ;AACf,KAAG,cAAc,aAAa,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AACjE;AAEO,SAAS,YAA2B;AACvC,QAAM,SAAS,UAAU;AACzB,SAAO,IAAI,cAAc;AAAA,IACrB,OAAO,OAAO;AAAA,IACd,SAAS,QAAQ,IAAI;AAAA,EACzB,CAAC;AACL;","names":[]}

package/dist/src/commands/admin/create-user.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/admin/create-user.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/branch/create.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/branch/create.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/branch/delete.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/branch/delete.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/branch/get.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/branch/get.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/branch/list.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/branch/list.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/job/get.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/job/get.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/job/list.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/job/list.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/job/logs.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/job/logs.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/job/trigger.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/job/trigger.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/login.js

@@ -2,7 +2,7 @@ import { createRequire } from "module"; const require = createRequire(import.met
 import {
   getClient,
   saveToken
-} from "../../chunk-FDJVHO4O.js";
+} from "../../chunk-JDRAVUKK.js";
 
 // src/commands/login.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/project/create.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/project/create.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/project/delete.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/project/delete.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/project/get.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/project/get.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/project/list.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/project/list.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/project/update.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/project/update.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/team/create.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/team/create.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/team/delete.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/team/delete.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/team/get.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/team/get.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/team/list.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/team/list.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/team/member/invite.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../../chunk-FDJVHO4O.js";
+} from "../../../../chunk-JDRAVUKK.js";
 
 // src/commands/team/member/invite.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/team/member/remove.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../../chunk-FDJVHO4O.js";
+} from "../../../../chunk-JDRAVUKK.js";
 
 // src/commands/team/member/remove.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/team/update.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/team/update.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/token/generate.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/token/generate.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/token/list.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/token/list.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/token/revoke.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../../chunk-FDJVHO4O.js";
+} from "../../../chunk-JDRAVUKK.js";
 
 // src/commands/token/revoke.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/commands/whoami.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module"; const require = createRequire(import.meta.url);
 import {
   getClient
-} from "../../chunk-FDJVHO4O.js";
+} from "../../chunk-JDRAVUKK.js";
 
 // src/commands/whoami.ts
 import { BaseCommand } from "@nexical/cli-core";

package/dist/src/utils/nexical-client.js

@@ -3,7 +3,7 @@ import {
   getClient,
   getConfig,
   saveToken
-} from "../../chunk-FDJVHO4O.js";
+} from "../../chunk-JDRAVUKK.js";
 export {
   getClient,
   getConfig,

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@nexical/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "bin": {
-    "astrical": "./dist/index.js"
+    "nexical": "./dist/index.js"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
     "start": "node dist/index.js",
-    "test": "npm run test:unit && npm run test:integration",
+    "test": "npm run test:unit && npm run test:integration && npm run test:e2e",
     "test:unit": "vitest run --config vitest.config.ts --coverage",
     "test:integration": "vitest run --config vitest.integration.config.ts",
     "test:e2e": "npm run build && vitest run --config vitest.e2e.config.ts",
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@nexical/cli-core": "^0.1.4",
+    "@nexical/cli-core": "^0.1.5",
     "@nexical/sdk": "^0.4.2"
   },
   "devDependencies": {
@@ -29,4 +29,4 @@
     "typescript": "^5.3.3",
     "vitest": "^4.0.15"
   }
-}
+}

package/src/utils/nexical-client.ts

@@ -4,14 +4,19 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 
-const CONFIG_DIR = path.join(os.homedir(), '.nexical');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const getConfigPaths = () => {
+    const HOME = process.env.HOME || os.homedir();
+    const CONFIG_DIR = path.join(HOME, '.nexical');
+    const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+    return { CONFIG_DIR, CONFIG_FILE };
+};
 
 interface Config {
     token?: string;
 }
 
 export function getConfig(): Config {
+    const { CONFIG_FILE } = getConfigPaths();
     if (!fs.existsSync(CONFIG_FILE)) {
         return {};
     }
@@ -24,6 +29,7 @@ export function getConfig(): Config {
 }
 
 export function saveToken(token: string) {
+    const { CONFIG_DIR, CONFIG_FILE } = getConfigPaths();
     if (!fs.existsSync(CONFIG_DIR)) {
         fs.mkdirSync(CONFIG_DIR, { recursive: true });
     }
@@ -36,5 +42,6 @@ export function getClient(): NexicalClient {
     const config = getConfig();
     return new NexicalClient({
         token: config.token,
+        baseURL: process.env.NEXICAL_API_URL,
     });
 }

package/test/e2e/auth.e2e.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+import { runCLI, TEST_HOME } from './utils.js';
+import { resetMockStore } from './setup.js';
+import fs from 'fs-extra';
+import path from 'path';
+
+describe('Authentication E2E', () => {
+    // Isolate config for tests
+    const TEST_CONFIG_DIR = path.join(TEST_HOME, '.nexical');
+    const TEST_CONFIG_FILE = path.join(TEST_CONFIG_DIR, 'config.json');
+
+    beforeAll(async () => {
+        resetMockStore();
+        // Clean up any existing config
+        if (await fs.pathExists(TEST_CONFIG_FILE)) {
+            await fs.remove(TEST_CONFIG_FILE);
+        }
+    });
+
+    it('should show not logged in initially', async () => {
+        const { stdout } = await runCLI(['whoami']);
+        expect(stdout).toContain('Not logged in or token expired');
+    });
+
+    it('should login successfully', async () => {
+        // Simulate login
+        // Since login is interactive (browser open), we might mock the open module or 
+        // just trust runCLI can handle the non-interactive part until the prompt.
+        // However, key to this test is that we can MANUALLY set the token via CLI 
+        // OR we just simulate the token save if the CLI doesn't support non-interactive login easily.
+
+        // For E2E of the CLI 'login' command specifically, it's hard without a browser.
+        // But we can verify "whoami" works IF we have a token.
+
+        // Let's manually inject a token to simulate a successful login state for now
+        // as true E2E of OAuth device flow requires browser automation which is out of scope.
+
+        await fs.mkdirp(TEST_CONFIG_DIR);
+        await fs.writeJSON(TEST_CONFIG_FILE, { token: 'mock-access-token' });
+
+        const { stdout } = await runCLI(['whoami']);
+        expect(stdout).toContain('Logged in as:');
+        expect(stdout).toContain('Name:  Test User');
+        expect(stdout).toContain('Email: test@example.com');
+    });
+});

package/test/e2e/job-workflow.e2e.test.ts

@@ -0,0 +1,33 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+import { runCLI } from './utils.js';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { resetMockStore } from './setup.js';
+
+describe('Job Workflow E2E', () => {
+    const TEST_CONFIG_DIR = path.join(os.homedir(), '.nexical');
+    const TEST_CONFIG_FILE = path.join(TEST_CONFIG_DIR, 'config.json');
+
+    beforeAll(async () => {
+        resetMockStore();
+        resetMockStore();
+        // Ensure logged in
+        await fs.mkdirp(TEST_CONFIG_DIR);
+        await fs.writeJSON(TEST_CONFIG_FILE, { token: 'mock-access-token' });
+    });
+
+    it('should trigger a job', async () => {
+        // We use "3" as branchId (must be numeric for CLI validation)
+        const { stdout } = await runCLI(['job', 'trigger', '1', '101', '3', 'deploy']);
+        expect(stdout).toContain('Job 123 triggered successfully!');
+        expect(stdout).toContain('Status: pending');
+    });
+
+    it('should get job logs', async () => {
+        const { stdout } = await runCLI(['job', 'logs', '1', '101', '3', '123']);
+        expect(stdout).toContain('Logs for Job 123:');
+        expect(stdout).toContain('Build initialized');
+        expect(stdout).toContain('Build successful');
+    });
+});

package/test/e2e/project-lifecycle.e2e.test.ts

@@ -0,0 +1,48 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+import { runCLI } from './utils.js';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { resetMockStore } from './setup.js';
+
+describe('Project Lifecycle E2E', () => {
+    const TEST_CONFIG_DIR = path.join(os.homedir(), '.nexical');
+    const TEST_CONFIG_FILE = path.join(TEST_CONFIG_DIR, 'config.json');
+
+    beforeAll(async () => {
+        resetMockStore();
+        // Ensure logged intMockStore();
+        // Ensure logged in
+        await fs.mkdirp(TEST_CONFIG_DIR);
+        await fs.writeJSON(TEST_CONFIG_FILE, { token: 'mock-access-token' });
+    });
+
+    it('should create a new project', async () => {
+        const { stdout } = await runCLI(['project', 'create', '1', 'My Project', '--repo', 'https://github.com/test/repo']);
+        expect(stdout).toContain('Project "My Project" set up successfully!');
+        expect(stdout).toContain('ID: 101');
+    });
+
+    it('should list projects', async () => {
+        const { stdout } = await runCLI(['project', 'list', '1']);
+        expect(stdout).toContain('Projects in Team 1:');
+        expect(stdout).toContain('My Project (ID: 101)');
+    });
+
+    it('should update project', async () => {
+        const { stdout } = await runCLI(['project', 'update', '1', '101', '--name', 'Updated Project']);
+        // Note: The CLI success message format depends on command impl.
+        expect(stdout).toContain('Project 101 updated!');
+        // expect(stdout).toContain('Name: Updated Project'); // CLI might not print details
+    });
+
+    it('should delete project', async () => {
+        const { stdout } = await runCLI(['project', 'delete', '1', '101', '--confirm']);
+        expect(stdout).toContain('Project 101 deleted.');
+    });
+
+    it('should verify deletion', async () => {
+        const { stdout } = await runCLI(['project', 'list', '1']);
+        expect(stdout).not.toContain('ID: 101');
+    });
+});

package/test/e2e/setup.ts

@@ -0,0 +1,237 @@
+import { beforeAll, afterAll } from 'vitest';
+import http from 'http';
+
+const MOCK_PORT = 3333;
+export const TEST_API_URL = `http://localhost:${MOCK_PORT}`;
+
+// Simple in-memory mock store
+export const mockStore = {
+    users: [] as any[],
+    tokens: [] as any[],
+    teams: [] as any[],
+    projects: [] as any[],
+    jobs: [] as any[],
+};
+
+export const resetMockStore = () => {
+    mockStore.users = [];
+    mockStore.tokens = [];
+    mockStore.teams = [
+        { id: 1, name: 'My Team', slug: 'my-team' }
+    ];
+    mockStore.projects = [];
+    mockStore.jobs = [];
+};
+
+const server = http.createServer((req, res) => {
+    const { method, url } = req;
+    let body = '';
+
+    req.on('data', chunk => {
+        body += chunk.toString();
+    });
+
+    req.on('end', () => {
+        let parsedBody: any = {};
+        try {
+            if (body) parsedBody = JSON.parse(body);
+        } catch (e) {
+            // ignore
+        }
+
+        console.log(`[MOCK API] ${method} ${url}`, parsedBody);
+
+        res.setHeader('Content-Type', 'application/json');
+
+        // --- Mock Routes ---
+
+        // AUTH
+        if (method === 'POST' && url === '/auth/device') {
+            res.writeHead(200);
+            res.end(JSON.stringify({ deviceCode: '1234', userCode: 'ABCD-1234', verificationUrl: 'http://localhost:3000/verify' }));
+            return;
+        }
+
+        if (method === 'POST' && url === '/auth/token') {
+            res.writeHead(200);
+            res.end(JSON.stringify({ accessToken: 'mock-access-token', refreshToken: 'mock-refresh-token' }));
+            return;
+        }
+
+        if (method === 'POST' && url === '/auth/logout') {
+            res.writeHead(200);
+            res.end(JSON.stringify({ success: true }));
+            return;
+        }
+
+        // Auth
+        if (method === 'GET' && url === '/users/me') {
+            const authHeader = req.headers['authorization'];
+            const token = authHeader?.split(' ')[1];
+
+            if (!token || token === 'expired') {
+                res.writeHead(401);
+                res.end(JSON.stringify({ error: 'Unauthorized' }));
+                return;
+            }
+
+            const user = mockStore.users[0] || {
+                id: '123e4567-e89b-12d3-a456-426614174000', // Valid UUID
+                email: 'test@example.com',
+                fullName: 'Test User',
+                avatarUrl: null,
+                role: 'user',
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString()
+            };
+
+            // Wrap in { user: ... }
+            res.writeHead(200);
+            res.end(JSON.stringify({ user }));
+            return;
+        }
+
+        // PROJECTS
+        if (method === 'POST' && url === '/teams/1/projects') {
+            const newProject = {
+                id: 101, // SDK expects number
+                teamId: 1,
+                name: parsedBody.name,
+                repoUrl: parsedBody.repoUrl || null,
+                productionUrl: null,
+                contextHash: null,
+                mode: 'managed',
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            };
+            mockStore.projects.push(newProject);
+
+            // Wrap in { project: ... }
+            res.writeHead(201);
+            res.end(JSON.stringify({ project: newProject }));
+            return;
+        }
+
+        if (method === 'GET' && url === '/teams/1/projects') {
+            // Wrap in { projects: ... }
+            res.writeHead(200);
+            res.end(JSON.stringify({ projects: mockStore.projects }));
+            return;
+        }
+
+        if (method === 'PUT' && url?.match(/\/teams\/1\/projects\/\d+$/)) {
+            const id = parseInt(url.split('/').pop() || '0');
+            const project = mockStore.projects.find((p: any) => p.id === id);
+            if (project) {
+                // Update logic mimicking body parse (simplification)
+                // content-length usually small in tests
+                // For now, return existing or updated stub
+                project.name = 'Updated Project'; // Hardcode for test expectation
+                res.writeHead(200);
+                res.end(JSON.stringify({ project }));
+                return;
+            }
+            res.writeHead(404);
+            res.end('Not Found');
+            return;
+        }
+
+        if (method === 'DELETE' && url?.match(/\/teams\/1\/projects\/\d+$/)) {
+            const id = parseInt(url.split('/').pop() || '0');
+            const index = mockStore.projects.findIndex((p: any) => p.id === id);
+            if (index !== -1) {
+                mockStore.projects.splice(index, 1);
+                res.writeHead(200);
+                res.end(JSON.stringify({ message: 'Project deleted' }));
+            } else {
+                res.writeHead(404);
+                res.end(JSON.stringify({ message: "Not Found" }));
+            }
+            return;
+        }
+
+        // TEAMS
+        if (method === 'GET' && url === '/teams/1') {
+            // Return team 1 mock
+            res.writeHead(200);
+            res.end(JSON.stringify({
+                id: 1,
+                name: 'My Team',
+                slug: 'my-team',
+                billingPlan: 'free',
+                creditsBalance: 100,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                role: 'owner'
+            }));
+            return;
+        }
+
+        // Jobs
+        if (method === 'POST' && url?.includes('/jobs') && !url.includes('/logs')) {
+            const newJob = {
+                id: 123,
+                branchId: 3,
+                type: 'deploy',
+                status: 'pending',
+                queue: 'public',
+                inputs: null,
+                outputs: null,
+                assignedFactoryId: null,
+                startedAt: null,
+                completedAt: null,
+                createdAt: new Date().toISOString(),
+            };
+            mockStore.jobs.push(newJob);
+            // Wrap in { job: ... }
+            res.writeHead(201);
+            res.end(JSON.stringify({ job: newJob }));
+            return;
+        }
+
+        // Logs
+        if (method === 'GET' && url?.includes('/logs')) {
+            const stubLogs = [
+                {
+                    id: 1,
+                    jobId: 123,
+                    level: 'info',
+                    message: 'Build initialized',
+                    metadata: null,
+                    timestamp: new Date().toISOString()
+                },
+                {
+                    id: 2,
+                    jobId: 123,
+                    level: 'info',
+                    message: 'Build successful',
+                    metadata: null,
+                    timestamp: new Date().toISOString()
+                }
+            ];
+            // Wrap in { logs: ... }
+            res.writeHead(200);
+            res.end(JSON.stringify({ logs: stubLogs }));
+            return;
+        }
+
+        // Default 404
+        res.writeHead(404);
+        res.end(JSON.stringify({ message: 'Not Found' }));
+    });
+});
+
+beforeAll(async () => {
+    return new Promise<void>((resolve) => {
+        server.listen(MOCK_PORT, () => {
+            console.log(`Mock API running on port ${MOCK_PORT}`);
+            resolve();
+        });
+    });
+});
+
+afterAll(async () => {
+    return new Promise<void>((resolve) => {
+        server.close(() => resolve());
+    });
+});

package/test/e2e/utils.ts

@@ -0,0 +1,33 @@
+import path from "path";
+import { execa } from "execa";
+import { fileURLToPath } from "node:url";
+import os from 'os';
+import fs from 'fs-extra';
+
+// Constants
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const CLI_BIN = path.resolve(__dirname, '../../dist/index.js');
+const TEST_API_URL = 'http://localhost:3333';
+export const TEST_HOME = path.resolve(__dirname, '../../test-home');
+
+// Ensure test home exists
+if (!fs.existsSync(TEST_HOME)) {
+    fs.mkdirpSync(TEST_HOME);
+}
+
+/**
+ * Runs the CLI command against the compiled binary (E2E style)
+ */
+export async function runCLI(args: string[], options: any = {}) {
+    return execa("node", [CLI_BIN, ...args], {
+        cwd: options.cwd || process.cwd(),
+        ...options,
+        env: {
+            ...process.env,
+            NEXICAL_API_URL: TEST_API_URL, // Point to Mock API
+            HOME: TEST_HOME, // Isolate config
+            ...options.env,
+        },
+        reject: false, // Allow checking exit code in tests
+    });
+}

package/test/unit/utils/nexical-client.test.ts

@@ -10,7 +10,7 @@ vi.mock('node:fs');
 vi.mock('node:fs');
 vi.mock('node:os', () => ({
     default: {
-        homedir: () => '/home/user'
+        homedir: vi.fn(() => '/home/user')
     }
 }));
 vi.mock('@nexical/sdk');
@@ -22,9 +22,24 @@ describe('nexical-client', () => {
 
     beforeEach(() => {
         vi.resetAllMocks();
+        vi.stubEnv('HOME', '/home/user');
         // os.homedir is already mocked by factory
     });
 
+    afterEach(() => {
+        vi.unstubAllEnvs();
+    });
+
+    it('should use os.homedir() if HOME env var is not set', () => {
+        vi.unstubAllEnvs();
+        vi.stubEnv('HOME', '');
+
+        // Trigger path resolution
+        getConfig();
+
+        expect(os.homedir).toHaveBeenCalled();
+    });
+
     describe('getConfig', () => {
         it('should return empty object if config file does not exist', () => {
             vi.mocked(fs.existsSync).mockReturnValue(false);

package/vitest.e2e.config.ts

@@ -6,5 +6,6 @@ export default defineConfig({
         environment: 'node',
         include: ['test/e2e/**/*.test.ts'],
         testTimeout: 60000,
+        fileParallelism: false,
     },
 });

package/dist/chunk-FDJVHO4O.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/nexical-client.ts"],"sourcesContent":["\nimport { NexicalClient } from '@nexical/sdk';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\n\nconst CONFIG_DIR = path.join(os.homedir(), '.nexical');\nconst CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');\n\ninterface Config {\n    token?: string;\n}\n\nexport function getConfig(): Config {\n    if (!fs.existsSync(CONFIG_FILE)) {\n        return {};\n    }\n    try {\n        const content = fs.readFileSync(CONFIG_FILE, 'utf-8');\n        return JSON.parse(content);\n    } catch (error) {\n        return {};\n    }\n}\n\nexport function saveToken(token: string) {\n    if (!fs.existsSync(CONFIG_DIR)) {\n        fs.mkdirSync(CONFIG_DIR, { recursive: true });\n    }\n    const config = getConfig();\n    config.token = token;\n    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));\n}\n\nexport function getClient(): NexicalClient {\n    const config = getConfig();\n    return new NexicalClient({\n        token: config.token,\n    });\n}\n"],"mappings":";;;AACA,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,OAAO,QAAQ;AAEf,IAAM,aAAa,KAAK,KAAK,GAAG,QAAQ,GAAG,UAAU;AACrD,IAAM,cAAc,KAAK,KAAK,YAAY,aAAa;AAMhD,SAAS,YAAoB;AAChC,MAAI,CAAC,GAAG,WAAW,WAAW,GAAG;AAC7B,WAAO,CAAC;AAAA,EACZ;AACA,MAAI;AACA,UAAM,UAAU,GAAG,aAAa,aAAa,OAAO;AACpD,WAAO,KAAK,MAAM,OAAO;AAAA,EAC7B,SAAS,OAAO;AACZ,WAAO,CAAC;AAAA,EACZ;AACJ;AAEO,SAAS,UAAU,OAAe;AACrC,MAAI,CAAC,GAAG,WAAW,UAAU,GAAG;AAC5B,OAAG,UAAU,YAAY,EAAE,WAAW,KAAK,CAAC;AAAA,EAChD;AACA,QAAM,SAAS,UAAU;AACzB,SAAO,QAAQ;AACf,KAAG,cAAc,aAAa,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AACjE;AAEO,SAAS,YAA2B;AACvC,QAAM,SAAS,UAAU;AACzB,SAAO,IAAI,cAAc;AAAA,IACrB,OAAO,OAAO;AAAA,EAClB,CAAC;AACL;","names":[]}

package/test/utils/integration-helpers.ts

@@ -1,22 +0,0 @@
-import path from "node:path";
-import { execa } from "execa";
-import { fileURLToPath } from "node:url";
-
-// Constants
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export const CLI_BIN = path.resolve(__dirname, "../../dist/index.js");
-
-/**
- * Runs the CLI command against the compiled binary (E2E style)
- */
-export async function runCLI(args: string[], cwd: string, options: any = {}) {
-  return execa("node", [CLI_BIN, ...args], {
-    cwd,
-    ...options,
-    env: {
-      ...process.env,
-      ...options.env,
-    },
-    reject: false, // Allow checking exit code in tests
-  });
-}