@jetstart/shared 1.1.1

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@jetstart/shared",
+  "version": "1.1.1",
+  "description": "Shared types, protocols, and utilities for JetStart",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "jetstart",
+    "shared",
+    "types",
+    "protocols"
+  ],
+  "author": "Phantom",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dev-phantom/jetstart.git",
+    "directory": "packages/shared"
+  },
+  "bugs": {
+    "url": "https://github.com/dev-phantom/jetstart/issues"
+  },
+  "homepage": "https://github.com/dev-phantom/jetstart#readme",
+  "devDependencies": {
+    "@types/jest": "29.5.14",
+    "@types/node": "^20.10.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "5.9.3"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "roots": [
+      "<rootDir>/tests"
+    ],
+    "testMatch": [
+      "**/*.test.ts"
+    ],
+    "collectCoverageFrom": [
+      "src/**/*.ts",
+      "!src/**/*.d.ts",
+      "!src/**/index.ts"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 70,
+        "functions": 70,
+        "lines": 70,
+        "statements": 70
+      }
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+// Export all types
+export * from './types';
+
+// Export all protocols
+export * from './protocols';
+
+// Export all utils
+export * from './utils';

package/src/protocols/events.ts

@@ -0,0 +1,50 @@
+/**
+ * Event System
+ * Event types for internal communication within packages
+ */
+
+export interface JetStartEvent<T = any> {
+  type: string;
+  payload: T;
+  timestamp: number;
+}
+
+/**
+ * CLI Events
+ */
+export type CLIEvent =
+  | { type: 'cli:command:start'; payload: { command: string; args: string[] } }
+  | { type: 'cli:command:complete'; payload: { command: string; success: boolean } }
+  | { type: 'cli:command:error'; payload: { command: string; error: string } };
+
+/**
+ * Core Events
+ */
+export type CoreEvent =
+  | { type: 'core:server:start'; payload: { port: number } }
+  | { type: 'core:server:stop'; payload: {} }
+  | { type: 'core:session:created'; payload: { sessionId: string } }
+  | { type: 'core:session:ended'; payload: { sessionId: string } }
+  | { type: 'core:build:queued'; payload: { sessionId: string } }
+  | { type: 'core:build:started'; payload: { sessionId: string } }
+  | { type: 'core:build:completed'; payload: { sessionId: string; duration: number } }
+  | { type: 'core:build:failed'; payload: { sessionId: string; error: string } };
+
+/**
+ * Client Events
+ */
+export type ClientEvent =
+  | { type: 'client:connected'; payload: { sessionId: string } }
+  | { type: 'client:disconnected'; payload: { sessionId: string } }
+  | { type: 'client:apk:downloaded'; payload: { apkPath: string; size: number } }
+  | { type: 'client:apk:installed'; payload: { packageName: string } }
+  | { type: 'client:app:launched'; payload: { packageName: string } };
+
+/**
+ * Event emitter interface
+ */
+export interface EventEmitter {
+  on(event: string, handler: (data: any) => void): void;
+  off(event: string, handler: (data: any) => void): void;
+  emit(event: string, data: any): void;
+}

package/src/protocols/index.ts

@@ -0,0 +1,3 @@
+// Re-export all protocol definitions
+export * from './websocket';
+export * from './events';

package/src/protocols/websocket.ts

@@ -0,0 +1,149 @@
+/**
+ * WebSocket Protocol
+ * Message types for real-time communication between Core, Client, and Logs
+ */
+
+import {
+  DeviceInfo,
+  SessionStatus,
+  BuildStatus,
+  LogEntry,
+  APKInfo,
+} from '../types/index';
+
+/**
+ * Base message structure
+ */
+export interface BaseMessage {
+  type: string;
+  timestamp: number;
+  sessionId?: string;
+}
+
+/**
+ * Messages from Client to Core
+ */
+export type ClientMessage =
+  | ClientConnectMessage
+  | ClientStatusMessage
+  | ClientLogMessage
+  | ClientHeartbeatMessage
+  | ClientDisconnectMessage;
+
+export interface ClientConnectMessage extends BaseMessage {
+  type: 'client:connect';
+  sessionId: string;
+  token: string;
+  deviceInfo: DeviceInfo;
+}
+
+export interface ClientStatusMessage extends BaseMessage {
+  type: 'client:status';
+  status: SessionStatus;
+  message?: string;
+}
+
+export interface ClientLogMessage extends BaseMessage {
+  type: 'client:log';
+  log: LogEntry;
+}
+
+export interface ClientHeartbeatMessage extends BaseMessage {
+  type: 'client:heartbeat';
+}
+
+export interface ClientDisconnectMessage extends BaseMessage {
+  type: 'client:disconnect';
+  reason?: string;
+}
+
+/**
+ * Messages from Core to Client
+ */
+export type CoreMessage =
+  | CoreConnectedMessage
+  | CoreBuildStartMessage
+  | CoreBuildStatusMessage
+  | CoreBuildCompleteMessage
+  | CoreBuildErrorMessage
+  | CoreReloadMessage
+  | CoreUIUpdateMessage
+  | CoreDisconnectMessage;
+
+export interface CoreConnectedMessage extends BaseMessage {
+  type: 'core:connected';
+  sessionId: string;
+  projectName: string;
+}
+
+export interface CoreBuildStartMessage extends BaseMessage {
+  type: 'core:build-start';
+}
+
+export interface CoreBuildStatusMessage extends BaseMessage {
+  type: 'core:build-status';
+  status: BuildStatus;
+}
+
+export interface CoreBuildCompleteMessage extends BaseMessage {
+  type: 'core:build-complete';
+  apkInfo: APKInfo;
+  downloadUrl: string;
+}
+
+export interface CoreBuildErrorMessage extends BaseMessage {
+  type: 'core:build-error';
+  error: string;
+  details?: any;
+}
+
+export interface CoreReloadMessage extends BaseMessage {
+  type: 'core:reload';
+  reloadType: 'full' | 'hot';
+}
+
+export interface CoreUIUpdateMessage extends BaseMessage {
+  type: 'core:ui-update';
+  dslContent: string;
+  screens?: string[];
+  hash?: string;
+}
+
+export interface CoreDisconnectMessage extends BaseMessage {
+  type: 'core:disconnect';
+  reason: string;
+}
+
+/**
+ * Union type of all messages
+ */
+export type WSMessage = ClientMessage | CoreMessage;
+
+/**
+ * WebSocket connection state
+ */
+export enum WSState {
+  CONNECTING = 'connecting',
+  CONNECTED = 'connected',
+  DISCONNECTING = 'disconnecting',
+  DISCONNECTED = 'disconnected',
+  ERROR = 'error',
+}
+
+/**
+ * WebSocket error types
+ */
+export interface WSError {
+  code: WSErrorCode;
+  message: string;
+  timestamp: number;
+}
+
+export enum WSErrorCode {
+  CONNECTION_FAILED = 'connection_failed',
+  AUTHENTICATION_FAILED = 'authentication_failed',
+  TIMEOUT = 'timeout',
+  INVALID_MESSAGE = 'invalid_message',
+  SESSION_EXPIRED = 'session_expired',
+  UNKNOWN = 'unknown',
+}

package/src/types/build.ts

@@ -0,0 +1,85 @@
+/**
+ * Build System Types
+ * Types related to compilation, building, and APK generation
+ */
+
+export interface BuildConfig {
+  projectPath: string;
+  outputPath: string;
+  buildType: BuildType;
+  minifyEnabled: boolean;
+  debuggable: boolean;
+  versionCode: number;
+  versionName: string;
+  applicationId: string;
+}
+
+export enum BuildType {
+  DEBUG = 'debug',
+  RELEASE = 'release',
+}
+
+export interface BuildResult {
+  success: boolean;
+  apkPath?: string;
+  apkSize?: number;
+  buildTime: number;
+  errors?: BuildError[];
+  warnings?: BuildWarning[];
+}
+
+export interface BuildError {
+  file: string;
+  line: number;
+  column: number;
+  message: string;
+  severity: ErrorSeverity;
+}
+
+export interface BuildWarning {
+  message: string;
+  file?: string;
+  line?: number;
+}
+
+export enum ErrorSeverity {
+  ERROR = 'error',
+  WARNING = 'warning',
+  INFO = 'info',
+}
+
+export interface BuildStatus {
+  phase: BuildPhase;
+  progress: number; // 0-100
+  message: string;
+  timestamp: number;
+}
+
+export enum BuildPhase {
+  IDLE = 'idle',
+  INITIALIZING = 'initializing',
+  COMPILING = 'compiling',
+  PACKAGING = 'packaging',
+  SIGNING = 'signing',
+  OPTIMIZING = 'optimizing',
+  COMPLETE = 'complete',
+  FAILED = 'failed',
+}
+
+export interface APKInfo {
+  path: string;
+  size: number;
+  hash: string;
+  versionCode: number;
+  versionName: string;
+  minSdkVersion: number;
+  targetSdkVersion: number;
+  applicationId: string;
+}
+
+export interface CacheInfo {
+  enabled: boolean;
+  size: number;
+  lastCleared: number;
+  hitRate: number;
+}

package/src/types/device.ts

@@ -0,0 +1,50 @@
+/**
+ * Device Information Types
+ * Device and platform-related information
+ */
+
+export interface DeviceInfo {
+  id: string;
+  name: string;
+  model: string;
+  manufacturer: string;
+  platform: Platform;
+  osVersion: string;
+  apiLevel: number;
+  screenResolution: ScreenResolution;
+  density: number;
+  isEmulator: boolean;
+  architecture: Architecture;
+  locale: string;
+  timezone: string;
+}
+
+export enum Platform {
+  ANDROID = 'android',
+  WEB = 'web',
+}
+
+export interface ScreenResolution {
+  width: number;
+  height: number;
+}
+
+export enum Architecture {
+  ARM64_V8A = 'arm64-v8a',
+  ARMEABI_V7A = 'armeabi-v7a',
+  X86 = 'x86',
+  X86_64 = 'x86_64',
+}
+
+export interface NetworkInfo {
+  ipAddress: string;
+  networkType: NetworkType;
+  isConnected: boolean;
+}
+
+export enum NetworkType {
+  WIFI = 'wifi',
+  CELLULAR = 'cellular',
+  ETHERNET = 'ethernet',
+  UNKNOWN = 'unknown',
+}

package/src/types/index.ts

@@ -0,0 +1,5 @@
+// Re-export all type definitions
+export * from './session';
+export * from './build';
+export * from './device';
+export * from './log';

package/src/types/log.ts

@@ -0,0 +1,51 @@
+/**
+ * Logging Types
+ * Types for the logging system
+ */
+
+export interface LogEntry {
+  id: string;
+  timestamp: number;
+  level: LogLevel;
+  tag: string;
+  message: string;
+  source: LogSource;
+  sessionId?: string;
+  metadata?: Record<string, any>;
+}
+
+export enum LogLevel {
+  VERBOSE = 'verbose',
+  DEBUG = 'debug',
+  INFO = 'info',
+  WARN = 'warn',
+  ERROR = 'error',
+  FATAL = 'fatal',
+}
+
+export enum LogSource {
+  CLI = 'cli',
+  CORE = 'core',
+  CLIENT = 'client',
+  BUILD = 'build',
+  NETWORK = 'network',
+  SYSTEM = 'system',
+}
+
+export interface LogFilter {
+  levels?: LogLevel[];
+  sources?: LogSource[];
+  tags?: string[];
+  searchQuery?: string;
+  startTime?: number;
+  endTime?: number;
+}
+
+export interface LogStats {
+  totalLogs: number;
+  errorCount: number;
+  warningCount: number;
+  lastLogTime: number;
+  logsByLevel: Record<LogLevel, number>;
+  logsBySource: Record<LogSource, number>;
+}

package/src/types/session.ts

@@ -0,0 +1,57 @@
+/**
+ * Session Management Types
+ * Used for tracking and managing development sessions between Core and Client
+ */
+
+import { DeviceInfo } from "./device";
+
+export interface Session {
+  id: string;
+  projectName: string;
+  projectPath: string;
+  deviceId: string;
+  deviceInfo: DeviceInfo;
+  createdAt: number;
+  lastActivity: number;
+  status: SessionStatus;
+  connectionType: ConnectionType;
+}
+
+export enum SessionStatus {
+  PENDING = 'pending',
+  CONNECTED = 'connected',
+  BUILDING = 'building',
+  READY = 'ready',
+  ERROR = 'error',
+  DISCONNECTED = 'disconnected',
+}
+
+export enum ConnectionType {
+  MINIMAL = 'minimal', // Manual APK installation
+  FASTER = 'faster', // ADB over TCP
+}
+
+export interface SessionConfig {
+  enableHotReload: boolean;
+  enableLogs: boolean;
+  autoReconnect: boolean;
+  buildOnSave: boolean;
+  port: number;
+}
+
+export interface SessionToken {
+  sessionId: string;
+  token: string;
+  expiresAt: number;
+  serverUrl: string;
+  wsUrl: string;
+}
+
+export interface QRCodeData {
+  sessionId: string;
+  serverUrl: string;
+  wsUrl: string;
+  token: string;
+  projectName: string;
+  version: string;
+}

package/src/utils/constants.ts

@@ -0,0 +1,135 @@
+/**
+ * Constants and Configuration
+ * Shared constants used across all packages
+ */
+
+/**
+ * Default ports
+ */
+export const DEFAULT_CORE_PORT = 8765;
+export const DEFAULT_WS_PORT = 8766;
+export const DEFAULT_LOGS_PORT = 8767;
+
+/**
+ * Network configuration
+ */
+export const WS_HEARTBEAT_INTERVAL = 30000; // 30 seconds
+export const WS_RECONNECT_DELAY = 5000; // 5 seconds
+export const WS_MAX_RECONNECT_ATTEMPTS = 5;
+export const REQUEST_TIMEOUT = 30000; // 30 seconds
+
+/**
+ * Session configuration
+ */
+export const SESSION_TOKEN_EXPIRY = 3600000; // 1 hour
+export const SESSION_CLEANUP_INTERVAL = 60000; // 1 minute
+export const SESSION_IDLE_TIMEOUT = 1800000; // 30 minutes
+
+/**
+ * Build configuration
+ */
+export const BUILD_CACHE_SIZE_LIMIT = 1073741824; // 1 GB
+export const BUILD_TIMEOUT = 300000; // 5 minutes
+export const MAX_CONCURRENT_BUILDS = 3;
+
+/**
+ * File size limits
+ */
+export const MAX_APK_SIZE = 104857600; // 100 MB
+export const MAX_LOG_FILE_SIZE = 10485760; // 10 MB
+export const MAX_LOG_ENTRIES = 10000;
+
+/**
+ * Version information
+ */
+export const JETSTART_VERSION = '0.1.0';
+export const MIN_ANDROID_API_LEVEL = 24; // Android 7.0
+export const TARGET_ANDROID_API_LEVEL = 34; // Android 14
+
+/**
+ * URLs and paths
+ */
+export const JETSTART_CONFIG_FILE = 'jetstart.config.json';
+export const JETSTART_CACHE_DIR = '.jetstart/cache';
+export const JETSTART_SESSIONS_DIR = '.jetstart/sessions';
+export const JETSTART_LOGS_DIR = '.jetstart/logs';
+
+/**
+ * Error codes
+ */
+export const ERROR_CODES = {
+  // CLI errors (1xxx)
+  INVALID_COMMAND: 1001,
+  INVALID_PROJECT_NAME: 1002,
+  PROJECT_ALREADY_EXISTS: 1003,
+  PROJECT_NOT_FOUND: 1004,
+
+  // Core errors (2xxx)
+  SERVER_START_FAILED: 2001,
+  BUILD_FAILED: 2002,
+  SESSION_CREATION_FAILED: 2003,
+  INVALID_SESSION: 2004,
+
+  // Client errors (3xxx)
+  CONNECTION_FAILED: 3001,
+  DOWNLOAD_FAILED: 3002,
+  INSTALLATION_FAILED: 3003,
+  LAUNCH_FAILED: 3004,
+
+  // Network errors (4xxx)
+  WEBSOCKET_ERROR: 4001,
+  NETWORK_TIMEOUT: 4002,
+  AUTHENTICATION_FAILED: 4003,
+
+  // Build errors (5xxx)
+  COMPILATION_ERROR: 5001,
+  PACKAGING_ERROR: 5002,
+  SIGNING_ERROR: 5003,
+} as const;
+
+/**
+ * Success messages
+ */
+export const SUCCESS_MESSAGES = {
+  PROJECT_CREATED: 'Project created successfully',
+  BUILD_COMPLETE: 'Build completed successfully',
+  CONNECTION_ESTABLISHED: 'Connection established',
+  APK_INSTALLED: 'APK installed successfully',
+} as const;
+
+/**
+ * Log tags
+ */
+export const LOG_TAGS = {
+  CLI: 'jetstart:cli',
+  CORE: 'jetstart:core',
+  CLIENT: 'jetstart:client',
+  BUILD: 'jetstart:build',
+  NETWORK: 'jetstart:network',
+  WEBSOCKET: 'jetstart:ws',
+  LOGS: 'jetstart:logs',
+} as const;
+
+/**
+ * File patterns
+ */
+export const IGNORE_PATTERNS = [
+  'node_modules',
+  '.git',
+  '.gradle',
+  'build',
+  'dist',
+  '.idea',
+  '*.iml',
+  '.DS_Store',
+  'local.properties',
+];
+
+/**
+ * MIME types
+ */
+export const MIME_TYPES = {
+  APK: 'application/vnd.android.package-archive',
+  JSON: 'application/json',
+  TEXT: 'text/plain',
+} as const;

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+// Re-export all utilities
+export * from './validation';
+export * from './constants';