cc-control-shared 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types/index.js";
+export * from "./types/user.js";
+export * from "./protocols/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// ============================================================================
+// CC-Control Shared Package
+// ============================================================================
+// Export all types
+export * from "./types/index.js";
+export * from "./types/user.js";
+// Export all protocol definitions
+export * from "./protocols/index.js";
+// Export all utilities
+export * from "./utils/index.js";

package/dist/protocols/index.d.ts

@@ -0,0 +1,131 @@
+import type { Session, LogEntry } from "../types/index.js";
+export interface MessageEnvelope<T extends MessageType = MessageType> {
+    version: "1.0";
+    type: T;
+    id: string;
+    timestamp: string;
+    deviceId: string;
+    payload: MessagePayloadTypeMap[T];
+}
+export type MessageType = "auth:register" | "auth:pair" | "auth:success" | "auth:error" | "state:session_update" | "state:session_list" | "state:task_progress" | "state:task_completion" | "logs:stream" | "command:send_prompt" | "command:switch_session" | "command:manage_task" | "command:file_operation" | "response:command_result" | "response:error" | "connection:status";
+export interface MessagePayloadTypeMap {
+    "auth:register": AuthRegisterPayload;
+    "auth:pair": AuthPairPayload;
+    "auth:success": AuthSuccessPayload;
+    "auth:error": AuthErrorPayload;
+    "state:session_update": StateSessionUpdatePayload;
+    "state:session_list": StateSessionListPayload;
+    "state:task_progress": StateTaskProgressPayload;
+    "state:task_completion": StateTaskCompletionPayload;
+    "logs:stream": LogsStreamPayload;
+    "command:send_prompt": CommandSendPromptPayload;
+    "command:switch_session": CommandSwitchSessionPayload;
+    "command:manage_task": CommandManageTaskPayload;
+    "command:file_operation": CommandFileOperationPayload;
+    "response:command_result": ResponseCommandResultPayload;
+    "response:error": ResponseErrorPayload;
+    "connection:status": ConnectionStatusPayload;
+}
+export interface AuthRegisterPayload {
+    deviceName: string;
+    deviceType: "desktop" | "mobile";
+    capabilities: {
+        version: string;
+        features: string[];
+    };
+}
+export interface AuthPairPayload {
+    pairingCode: string;
+    deviceToken?: string;
+}
+export interface AuthSuccessPayload {
+    deviceId: string;
+    token: string;
+    expiresAt: number;
+}
+export interface AuthErrorPayload {
+    error: string;
+    code: string;
+}
+export interface StateSessionUpdatePayload {
+    session: Session;
+}
+export interface StateSessionListPayload {
+    sessions: Session[];
+    lastUpdate: string;
+}
+export interface StateTaskProgressPayload {
+    sessionId: string;
+    taskId: string;
+    status: "in_progress" | "blocked" | "completed" | "failed";
+    progress: number;
+    currentStep?: string;
+    startedAt: string;
+    eta?: string;
+}
+export interface StateTaskCompletionPayload {
+    sessionId: string;
+    taskId: string;
+    status: "completed" | "failed" | "cancelled";
+    result?: {
+        summary: string;
+        filesModified: number;
+        commandsRun: number;
+        duration: number;
+    };
+    error?: {
+        code: string;
+        message: string;
+        stack?: string;
+    };
+    completedAt: string;
+}
+export interface LogsStreamPayload {
+    sessionId: string;
+    logs: LogEntry[];
+    isChunk?: boolean;
+    chunkIndex?: number;
+    totalChunks?: number;
+}
+export interface CommandSendPromptPayload {
+    sessionId: string;
+    commandId: string;
+    prompt: string;
+    context?: {
+        workingDirectory?: string;
+        files?: string[];
+    };
+}
+export interface CommandSwitchSessionPayload {
+    targetSessionId: string;
+}
+export interface CommandManageTaskPayload {
+    taskId: string;
+    action: "cancel" | "pause" | "resume";
+}
+export interface CommandFileOperationPayload {
+    operation: "read" | "write" | "delete" | "list";
+    path: string;
+    content?: string;
+}
+export interface ResponseCommandResultPayload {
+    commandId: string;
+    status: "success" | "error" | "pending";
+    result?: unknown;
+    timestamp: string;
+}
+export interface ResponseErrorPayload {
+    commandId?: string;
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+    timestamp: string;
+}
+export interface ConnectionStatusPayload {
+    status: "connected" | "disconnected" | "reconnecting";
+    reason?: string;
+}
+export declare function createMessage<T extends MessageType>(type: T, payload: MessagePayloadTypeMap[T], deviceId: string): MessageEnvelope<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/protocols/index.d.ts.map

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

package/dist/protocols/index.js

@@ -0,0 +1,16 @@
+// ============================================================================
+// WebSocket Message Protocol Definitions
+// ============================================================================
+// ----------------------------------------------------------------------------
+// Message Builder Helpers
+// ----------------------------------------------------------------------------
+export function createMessage(type, payload, deviceId) {
+    return {
+        version: "1.0",
+        type,
+        id: crypto.randomUUID(),
+        timestamp: new Date().toISOString(),
+        deviceId,
+        payload: payload,
+    };
+}

package/dist/types/index.d.ts

@@ -0,0 +1,164 @@
+export type SessionStatus = "initializing" | "idle" | "processing" | "waiting_input" | "error" | "terminated";
+export interface Session {
+    id: string;
+    deviceId: string;
+    status: SessionStatus;
+    currentTask?: Task;
+    messages: Message[];
+    filesAccessed: string[];
+    lastActivity: Date;
+    createdAt: Date;
+    metadata: SessionMetadata;
+}
+export interface SessionMetadata {
+    workingDirectory: string;
+    claudeVersion: string;
+    project?: string;
+    customTitle?: string;
+    summary?: string;
+    firstPrompt?: string;
+    messageCount?: number;
+}
+export type TaskStatus = "pending" | "in_progress" | "blocked" | "completed" | "failed" | "cancelled";
+export interface Task {
+    id: string;
+    sessionId: string;
+    type: TaskType;
+    status: TaskStatus;
+    progress: number;
+    subject: string;
+    description?: string;
+    startedAt: Date;
+    completedAt?: Date;
+    error?: TaskError;
+    metadata?: Record<string, unknown>;
+}
+export type TaskType = "prompt" | "tool_execution" | "file_operation";
+export interface TaskError {
+    code: string;
+    message: string;
+    recoverable: boolean;
+}
+export interface Message {
+    id: string;
+    sessionId: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    timestamp: Date;
+    toolCalls?: ToolCall[];
+    metadata?: {
+        model?: string;
+        gitBranch?: string;
+        cwd?: string;
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+        };
+    };
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    result?: unknown;
+    status: "pending" | "approved" | "rejected" | "completed";
+}
+export type DeviceType = "desktop" | "mobile";
+export type DeviceStatus = "online" | "offline";
+export interface Device {
+    id: string;
+    name: string;
+    type: DeviceType;
+    status: DeviceStatus;
+    lastSeen: Date;
+    pairedDevices: string[];
+    capabilities: DeviceCapabilities;
+}
+export interface DeviceCapabilities {
+    version: string;
+    features: string[];
+}
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export type LogSource = "claude_code" | "system" | "agent";
+export interface LogEntry {
+    id: string;
+    sessionId: string;
+    source: LogSource;
+    level: LogLevel;
+    timestamp: Date;
+    message: string;
+    metadata?: Record<string, unknown>;
+}
+export type ConnectionStatus = "connected" | "disconnected" | "connecting" | "reconnecting";
+export interface ConnectionState {
+    status: ConnectionStatus;
+    lastConnected?: Date;
+    lastDisconnected?: Date;
+    reconnectAttempts?: number;
+}
+export type CommandType = "send_prompt" | "switch_session" | "manage_task" | "file_operation";
+export interface Command {
+    id: string;
+    type: CommandType;
+    sessionId: string;
+    payload: CommandPayload;
+    timestamp: Date;
+}
+export type CommandPayload = SendPromptPayload | SwitchSessionPayload | ManageTaskPayload | FileOperationPayload;
+export interface SendPromptPayload {
+    prompt: string;
+    context?: {
+        workingDirectory?: string;
+        files?: string[];
+    };
+}
+export interface SwitchSessionPayload {
+    targetSessionId: string;
+}
+export interface ManageTaskPayload {
+    taskId: string;
+    action: "cancel" | "pause" | "resume";
+}
+export type FileOperationType = "read" | "write" | "delete" | "list";
+export interface FileOperationPayload {
+    operation: FileOperationType;
+    path: string;
+    content?: string;
+}
+export type ResponseStatus = "success" | "error" | "pending";
+export interface CommandResponse {
+    commandId: string;
+    status: ResponseStatus;
+    result?: unknown;
+    error?: ResponseError;
+    timestamp: Date;
+}
+export interface ResponseError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface AuthTokens {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: Date;
+}
+export interface PairingInfo {
+    pairingCode: string;
+    desktopId: string;
+    desktopName: string;
+    qrData: string;
+    expiresAt: Date;
+}
+export type Permission = "read:sessions" | "read:logs" | "send:prompts" | "manage:tasks" | "read:files" | "write:files";
+export interface AccessTokenPayload {
+    sub: string;
+    type: "access";
+    device_type: DeviceType;
+    paired_device: string;
+    permissions: Permission[];
+    iat: number;
+    exp: number;
+    jti: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,4 @@
+// ============================================================================
+// Core Type Definitions for CC-Control
+// ============================================================================
+export {};

package/dist/types/user.d.ts

@@ -0,0 +1,42 @@
+export interface User {
+    id: string;
+    email: string;
+    emailVerified: boolean;
+    subscriptionTier: "free" | "pro" | "enterprise";
+    createdAt: Date;
+    updatedAt: Date;
+    lastLoginAt?: Date;
+}
+export interface CreateUserInput {
+    email: string;
+    password: string;
+}
+export interface LoginInput {
+    email: string;
+    password: string;
+}
+export interface UserSession {
+    user: User;
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: Date;
+}
+export interface UserTokenPayload {
+    sub: string;
+    type: "access" | "refresh";
+    email: string;
+    tier: "free" | "pro" | "enterprise";
+    iat: number;
+    exp: number;
+    jti: string;
+}
+export interface DeviceTokenPayload {
+    sub: string;
+    type: "device";
+    userId: string;
+    deviceType: "desktop" | "mobile";
+    iat: number;
+    exp: number;
+    jti: string;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/types/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IAChD,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types/user.js

@@ -0,0 +1,4 @@
+// ============================================================================
+// User & Auth Types for CC-Control SaaS
+// ============================================================================
+export {};

package/dist/utils/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Format a date for display
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Format a duration in milliseconds to human-readable
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format bytes to human-readable
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Generate a pairing code (XXX-XXX-XXX format)
+ */
+export declare function generatePairingCode(): string;
+/**
+ * Validate a pairing code format
+ */
+export declare function isValidPairingCode(code: string): boolean;
+/**
+ * Deep clone an object
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Debounce a function
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle a function
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(func: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry a function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffMultiplier?: number;
+}): Promise<T>;
+/**
+ * Parse a user's home directory path
+ */
+export declare function resolveHomePath(path: string): string;
+/**
+ * Check if a path is within allowed directories
+ */
+export declare function isPathAllowed(path: string, allowed: string[], denied: string[]): boolean;
+/**
+ * Extract device ID from JWT token
+ */
+export declare function extractDeviceId(token: string): string | null;
+/**
+ * Check if a JWT token is expired
+ */
+export declare function isTokenExpired(token: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAe7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAa5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACvB,GACL,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAsBT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQrD"}

package/dist/utils/index.js

@@ -0,0 +1,187 @@
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Format a date for display
+ */
+export function formatDate(date) {
+    const now = new Date();
+    const diff = now.getTime() - date.getTime();
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (seconds < 60)
+        return "just now";
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    if (hours < 24)
+        return `${hours}h ago`;
+    if (days < 7)
+        return `${days}d ago`;
+    return date.toLocaleDateString();
+}
+/**
+ * Format a duration in milliseconds to human-readable
+ */
+export function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (minutes < 60)
+        return `${minutes}m ${seconds % 60}s`;
+    return `${hours}h ${minutes % 60}m`;
+}
+/**
+ * Format bytes to human-readable
+ */
+export function formatBytes(bytes) {
+    const units = ["B", "KB", "MB", "GB"];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(1)} ${units[unitIndex]}`;
+}
+/**
+ * Generate a pairing code (XXX-XXX-XXX format)
+ */
+export function generatePairingCode() {
+    const chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"; // No ambiguous chars
+    const segments = [];
+    for (let i = 0; i < 3; i++) {
+        let segment = "";
+        for (let j = 0; j < 3; j++) {
+            segment += chars[Math.floor(Math.random() * chars.length)];
+        }
+        segments.push(segment);
+    }
+    return segments.join("-");
+}
+/**
+ * Validate a pairing code format
+ */
+export function isValidPairingCode(code) {
+    return /^[A-Z0-9]{3}-[A-Z0-9]{3}-[A-Z0-9]{3}$/.test(code);
+}
+/**
+ * Deep clone an object
+ */
+export function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+/**
+ * Debounce a function
+ */
+export function debounce(func, wait) {
+    let timeout = null;
+    return function executedFunction(...args) {
+        const later = () => {
+            timeout = null;
+            func(...args);
+        };
+        if (timeout)
+            clearTimeout(timeout);
+        timeout = setTimeout(later, wait);
+    };
+}
+/**
+ * Throttle a function
+ */
+export function throttle(func, limit) {
+    let inThrottle;
+    return function executedFunction(...args) {
+        if (!inThrottle) {
+            func(...args);
+            inThrottle = true;
+            setTimeout(() => (inThrottle = false), limit);
+        }
+    };
+}
+/**
+ * Sleep for a specified duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff
+ */
+export async function retry(fn, options = {}) {
+    const { maxAttempts = 3, initialDelay = 1000, maxDelay = 10000, backoffMultiplier = 2, } = options;
+    let lastError;
+    let delay = initialDelay;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxAttempts) {
+                throw lastError;
+            }
+            await sleep(delay);
+            delay = Math.min(delay * backoffMultiplier, maxDelay);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Parse a user's home directory path
+ */
+export function resolveHomePath(path) {
+    if (path.startsWith("~")) {
+        return path.replace("~", process.env.HOME || process.env.USERPROFILE || "");
+    }
+    return path;
+}
+/**
+ * Check if a path is within allowed directories
+ */
+export function isPathAllowed(path, allowed, denied) {
+    const resolved = resolveHomePath(path);
+    // Check if path is in allowed list
+    const isAllowed = allowed.some((dir) => resolved.startsWith(resolveHomePath(dir)));
+    if (!isAllowed)
+        return false;
+    // Check if path matches denied patterns
+    const isDenied = denied.some((pattern) => {
+        // Simple glob pattern matching
+        const regex = new RegExp("^" +
+            pattern
+                .replace(/\*/g, ".*")
+                .replace(/\?/g, ".") +
+            "$");
+        return regex.test(resolved);
+    });
+    return !isDenied;
+}
+/**
+ * Extract device ID from JWT token
+ */
+export function extractDeviceId(token) {
+    try {
+        const payload = JSON.parse(atob(token.split(".")[1]));
+        return payload.sub || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a JWT token is expired
+ */
+export function isTokenExpired(token) {
+    try {
+        const payload = JSON.parse(atob(token.split(".")[1]));
+        const now = Math.floor(Date.now() / 1000);
+        return payload.exp < now;
+    }
+    catch {
+        return true;
+    }
+}

package/dist/utils.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit Tests for Shared Package Utilities
+ */
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/utils.test.d.ts.map

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

package/dist/utils.test.js

@@ -0,0 +1,290 @@
+/**
+ * Unit Tests for Shared Package Utilities
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { formatDate, formatDuration, formatBytes, generatePairingCode, isValidPairingCode, deepClone, debounce, throttle, sleep, retry, resolveHomePath, isPathAllowed, extractDeviceId, isTokenExpired, } from './index.js';
+describe('formatDate', () => {
+    it('should format dates as "just now" for recent dates', () => {
+        const now = new Date();
+        const date = new Date(now.getTime() - 30 * 1000);
+        expect(formatDate(date)).toBe('just now');
+    });
+    it('should format dates as "Xm ago" for minutes', () => {
+        const now = new Date();
+        const date = new Date(now.getTime() - 30 * 60 * 1000);
+        expect(formatDate(date)).toBe('30m ago');
+    });
+    it('should format dates as "Xh ago" for hours', () => {
+        const now = new Date();
+        const date = new Date(now.getTime() - 5 * 60 * 60 * 1000);
+        expect(formatDate(date)).toBe('5h ago');
+    });
+    it('should format dates as "Xd ago" for days', () => {
+        const now = new Date();
+        const date = new Date(now.getTime() - 3 * 24 * 60 * 60 * 1000);
+        expect(formatDate(date)).toBe('3d ago');
+    });
+    it('should format older dates as locale date string', () => {
+        const date = new Date('2020-01-01');
+        const formatted = formatDate(date);
+        expect(formatted).toBe(date.toLocaleDateString());
+    });
+});
+describe('formatDuration', () => {
+    it('should format seconds', () => {
+        expect(formatDuration(5000)).toBe('5s');
+        expect(formatDuration(59000)).toBe('59s');
+    });
+    it('should format minutes and seconds', () => {
+        expect(formatDuration(60000)).toBe('1m 0s');
+        expect(formatDuration(125000)).toBe('2m 5s');
+    });
+    it('should format hours and minutes', () => {
+        expect(formatDuration(3600000)).toBe('1h 0m');
+        expect(formatDuration(3665000)).toBe('1h 1m');
+        expect(formatDuration(7265000)).toBe('2h 1m');
+    });
+});
+describe('formatBytes', () => {
+    it('should format bytes', () => {
+        expect(formatBytes(0)).toBe('0.0 B');
+        expect(formatBytes(512)).toBe('512.0 B');
+        expect(formatBytes(1023)).toBe('1023.0 B');
+    });
+    it('should format kilobytes', () => {
+        expect(formatBytes(1024)).toBe('1.0 KB');
+        expect(formatBytes(1536)).toBe('1.5 KB');
+        expect(formatBytes(10240)).toBe('10.0 KB');
+    });
+    it('should format megabytes', () => {
+        expect(formatBytes(1048576)).toBe('1.0 MB');
+        expect(formatBytes(5242880)).toBe('5.0 MB');
+    });
+    it('should format gigabytes', () => {
+        expect(formatBytes(1073741824)).toBe('1.0 GB');
+        expect(formatBytes(2147483648)).toBe('2.0 GB');
+    });
+});
+describe('generatePairingCode', () => {
+    it('should generate valid pairing code format', () => {
+        const code = generatePairingCode();
+        expect(code).toMatch(/^[A-Z0-9]{3}-[A-Z0-9]{3}-[A-Z0-9]{3}$/);
+    });
+    it('should generate unique codes', () => {
+        const codes = new Set();
+        for (let i = 0; i < 100; i++) {
+            codes.add(generatePairingCode());
+        }
+        expect(codes.size).toBe(100);
+    });
+    it('should not contain ambiguous characters', () => {
+        const code = generatePairingCode();
+        expect(code).not.toMatch(/[IO01]/);
+    });
+});
+describe('isValidPairingCode', () => {
+    it('should validate correct pairing codes', () => {
+        expect(isValidPairingCode('ABC-123-DEF')).toBe(true);
+        expect(isValidPairingCode('XYZ-987-ABC')).toBe(true);
+    });
+    it('should reject incorrect formats', () => {
+        expect(isValidPairingCode('abc-123-def')).toBe(false); // lowercase
+        expect(isValidPairingCode('ABC123DEF')).toBe(false); // no dashes
+        expect(isValidPairingCode('AB-123-DEF')).toBe(false); // too short
+        expect(isValidPairingCode('ABC-123-DEF-456')).toBe(false); // too long
+        expect(isValidPairingCode('')).toBe(false); // empty
+        expect(isValidPairingCode('ABC-1I3-DEF')).toBe(true); // valid format
+    });
+});
+describe('deepClone', () => {
+    it('should clone objects', () => {
+        const obj = { a: 1, b: 2 };
+        const cloned = deepClone(obj);
+        expect(cloned).toEqual(obj);
+        expect(cloned).not.toBe(obj);
+    });
+    it('should clone nested objects', () => {
+        const obj = { a: { b: { c: 1 } } };
+        const cloned = deepClone(obj);
+        expect(cloned).toEqual(obj);
+        expect(cloned.a).not.toBe(obj.a);
+    });
+    it('should clone arrays', () => {
+        const arr = [1, 2, 3];
+        const cloned = deepClone(arr);
+        expect(cloned).toEqual(arr);
+        expect(cloned).not.toBe(arr);
+    });
+    it('should clone objects with arrays', () => {
+        const obj = { arr: [1, 2, 3] };
+        const cloned = deepClone(obj);
+        expect(cloned).toEqual(obj);
+        expect(cloned.arr).not.toBe(obj.arr);
+    });
+});
+describe('debounce', () => {
+    it('should debounce function calls', () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const debouncedFn = debounce(fn, 100);
+        debouncedFn();
+        debouncedFn();
+        debouncedFn();
+        expect(fn).not.toHaveBeenCalled();
+        vi.advanceTimersByTime(100);
+        expect(fn).toHaveBeenCalledTimes(1);
+        vi.useRealTimers();
+    });
+    it('should call function with latest arguments', () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const debouncedFn = debounce(fn, 100);
+        debouncedFn(1);
+        debouncedFn(2);
+        debouncedFn(3);
+        vi.advanceTimersByTime(100);
+        expect(fn).toHaveBeenCalledWith(3);
+        expect(fn).toHaveBeenCalledTimes(1);
+        vi.useRealTimers();
+    });
+});
+describe('throttle', () => {
+    it('should throttle function calls', () => {
+        vi.useFakeTimers();
+        const fn = vi.fn();
+        const throttledFn = throttle(fn, 100);
+        throttledFn();
+        throttledFn();
+        throttledFn();
+        expect(fn).toHaveBeenCalledTimes(1);
+        vi.advanceTimersByTime(100);
+        throttledFn();
+        expect(fn).toHaveBeenCalledTimes(2);
+        vi.useRealTimers();
+    });
+});
+describe('sleep', () => {
+    it('should sleep for specified duration', async () => {
+        vi.useFakeTimers();
+        const start = Date.now();
+        const promise = sleep(100);
+        vi.advanceTimersByTime(100);
+        await promise;
+        vi.useRealTimers();
+    });
+});
+describe('retry', () => {
+    it('should succeed on first try', async () => {
+        const fn = vi.fn().mockResolvedValue('success');
+        const result = await retry(fn);
+        expect(result).toBe('success');
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('should retry on failure', async () => {
+        const fn = vi.fn()
+            .mockRejectedValueOnce(new Error('fail'))
+            .mockResolvedValue('success');
+        const result = await retry(fn, { maxAttempts: 3, initialDelay: 10 });
+        expect(result).toBe('success');
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it('should throw after max attempts', async () => {
+        const fn = vi.fn().mockRejectedValue(new Error('fail'));
+        await expect(retry(fn, { maxAttempts: 2, initialDelay: 10 })).rejects.toThrow('fail');
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it('should use exponential backoff', async () => {
+        vi.useFakeTimers();
+        const fn = vi.fn()
+            .mockRejectedValueOnce(new Error('fail'))
+            .mockRejectedValueOnce(new Error('fail'))
+            .mockResolvedValue('success');
+        const promise = retry(fn, {
+            maxAttempts: 3,
+            initialDelay: 100,
+            backoffMultiplier: 2,
+        });
+        // First attempt fails
+        await vi.advanceTimersByTimeAsync(100);
+        // Second attempt fails
+        await vi.advanceTimersByTimeAsync(200);
+        await promise;
+        expect(fn).toHaveBeenCalledTimes(3);
+        vi.useRealTimers();
+    });
+});
+describe('resolveHomePath', () => {
+    it('should replace ~ with HOME env var', () => {
+        const originalHome = process.env.HOME;
+        process.env.HOME = '/Users/test';
+        expect(resolveHomePath('~/Documents')).toBe('/Users/test/Documents');
+        expect(resolveHomePath('~/')).toBe('/Users/test/');
+        process.env.HOME = originalHome;
+    });
+    it('should not replace ~ in middle of path', () => {
+        expect(resolveHomePath('/path/~test')).toBe('/path/~test');
+    });
+    it('should return unchanged path if no ~', () => {
+        expect(resolveHomePath('/absolute/path')).toBe('/absolute/path');
+    });
+});
+describe('isPathAllowed', () => {
+    it('should check allowed paths', () => {
+        expect(isPathAllowed('/Users/test/project', ['/Users/test'], []))
+            .toBe(true);
+        expect(isPathAllowed('/Users/test/project', ['/Users/other'], []))
+            .toBe(false);
+    });
+    it('should check denied patterns', () => {
+        // Denied patterns match the entire path
+        expect(isPathAllowed('/Users/test/project/node_modules', ['/Users/test'], ['*/node_modules']))
+            .toBe(false);
+        expect(isPathAllowed('/Users/test/project/src', ['/Users/test'], ['*/node_modules']))
+            .toBe(true);
+    });
+    it('should support glob patterns', () => {
+        // Test with simpler glob patterns
+        expect(isPathAllowed('/Users/test/.env', ['/Users/test'], ['*/.env']))
+            .toBe(false);
+        expect(isPathAllowed('/Users/test/src', ['/Users/test'], ['*/.env']))
+            .toBe(true);
+    });
+});
+describe('extractDeviceId', () => {
+    it('should extract device ID from valid JWT', () => {
+        // Create a mock JWT token
+        const header = btoa(JSON.stringify({ alg: 'HS256', typ: 'JWT' }));
+        const payload = btoa(JSON.stringify({ sub: 'device-123', exp: Date.now() / 1000 + 3600 }));
+        const signature = 'signature';
+        const token = `${header}.${payload}.${signature}`;
+        expect(extractDeviceId(token)).toBe('device-123');
+    });
+    it('should return null for invalid JWT', () => {
+        expect(extractDeviceId('invalid')).toBeNull();
+        expect(extractDeviceId('not.a.jwt')).toBeNull();
+    });
+    it('should return null if no sub in payload', () => {
+        const header = btoa(JSON.stringify({ alg: 'HS256' }));
+        const payload = btoa(JSON.stringify({ exp: 123 }));
+        const token = `${header}.${payload}.signature`;
+        expect(extractDeviceId(token)).toBeNull();
+    });
+});
+describe('isTokenExpired', () => {
+    it('should return false for valid token', () => {
+        const header = btoa(JSON.stringify({ alg: 'HS256' }));
+        const payload = btoa(JSON.stringify({ exp: Math.floor(Date.now() / 1000) + 3600 }));
+        const token = `${header}.${payload}.signature`;
+        expect(isTokenExpired(token)).toBe(false);
+    });
+    it('should return true for expired token', () => {
+        const header = btoa(JSON.stringify({ alg: 'HS256' }));
+        const payload = btoa(JSON.stringify({ exp: Math.floor(Date.now() / 1000) - 3600 }));
+        const token = `${header}.${payload}.signature`;
+        expect(isTokenExpired(token)).toBe(true);
+    });
+    it('should return true for invalid token', () => {
+        expect(isTokenExpired('invalid')).toBe(true);
+        expect(isTokenExpired('not.a.jwt')).toBe(true);
+    });
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "cc-control-shared",
+  "version": "1.0.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    },
+    "./protocols": {
+      "types": "./dist/protocols/index.d.ts",
+      "import": "./dist/protocols/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.6.0"
+  }
+}