Function handleSettingsCommand

src/core/dispatch.ts:508–581

(
  device: DeviceInfo,
  interactor: Interactor,
  positionals: string[],
  context: DispatchContext | undefined,
)

}

async function handleSettingsCommand(
  device: DeviceInfo,
  interactor: Interactor,
  positionals: string[],
  context: DispatchContext | undefined,
): Promise<Record<string, unknown>> {
  const [setting, state, target, mode] = positionals;
  if (!setting || (!state && setting !== 'clear-app-state')) {
    throw new AppError('INVALID_ARGS', 'settings requires setting state');
  }
  if (setting === 'clear-app-state') {
    const appBundleId = (state === 'clear' ? target : state) ?? context?.appBundleId;
    if (!appBundleId) {
      throw new AppError(
        'INVALID_ARGS',
        'settings clear-app-state requires an app id or an active app session.',
      );
    }
    emitDiagnostic({
      level: 'debug',
      phase: 'settings_apply',
      data: { setting, state: 'clear', appBundleId, platform: device.platform },
    });
    const result = await interactor.setSetting(setting, 'clear', appBundleId);
    return result && typeof result === 'object'
      ? withSuccessText(
          { setting, state: 'clear', ...result },
          readResultMessage(result) ?? `Cleared user data for ${appBundleId}`,
        )
      : { setting, state: 'clear', ...successText(`Cleared user data for ${appBundleId}`) };
  }
  if (!state) {
    throw new AppError('INVALID_ARGS', 'settings requires setting state');
  }
  const isLocationSet = setting === 'location' && state === 'set';
  const usesPayloadAppBundleSlot = setting === 'permission' || isLocationSet;
  const appBundleId =
    (usesPayloadAppBundleSlot ? positionals[4] : positionals[2]) ?? context?.appBundleId;
  const settingOptions =
    setting === 'permission'
      ? {
          permissionTarget: target,
          permissionMode: mode,
        }
      : isLocationSet
        ? {
            latitude: readLocationCoordinate(target, 'latitude'),
            longitude: readLocationCoordinate(mode, 'longitude'),
          }
        : undefined;
  const diagnosticPayload = isLocationSet
    ? { setting, state, latitude: target, longitude: mode, platform: device.platform }
    : setting === 'permission'
      ? {
          setting,
          state,
          permissionTarget: target,
          permissionMode: mode,