@ebowwa/ios-devices 1.0.0

package/src/types.ts

@@ -0,0 +1,315 @@
+/**
+ * @ebowwa/ios-devices - Type definitions
+ * iOS device control types for devicectl, libimobiledevice, and simctl
+ */
+
+import { z } from 'zod';
+
+// ============================================================================
+// Device Types
+// ============================================================================
+
+export const IOSDeviceSchema = z.object({
+  identifier: z.string(), // UDID
+  name: z.string(),
+  model: z.string(),
+  modelCode: z.string(),
+  productType: z.string(),
+  osVersion: z.string(),
+  osBuildVersion: z.string(),
+  architecture: z.string(),
+  platform: z.enum(['iOS', 'iPadOS', 'tvOS', 'watchOS', 'visionOS']),
+  connectionType: z.enum(['USB', 'Network', 'Wireless']),
+  isTrusted: z.boolean(),
+  isAvailable: z.boolean(),
+});
+
+export type IOSDevice = z.infer<typeof IOSDeviceSchema>;
+
+export const DeviceDetailsSchema = z.object({
+  udid: z.string(),
+  name: z.string(),
+  model: z.string(),
+  productType: z.string(),
+  productVersion: z.string(),
+  buildVersion: z.string(),
+  serialNumber: z.string().optional(),
+  cpuArchitecture: z.string(),
+  deviceName: z.string(),
+  timeZone: z.string().optional(),
+  locale: z.string().optional(),
+  totalDiskSpace: z.number().optional(),
+  freeDiskSpace: z.number().optional(),
+  batteryLevel: z.number().optional(),
+  batteryState: z.enum(['unplugged', 'charging', 'full']).optional(),
+});
+
+export type DeviceDetails = z.infer<typeof DeviceDetailsSchema>;
+
+// ============================================================================
+// Process Types
+// ============================================================================
+
+export const ProcessInfoSchema = z.object({
+  pid: z.number(),
+  name: z.string(),
+  user: z.string().optional(),
+  cpuPercent: z.number().optional(),
+  memoryMB: z.number().optional(),
+  startTime: z.number().optional(),
+  bundleIdentifier: z.string().optional(),
+});
+
+export type ProcessInfo = z.infer<typeof ProcessInfoSchema>;
+
+export const ProcessSignalSchema = z.enum([
+  'SIGTERM',
+  'SIGKILL',
+  'SIGHUP',
+  'SIGINT',
+  'SIGSTOP',
+  'SIGCONT',
+  'SIGUSR1',
+  'SIGUSR2',
+]);
+
+export type ProcessSignal = z.infer<typeof ProcessSignalSchema>;
+
+// ============================================================================
+// App Types
+// ============================================================================
+
+export const InstalledAppSchema = z.object({
+  bundleIdentifier: z.string(),
+  bundleName: z.string(),
+  bundleVersion: z.string(),
+  shortVersion: z.string().optional(),
+  installPath: z.string(),
+  dataContainerPath: z.string().optional(),
+  executableName: z.string().optional(),
+  platform: z.enum(['iOS', 'iPadOS', 'tvOS', 'watchOS', 'visionOS', 'macOS']),
+  type: z.enum(['User', 'System', 'Internal']),
+});
+
+export type InstalledApp = z.infer<typeof InstalledAppSchema>;
+
+export const AppInstallResultSchema = z.object({
+  success: z.boolean(),
+  bundleIdentifier: z.string().optional(),
+  error: z.string().optional(),
+});
+
+export type AppInstallResult = z.infer<typeof AppInstallResultSchema>;
+
+// ============================================================================
+// Logging Types
+// ============================================================================
+
+export const LogEntrySchema = z.object({
+  timestamp: z.string(),
+  process: z.string(),
+  pid: z.number().optional(),
+  level: z.enum(['debug', 'info', 'notice', 'warning', 'error', 'fault']).optional(),
+  message: z.string(),
+  subsystem: z.string().optional(),
+  category: z.string().optional(),
+});
+
+export type LogEntry = z.infer<typeof LogEntrySchema>;
+
+export const LogFilterSchema = z.object({
+  match: z.string().optional(),
+  unmatch: z.string().optional(),
+  process: z.string().optional(),
+  exclude: z.string().optional(),
+  kernel: z.boolean().optional(),
+  trigger: z.string().optional(),
+  untrigger: z.string().optional(),
+});
+
+export type LogFilter = z.infer<typeof LogFilterSchema>;
+
+// ============================================================================
+// File System Types
+// ============================================================================
+
+export const FileInfoSchema = z.object({
+  path: z.string(),
+  name: z.string(),
+  isDirectory: z.boolean(),
+  size: z.number().optional(),
+  modifiedTime: z.number().optional(),
+  createdTime: z.number().optional(),
+  permissions: z.string().optional(),
+});
+
+export type FileInfo = z.infer<typeof FileInfoSchema>;
+
+export const FileCopyOptionsSchema = z.object({
+  source: z.string(),
+  destination: z.string(),
+  overwrite: z.boolean().optional().default(false),
+});
+
+export type FileCopyOptions = z.infer<typeof FileCopyOptionsSchema>;
+
+// ============================================================================
+// Diagnostics Types
+// ============================================================================
+
+export const DiagnosticsTypeSchema = z.enum([
+  'All',
+  'WiFi',
+  'GasGauge',
+  'NAND',
+  'Battery',
+  'HDMI',
+]);
+
+export type DiagnosticsType = z.infer<typeof DiagnosticsTypeSchema>;
+
+export interface IOKitEntry {
+  name: string;
+  path: string;
+  properties?: Record<string, unknown>;
+  children?: IOKitEntry[];
+}
+
+export const IOKitEntrySchema: z.ZodType<IOKitEntry> = z.object({
+  name: z.string(),
+  path: z.string(),
+  properties: z.record(z.unknown()).optional(),
+  children: z.array(z.lazy(() => IOKitEntrySchema)).optional(),
+});
+
+// ============================================================================
+// Backup Types
+// ============================================================================
+
+export const BackupInfoSchema = z.object({
+  snapshotId: z.string(),
+  deviceName: z.string(),
+  deviceType: z.string(),
+  iOSVersion: z.string(),
+  buildVersion: z.string(),
+  date: z.string(),
+  size: z.number().optional(),
+  isEncrypted: z.boolean().optional(),
+});
+
+export type BackupInfo = z.infer<typeof BackupInfoSchema>;
+
+// ============================================================================
+// Simulator Types
+// ============================================================================
+
+export const SimulatorDeviceSchema = z.object({
+  udid: z.string(),
+  name: z.string(),
+  state: z.enum(['Shutdown', 'Booted', 'Shutting Down']),
+  runtime: z.string(),
+  deviceType: z.string(),
+  availability: z.enum(['available', 'unavailable']),
+});
+
+export type SimulatorDevice = z.infer<typeof SimulatorDeviceSchema>;
+
+export const SimulatorRuntimeSchema = z.object({
+  identifier: z.string(),
+  name: z.string(),
+  version: z.string(),
+  buildVersion: z.string(),
+  isAvailable: z.boolean(),
+  platform: z.string(),
+});
+
+export type SimulatorRuntime = z.infer<typeof SimulatorRuntimeSchema>;
+
+export const SimulatorDeviceTypeSchema = z.object({
+  identifier: z.string(),
+  name: z.string(),
+  productFamily: z.string(),
+  minRuntimeVersion: z.string().optional(),
+  maxRuntimeVersion: z.string().optional(),
+});
+
+export type SimulatorDeviceType = z.infer<typeof SimulatorDeviceTypeSchema>;
+
+// ============================================================================
+// Display Types
+// ============================================================================
+
+export const DisplayInfoSchema = z.object({
+  id: z.number(),
+  width: z.number(),
+  height: z.number(),
+  scale: z.number(),
+  refreshRate: z.number().optional(),
+  colorSpace: z.string().optional(),
+});
+
+export type DisplayInfo = z.infer<typeof DisplayInfoSchema>;
+
+// ============================================================================
+// Location Types
+// ============================================================================
+
+export const LocationSchema = z.object({
+  latitude: z.number(),
+  longitude: z.number(),
+  altitude: z.number().optional(),
+  horizontalAccuracy: z.number().optional(),
+});
+
+export type Location = z.infer<typeof LocationSchema>;
+
+// ============================================================================
+// Provisioning Profile Types
+// ============================================================================
+
+export const ProvisioningProfileSchema = z.object({
+  uuid: z.string(),
+  name: z.string(),
+  teamName: z.string(),
+  teamIdentifier: z.string(),
+  platform: z.string(),
+  expirationDate: z.string(),
+  creationDate: z.string(),
+  appIds: z.array(z.string()),
+});
+
+export type ProvisioningProfile = z.infer<typeof ProvisioningProfileSchema>;
+
+// ============================================================================
+// Command Execution Types
+// ============================================================================
+
+export const CommandResultSchema = z.object({
+  success: z.boolean(),
+  stdout: z.string(),
+  stderr: z.string(),
+  exitCode: z.number(),
+  json: z.unknown().optional(),
+});
+
+export type CommandResult = z.infer<typeof CommandResultSchema>;
+
+export const DeviceIdentifierSchema = z.union([
+  z.string(), // UDID, name, or ECID
+  z.object({ udid: z.string() }),
+  z.object({ name: z.string() }),
+  z.object({ ecid: z.string() }),
+]);
+
+export type DeviceIdentifier = z.infer<typeof DeviceIdentifierSchema>;
+
+// ============================================================================
+// Notification Types
+// ============================================================================
+
+export const DarwinNotificationSchema = z.object({
+  name: z.string(),
+  userInfo: z.record(z.unknown()).optional(),
+});
+
+export type DarwinNotification = z.infer<typeof DarwinNotificationSchema>;