nport 2.0.7 → 2.1.1

package/dist/types/analytics.js

@@ -0,0 +1,8 @@
+/**
+ * Analytics type definitions
+ *
+ * These types define the structure of analytics events
+ * and tracking data.
+ */
+export {};
+//# sourceMappingURL=analytics.js.map

package/dist/types/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/config.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Configuration type definitions
+ *
+ * These types define the structure of application configuration,
+ * user preferences, and runtime settings.
+ */
+/**
+ * Parsed command-line arguments
+ */
+export interface ParsedArguments {
+    /** Local port to tunnel (default: 8080) */
+    port: number;
+    /** Subdomain to use (generated if not provided) */
+    subdomain: string;
+    /** Language code, 'prompt', or null */
+    language: string | null;
+    /** Custom backend URL or null */
+    backendUrl: string | null;
+    /** Backend URL to save, 'clear', or null */
+    setBackend: string | null;
+}
+/**
+ * User configuration stored in ~/.nport/config.json
+ */
+export interface UserConfig {
+    /** Preferred language code (e.g., "en", "vi") */
+    language?: string;
+    /** Custom backend URL */
+    backendUrl?: string;
+}
+/**
+ * Application constants configuration
+ */
+export interface AppConfig {
+    /** npm package name */
+    PACKAGE_NAME: string;
+    /** Current package version */
+    CURRENT_VERSION: string;
+    /** Backend API URL */
+    BACKEND_URL: string;
+    /** Default port if not specified */
+    DEFAULT_PORT: number;
+    /** Prefix for random subdomains */
+    SUBDOMAIN_PREFIX: string;
+    /** Auto-cleanup timeout in hours */
+    TUNNEL_TIMEOUT_HOURS: number;
+    /** Timeout for npm version check in ms */
+    UPDATE_CHECK_TIMEOUT: number;
+}
+/**
+ * Platform-specific configuration
+ */
+export interface PlatformConfig {
+    /** True if running on Windows */
+    IS_WINDOWS: boolean;
+    /** Binary filename ("cloudflared" or "cloudflared.exe") */
+    BIN_NAME: string;
+}
+/**
+ * File system paths configuration
+ */
+export interface PathsConfig {
+    /** Directory containing the cloudflared binary */
+    BIN_DIR: string;
+    /** Full path to the cloudflared binary */
+    BIN_PATH: string;
+}
+/**
+ * Log pattern categories for filtering cloudflared output
+ */
+export interface LogPatterns {
+    /** Patterns indicating successful connection */
+    readonly SUCCESS: readonly string[];
+    /** Patterns indicating critical errors */
+    readonly ERROR: readonly string[];
+    /** Patterns for network connectivity issues */
+    readonly NETWORK_WARNING: readonly string[];
+    /** Patterns for harmless messages to suppress */
+    readonly IGNORE: readonly string[];
+}
+/**
+ * Network warning display configuration
+ */
+export interface NetworkConfig {
+    /** Number of errors before showing warning */
+    WARNING_THRESHOLD: number;
+    /** Minimum ms between warnings */
+    WARNING_COOLDOWN: number;
+}

package/dist/types/config.js

@@ -0,0 +1,8 @@
+/**
+ * Configuration type definitions
+ *
+ * These types define the structure of application configuration,
+ * user preferences, and runtime settings.
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/i18n.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Internationalization type definitions
+ */
+/**
+ * Supported language codes
+ */
+export type LanguageCode = 'en' | 'vi';
+/**
+ * Translation keys used in the application
+ */
+export interface TranslationKeys {
+    header: string;
+    creatingTunnel: string;
+    checkingUpdates: string;
+    tunnelLive: string;
+    connection1: string;
+    connection2: string;
+    timeRemaining: string;
+    footerTitle: string;
+    footerSubtitle: string;
+    dropStar: string;
+    sendCoffee: string;
+    newVersion: string;
+    updateCommand: string;
+    tunnelShutdown: string;
+    cleaningUp: string;
+    cleanupDone: string;
+    cleanupFailed: string;
+    subdomainReleased: string;
+    serverBusy: string;
+    goodbyeTitle: string;
+    goodbyeMessage: string;
+    website: string;
+    author: string;
+    changeLanguage: string;
+    changeLanguageHint: string;
+    versionTitle: string;
+    versionSubtitle: string;
+    versionLatest: string;
+    versionAvailable: string;
+    versionUpdate: string;
+    learnMore: string;
+    languagePrompt: string;
+    languageQuestion: string;
+    languageEnglish: string;
+    languageVietnamese: string;
+    languageInvalid: string;
+    languageSaved: string;
+    networkIssueTitle: string;
+    networkIssueDesc: string;
+    networkIssueTunnel: string;
+    networkIssueReasons: string;
+    networkIssueReason1: string;
+    networkIssueReason2: string;
+    networkIssueReason3: string;
+    networkIssueFix: string;
+    networkIssueFix1: string;
+    networkIssueFix2: string;
+    networkIssueFix3: string;
+    networkIssueFix4: string;
+    networkIssueIgnore: string;
+}
+/**
+ * Translation dictionary for all languages
+ */
+export type Translations = Record<LanguageCode, TranslationKeys>;
+/**
+ * Variables that can be substituted in translation strings
+ */
+export interface TranslationVariables {
+    port?: number;
+    hours?: number;
+    version?: string;
+    [key: string]: string | number | undefined;
+}

package/dist/types/i18n.js

@@ -0,0 +1,5 @@
+/**
+ * Internationalization type definitions
+ */
+export {};
+//# sourceMappingURL=i18n.js.map

package/dist/types/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/types/i18n.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * NPort - Shared Types
+ *
+ * Central export for all type definitions used across the application.
+ */
+export type { TunnelConfig, TunnelResponse, ApiResponse, CreateTunnelApiResponse, TunnelState, ShutdownReason, TunnelEvent, } from './tunnel.js';
+export type { ParsedArguments, UserConfig, AppConfig, PlatformConfig, PathsConfig, LogPatterns, NetworkConfig, } from './config.js';
+export type { AnalyticsEvent, CliStartEventParams, TunnelCreatedEventParams, TunnelErrorEventParams, TunnelShutdownEventParams, UpdateAvailableEventParams, SystemInfo, GA4Payload, } from './analytics.js';
+export type { UpdateCheckResult, NpmPackageInfo, } from './version.js';
+export type { LanguageCode, TranslationKeys, Translations, TranslationVariables, } from './i18n.js';

package/dist/types/index.js

@@ -0,0 +1,7 @@
+/**
+ * NPort - Shared Types
+ *
+ * Central export for all type definitions used across the application.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/tunnel.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Tunnel-related type definitions
+ *
+ * These types define the data structures used for tunnel creation,
+ * management, and communication between CLI and backend.
+ */
+/**
+ * Configuration for creating a new tunnel
+ */
+export interface TunnelConfig {
+    /** Local port to tunnel (e.g., 3000) */
+    port: number;
+    /** Subdomain to use (e.g., "myapp" for myapp.nport.link) */
+    subdomain: string;
+    /** Custom backend URL or null for default */
+    backendUrl: string | null;
+    /** Language code or null for default */
+    language: string | null;
+}
+/**
+ * Response from the backend after creating a tunnel
+ */
+export interface TunnelResponse {
+    /** UUID of the created tunnel */
+    tunnelId: string;
+    /** Base64-encoded token for cloudflared authentication */
+    tunnelToken: string;
+    /** Full HTTPS URL of the tunnel (e.g., "https://myapp.nport.link") */
+    url: string;
+}
+/**
+ * Backend API response wrapper
+ */
+export interface ApiResponse<T = unknown> {
+    /** Whether the request was successful */
+    success: boolean;
+    /** Error message if success is false */
+    error?: string;
+    /** Response data if success is true */
+    data?: T;
+}
+/**
+ * Create tunnel API response
+ */
+export interface CreateTunnelApiResponse extends ApiResponse {
+    tunnelId?: string;
+    tunnelToken?: string;
+    url?: string;
+}
+/**
+ * Tunnel state information
+ */
+export interface TunnelState {
+    /** UUID of the current tunnel */
+    tunnelId: string | null;
+    /** Current subdomain */
+    subdomain: string | null;
+    /** Local port being tunneled */
+    port: number | null;
+    /** Custom backend URL */
+    backendUrl: string | null;
+    /** Number of established connections */
+    connectionCount: number;
+    /** Timestamp when tunnel was created */
+    startTime: number | null;
+}
+/**
+ * Shutdown reason types
+ */
+export type ShutdownReason = 'manual' | 'timeout' | 'error';
+/**
+ * Tunnel lifecycle events
+ */
+export type TunnelEvent = 'created' | 'connected' | 'disconnected' | 'error' | 'shutdown';

package/dist/types/tunnel.js

@@ -0,0 +1,8 @@
+/**
+ * Tunnel-related type definitions
+ *
+ * These types define the data structures used for tunnel creation,
+ * management, and communication between CLI and backend.
+ */
+export {};
+//# sourceMappingURL=tunnel.js.map

package/dist/types/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../../src/types/tunnel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/version.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Version-related type definitions
+ */
+/**
+ * Result of checking for updates
+ */
+export interface UpdateCheckResult {
+    /** Currently installed version */
+    current: string;
+    /** Latest version available on npm */
+    latest: string;
+    /** True if latest > current */
+    shouldUpdate: boolean;
+}
+/**
+ * npm registry package response (partial)
+ */
+export interface NpmPackageInfo {
+    /** Package name */
+    name: string;
+    /** Latest version */
+    version: string;
+    /** Package description */
+    description?: string;
+}

package/dist/types/version.js

@@ -0,0 +1,5 @@
+/**
+ * Version-related type definitions
+ */
+export {};
+//# sourceMappingURL=version.js.map

package/dist/types/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/types/version.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/ui.d.ts

@@ -0,0 +1,54 @@
+import type { UpdateCheckResult } from './types/index.js';
+/**
+ * UI Display Manager
+ *
+ * Handles all console output and user interface formatting.
+ */
+export declare class UI {
+    /**
+     * Displays the project info header box.
+     */
+    static displayProjectInfo(): void;
+    /**
+     * Displays the startup banner.
+     */
+    static displayStartupBanner(_port: number): void;
+    /**
+     * Displays the tunnel success message.
+     */
+    static displayTunnelSuccess(url: string, _port: number, _updateInfo: UpdateCheckResult | null): void;
+    /**
+     * Displays the footer with call-to-action links.
+     */
+    static displayFooter(updateInfo: UpdateCheckResult | null): void;
+    /**
+     * Displays timeout warning.
+     */
+    static displayTimeoutWarning(): void;
+    /**
+     * Displays an error message.
+     */
+    static displayError(error: Error, spinner?: {
+        fail: (msg: string) => void;
+    } | null): void;
+    /**
+     * Displays cleanup start.
+     */
+    static displayCleanupStart(): void;
+    /**
+     * Displays cleanup success.
+     */
+    static displayCleanupSuccess(): void;
+    /**
+     * Displays cleanup error.
+     */
+    static displayCleanupError(): void;
+    /**
+     * Displays goodbye message.
+     */
+    static displayGoodbye(): void;
+    /**
+     * Displays version information.
+     */
+    static displayVersion(current: string, updateInfo: UpdateCheckResult | null): void;
+}

package/dist/ui.js

@@ -0,0 +1,120 @@
+import chalk from 'chalk';
+import { GITHUB_URL, COFFEE_URL, WEBSITE_URL } from './constants.js';
+import { CONFIG } from './config.js';
+import { lang } from './lang.js';
+/**
+ * UI Display Manager
+ *
+ * Handles all console output and user interface formatting.
+ */
+export class UI {
+    /**
+     * Displays the project info header box.
+     */
+    static displayProjectInfo() {
+        const line = '─'.repeat(56);
+        const headerText = lang.t('header');
+        const visualLength = 59;
+        const padding = ' '.repeat(Math.max(0, visualLength - headerText.length - 4));
+        console.log(chalk.gray(`\n ╭${line}╮`));
+        console.log(chalk.cyan.bold(` │  ${headerText}`) + padding + chalk.gray('│'));
+        console.log(chalk.gray(` ╰${line}╯\n`));
+    }
+    /**
+     * Displays the startup banner.
+     */
+    static displayStartupBanner(_port) {
+        this.displayProjectInfo();
+    }
+    /**
+     * Displays the tunnel success message.
+     */
+    static displayTunnelSuccess(url, _port, _updateInfo) {
+        console.log();
+        console.log(chalk.cyan.bold(`   👉  ${url}  👈\n`));
+        console.log(chalk.gray('   ' + '─'.repeat(54) + '\n'));
+        console.log(chalk.gray(`   ${lang.t('timeRemaining', { hours: CONFIG.TUNNEL_TIMEOUT_HOURS })}\n`));
+    }
+    /**
+     * Displays the footer with call-to-action links.
+     */
+    static displayFooter(updateInfo) {
+        console.log(chalk.gray('   ' + '─'.repeat(54) + '\n'));
+        console.log(chalk.yellow.bold(`   ${lang.t('footerTitle')}\n`));
+        console.log(chalk.gray(`      ${lang.t('footerSubtitle')}\n`));
+        console.log(chalk.cyan(`   ${lang.t('dropStar')}`) + chalk.white(GITHUB_URL));
+        console.log(chalk.yellow(`   ${lang.t('sendCoffee')}`) + chalk.white(COFFEE_URL));
+        if (updateInfo?.shouldUpdate) {
+            console.log(chalk.red.bold(`\n   ${lang.t('newVersion', { version: updateInfo.latest })}`));
+            console.log(chalk.gray('      ') + chalk.cyan(lang.t('updateCommand')));
+        }
+        console.log();
+    }
+    /**
+     * Displays timeout warning.
+     */
+    static displayTimeoutWarning() {
+        console.log(chalk.yellow(`\n⏰ Tunnel has been running for ${CONFIG.TUNNEL_TIMEOUT_HOURS} hours.`));
+        console.log(chalk.yellow('   Automatically shutting down...'));
+    }
+    /**
+     * Displays an error message.
+     */
+    static displayError(error, spinner = null) {
+        if (spinner) {
+            spinner.fail('Failed to connect to server.');
+        }
+        console.error(chalk.red(error.message));
+    }
+    /**
+     * Displays cleanup start.
+     */
+    static displayCleanupStart() {
+        console.log(chalk.red.bold(`\n\n   ${lang.t('tunnelShutdown')}\n`));
+        process.stdout.write(chalk.gray(`      ${lang.t('cleaningUp')}`));
+    }
+    /**
+     * Displays cleanup success.
+     */
+    static displayCleanupSuccess() {
+        console.log(chalk.green(lang.t('cleanupDone')));
+        console.log(chalk.gray(`      ${lang.t('subdomainReleased')}\n`));
+        this.displayGoodbye();
+    }
+    /**
+     * Displays cleanup error.
+     */
+    static displayCleanupError() {
+        console.log(chalk.red(lang.t('cleanupFailed')));
+        console.log(chalk.gray(`      ${lang.t('serverBusy')}\n`));
+        this.displayGoodbye();
+    }
+    /**
+     * Displays goodbye message.
+     */
+    static displayGoodbye() {
+        console.log(chalk.gray('   ' + '─'.repeat(54) + '\n'));
+        console.log(chalk.cyan.bold(`   ${lang.t('goodbyeTitle')}\n`));
+        console.log(chalk.gray(`      ${lang.t('goodbyeMessage')}\n`));
+        console.log(chalk.cyan(`      ${lang.t('website')}`) + chalk.white(WEBSITE_URL));
+        console.log(chalk.cyan(`      ${lang.t('author')}`) + chalk.white('Nick Pham (https://github.com/tuanngocptn)'));
+        console.log(chalk.cyan(`      ${lang.t('changeLanguage')}`) + chalk.yellow(lang.t('changeLanguageHint')));
+        console.log();
+    }
+    /**
+     * Displays version information.
+     */
+    static displayVersion(current, updateInfo) {
+        console.log(chalk.cyan.bold(`\n${lang.t('versionTitle', { version: current })}`));
+        console.log(chalk.gray(`${lang.t('versionSubtitle')}\n`));
+        if (updateInfo?.shouldUpdate) {
+            console.log(chalk.yellow(lang.t('versionAvailable', { version: updateInfo.latest })));
+            console.log(chalk.cyan(lang.t('versionUpdate')) + chalk.white('npm install -g nport@latest\n'));
+        }
+        else {
+            console.log(chalk.green(`${lang.t('versionLatest')}\n`));
+        }
+        console.log(chalk.gray(lang.t('learnMore')) + chalk.cyan(`${WEBSITE_URL}\n`));
+    }
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,16 @@
+import type { UpdateCheckResult } from './types/index.js';
+/**
+ * Version Manager
+ *
+ * Handles version checking and update notifications.
+ */
+export declare class VersionManager {
+    /**
+     * Checks the npm registry for available updates.
+     */
+    static checkForUpdates(): Promise<UpdateCheckResult | null>;
+    /**
+     * Compares two semantic version strings.
+     */
+    static compareVersions(v1: string, v2: string): number;
+}

package/dist/version.js

@@ -0,0 +1,49 @@
+import axios from 'axios';
+import { CONFIG } from './config.js';
+import { analytics } from './analytics.js';
+/**
+ * Version Manager
+ *
+ * Handles version checking and update notifications.
+ */
+export class VersionManager {
+    /**
+     * Checks the npm registry for available updates.
+     */
+    static async checkForUpdates() {
+        try {
+            const response = await axios.get(`https://registry.npmjs.org/${CONFIG.PACKAGE_NAME}/latest`, { timeout: CONFIG.UPDATE_CHECK_TIMEOUT });
+            const latestVersion = response.data.version;
+            const shouldUpdate = this.compareVersions(latestVersion, CONFIG.CURRENT_VERSION) > 0;
+            if (shouldUpdate) {
+                analytics.trackUpdateAvailable(CONFIG.CURRENT_VERSION, latestVersion);
+            }
+            return {
+                current: CONFIG.CURRENT_VERSION,
+                latest: latestVersion,
+                shouldUpdate,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Compares two semantic version strings.
+     */
+    static compareVersions(v1, v2) {
+        const parts1 = v1.split('.').map(Number);
+        const parts2 = v2.split('.').map(Number);
+        const maxLength = Math.max(parts1.length, parts2.length);
+        for (let i = 0; i < maxLength; i++) {
+            const part1 = parts1[i] || 0;
+            const part2 = parts2[i] || 0;
+            if (part1 > part2)
+                return 1;
+            if (part1 < part2)
+                return -1;
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAC9B,8BAA8B,MAAM,CAAC,YAAY,SAAS,EAC1D,EAAE,OAAO,EAAE,MAAM,CAAC,oBAAoB,EAAE,CACzC,CAAC;YAEF,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAErF,IAAI,YAAY,EAAE,CAAC;gBACjB,SAAS,CAAC,oBAAoB,CAAC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;YACxE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,eAAe;gBAC/B,MAAM,EAAE,aAAa;gBACrB,YAAY;aACb,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,EAAU,EAAE,EAAU;QAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAE7B,IAAI,KAAK,GAAG,KAAK;gBAAE,OAAO,CAAC,CAAC;YAC5B,IAAI,KAAK,GAAG,KAAK;gBAAE,OAAO,CAAC,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "nport",
-  "version": "2.0.7",
+  "version": "2.1.1",
   "description": "Free & open source ngrok alternative - Tunnel HTTP/HTTPS connections via Cloudflare Edge with custom subdomains",
   "type": "module",
-  "main": "index.js",
+  "main": "dist/index.js",
   "bin": {
-    "nport": "index.js"
+    "nport": "dist/index.js"
   },
   "engines": {
     "node": ">=20.0.0",
@@ -63,17 +63,28 @@
     }
   ],
   "scripts": {
-    "postinstall": "node src/bin-manager.js",
-    "start": "node index.js"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "postinstall": "node scripts/postinstall.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
   },
   "dependencies": {
     "axios": "^1.13.2",
     "chalk": "^5.6.2",
     "ora": "^9.0.0"
   },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "~3.2.0"
+  },
   "files": [
-    "index.js",
-    "src/",
+    "dist/",
+    "bin/",
+    "scripts/",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"